A two-screen SceneryStack port of the NAAP Solar System Models lab: Ptolemaic System and Planetary Configurations. Built with Vite 8, TypeScript 7, and Biome 2.
- Two screens with complete models and wired views (not scaffolding)
- English, French, and Spanish localization via
StringManager - Default and projector color profiles
- Progressive Web App (installable, offline-capable)
- Model-layer Vitest coverage
- Flash decompile workflow (
npm run decompile) for NAAP.swfreference - Git hooks for Biome pre-commit checks
- Shared GitHub Actions CI via
OpenPhysics/Baton
Upstream Flash / AIR / React NAAP sources live in the sibling
Baseline repo under Astronomy/
(see baselines.json). Clone Baseline with the fleet bootstrap, then:
(cd ../Baseline && ./scripts/fetch-baselines.sh)npm run decompile reads .swf files from
../Baseline/Astronomy/flash-animations and writes ActionScript into the
sim-local gitignored NAAP/decompiled/ (requires Java; one-time
npm run decompile -- --setup).
npm install
npm run icons # generate PNG icons from public/icons/icon.svg
npm start # dev server → http://localhost:5173| Command | Description |
|---|---|
npm start / npm run dev | Start Vite dev server |
npm run build | Type-check + production build → dist/ |
npm run build:single | Single self-contained dist/index.html |
npm run preview | Preview the production build locally |
npm run check | TypeScript type check |
npm run lint | Biome lint check |
npm run format | Auto-format all files |
npm run fix | Lint + auto-fix |
npm test | Run Vitest unit tests |
npm run icons | Regenerate PNG icons from public/icons/icon.svg |
npm run decompile | Extract ActionScript from NAAP Flash .swf sources |
npm run clean | Remove dist/ |
Quality gate: npm run check && npm run lint && npm run build && npm test.
Keep name in kebab-case in package.json; it is separate from the SceneryStack sim identifier in src/init.ts.
| Tool | Version | Purpose |
|---|---|---|
| SceneryStack | ^3.0.0 | Simulation framework |
| Vite | ^8 | Build tool + dev server |
| TypeScript | ^7 | Type-safe JavaScript |
| Biome | ^2.5 | Linting + formatting |
| Vitest | ^4 | Unit tests |
| vite-plugin-pwa | ^1 | PWA + service worker |
GNU Affero General Public License v3.0 — see OpenPhysics org license.
See OpenPhysics contributing guidelines. Report bugs via GitHub Issues; use org issue templates.