Watch And Earn docs
 v4.0.0
Live demoConsole demo Get help
● Start · About 10 minutes

Quick start
the app in your browser.

Run the app with no accounts at all, then run the whole system on your computer against the Firebase emulators.

01Web demo, no accounts

You need only Flutter (see Requirements). Demo mode uses simulated, labelled ads and an in-memory backend: nothing is sent anywhere and progress resets when you reload.

cd app
flutter pub get
flutter run -d chrome --dart-define=DEMO_MODE=true   # simulated ads, in-memory server, labelled demo cash (no real money)

Chrome opens with the onboarding screen. Sign in as a guest, watch a simulated video, claim the daily streak, spin the wheel and play a mini-game on the Play tab. Check-in, season, the mystery box and the store work in the demo too. Their sample content is labelled "Sample", the visitor starts at 0 points, and the leaderboard, teams and event standings show labelled sample players whose names start with "Sample"; they are not real users. Partner offers and sponsor links in the demo open no external site: they show a "Demo only" sheet instead.

The cash wallet in the demo. The demo switches the wallet on with labelled demo cash, "Demo — no real money". Only a simulated offerwall or survey completion on the Earn tab credits it, as pending cash; the Wallet tab has a demo button to end the hold at once, and you can walk through a payout request. Demo requests stay pending and never leave the device. Ads, games and streaks never touch the wallet, in the demo as in production (the hard rule).

Demo mode is not a product

The web build exists only as a demo. The real app targets Android and iOS; the ad SDKs and store purchases do not run on the web.

02Everything locally, on the Firebase emulators

This runs the real backend, the real console and the real app on your computer with a Firebase "demo-" project, so no cloud project is needed. You need Node.js 22, the Firebase CLI and Java 21 or newer.

  1. Build the Functions and start the emulatorsIn the first terminal: 
    cd firebase/functions
npm ci
npm run build
cd ..
firebase emulators:start --project demo-watchandearn   # auth 9099, firestore 8080, functions 5001
  2. Start the operator consoleIn a second terminal: 
    cd admin
npm ci
FIRESTORE_EMULATOR_HOST=localhost:8080 ADMIN_SECRET_KEY=$(openssl rand -hex 32) npm start   # http://localhost:8790/admin
    The log prints a one-time setup code. Open http://localhost:8790/admin, choose Create the owner, enter the code, your e-mail and a password of 12 or more characters. On start the console writes the app settings (config/public) into the emulator.
  3. Run the app against the emulatorsIn a third terminal: 
    cd app
flutter run --dart-define=USE_EMULATOR=true
    On an Android emulator the app reaches your computer at 10.0.2.2 automatically. For a real phone on your network add --dart-define=EMULATOR_HOST=<your-computer-ip> (app/lib/core/env.dart).
How videos are credited in the emulator

No real ad network can call your computer, so in the emulator the function devCompleteAdSession stands in for the ad network callback and the whole earn flow works. In production the same function always answers permission-denied.

03Run the tests

cd app && flutter analyze && flutter test
cd firebase/functions && npm test && npm run test:emu && npm run test:rules
cd admin && npm test && npm run test:emulator

Run each line from the package folder. test:emu, test:rules and test:emulator start the emulators themselves, so they need the Firebase CLI and Java. At release all suites pass, including the tests that keep points and cash apart.

04Next

Next
Installation
The full path to your own project.
Then
Firebase setup
Your own cloud project.