Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on Windows
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 Windows?
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 powershell -ExecutionPolicy Bypass -File .\setup.ps1. 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: winget install Git.Git
git clone https://github.com/dev-Armaan/satellites.git cd satellites
Node.js 22
winget install CoreyButler.NVMforWindows nvm install 22 nvm use 22
Fill in secrets: VITE_SUPABASE_PUBLISHABLE_KEY
Copy-Item .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 Windows yet.
GitManual AI Agent reads the 5 key files and writes a step-by-step guide for Windows. Once written, it's saved for everyone.