Reading the repo
Opening the box…
Reading the repo
Opening the box…
Assembly instructions
Watched.earth - see every public satellite image of earth
GitHub didn't answer, so this is the saved copy from 17 h ago
Will it work on macOS?
Heads-upBuilding it yourself? It also needs 4 settings in .env (1 secret).
CONTRIBUTING.mdThanks for your interest. Issues and pull requests are welcome.
You need Node 22.12+, 24 or 26+ (the versions Vitest supports).
npm install
npm run dev
The app runs fully without a backend: lookups, shares and stats switch off when the Supabase variables are unset.
To work on those, see docs/SELF-HOSTING.md.
Run all three checks and make sure they pass:
npx tsc -b
npx vitest run
npx vitest run --config scripts/backend-vitest.config.ts
Two timing-based tests can time out on a heavily loaded machine and pass when run alone: "Flock (32 km swath): no
missed passes over 7 days" in src/engine/passes.test.ts, and "R-M1: looks for the cover while the passes are
computed, so the first report already carries it" in src/engine/report.test.ts.
docs/ARCHITECTURE.md describes the contracts between modules; docs/DESIGN.md describes the visual design..env* files (other than .env.example), or personal email addresses. Admins are set
per deployment with scripts/backend-set-admin.sh, not in migrations.scripts/backend-*.sh scripts against a database you don't own.By contributing, you agree your contribution is licensed under the project's MIT license.
Please don't file those as issues. See SECURITY.md.
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/dev-Armaan/satellites.git cd satellites
Node.js 22
# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm) nvm install 22
Fill in secrets: VITE_SUPABASE_PUBLISHABLE_KEY
cp .env.example .env
npm ci
npm run dev
npm test
Node 22.12+, 24 or 26+.
git clone https://github.com/dev-Armaan/satellites.git
cd satellites
npm install
npm run dev
That's the whole app at http://localhost:5173, with no configuration. Lookups and short share links need a Supabase
project: copy .env.example to .env.local and set VITE_SUPABASE_URL and VITE_SUPABASE_PUBLISHABLE_KEY (the
publishable key, never a secret one: VITE_ variables ship to every browser).
npm test # engine, imagery and UI (Vitest)
npm run test:backend # the server functions and the Worker
npm run typecheck
npm run build # the app and /admin, into dist/
npm run dev:worker # after a build: the Cloudflare Worker, locally
npm run data:celestrak # refresh the orbit catalog (CelesTrak asks for 2 h between downloads)
| URL | |
|:--|:--|
| /?q=lat,lon&n=name | Open a place. Add &p=<pass id> for a pass, or &tl=1 for its time-lapse. |
| /?debug=gl | WebGL diagnostics. |
| /?sandbox=<name> | Development pages: engine, backend, globe, imagery, results, shell. |
| /admin.html?mock=1 | The stats page with fixture data. |
No reports for macOS yet.
GitManual AI Agent reads the 5 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.