Run & Deploy

Run the tool locally

The tool is a single self-contained HTML file with no dependencies.

# from the repo root
open delivery-package/orbit-survivability/public/tool.html      # macOS
start delivery-package\orbit-survivability\public\tool.html     # Windows

It runs entirely in the browser — all physics is computed client-side in JavaScript. No build step, server, or network access is required.

Verify the model

node delivery-package/orbit-survivability/verify.mjs

This checks the canonical model (orbit-model.mjs) against known LEO decay behaviour and writes:

• verification-report.json — machine-readable results (consumed by the publisher for the verification %).
• verification-report.md — human-readable summary.
• evidence/verification-results.json — evidence copy.

Exit code is non-zero if any check fails.

Publish (GitHub Pages)

The outcome is published as part of the site under its own URL:

node scripts/publish-deliverables.mjs

This renders the docs, copies the live public/tool.html, builds the download bundle, writes metadata.json, and regenerates the portfolio at published/index.html. Pushing to main triggers .github/workflows/deploy-pages.yml, which deploys published/ to GitHub Pages automatically.

• Portfolio: https://<owner>.github.io/<repo>/
• This outcome: https://<owner>.github.io/<repo>/orbit-survivability/
• Live tool: https://<owner>.github.io/<repo>/orbit-survivability/tool.html

Project files