Status: This directory is named mobile for historical reasons, but the
package is actually a Progressive Web App built with Vite
- React + ReactDOM. The audit (#62) called this out as misleading. Closes #62.
What this actually is#
- A Vite-bundled web app:
pnpm devrunsvite,pnpm buildrunstsc && vite build(produces a static bundle),pnpm previewserves the static bundle locally. - Dependencies pull in
react-dom(web-only) and the@nyx/*workspace ephemeris / orbital / positional / realtime-satellites libraries. - The app targets PWA-friendly form factors (phone-sized viewports) but uses
browser APIs (matchMedia for orientation, fullscreen API for the planetarium
view, the standard
navigator.geolocationfor observer location) — not React Native.
Why it lives under apps/nyx/mobile#
The Nyx project started with a single web shell that was designed mobile-first.
The path was kept after a hypothetical "native nyx app" was discussed but never
started. There is no ios/ or android/ directory in this package because the
package is not a native target.
Recommended rename (deferred)#
A correctness fix is to rename apps/nyx/mobile → apps/nyx/pwa or
apps/nyx/web. That touches:
- This package's directory
pnpm-workspace.yaml's glob (already covered byapps/*/**but any explicit entries should be updated)- Any
@nyx/mobileimport sites (search confirms there are zero — the package is consumed only as a hosted artifact, not imported) .github/workflows/references (none currently)- Vercel/Netlify project mappings (handled out of band)
The rename is mechanically simple but cross-cuts deploy config, so it's deferred to a coordinated PR rather than this doc-only fix. Until then, this file documents the discrepancy so a new contributor opening the directory doesn't expect React Native.
What this is NOT#
- Not React Native
- Not a Capacitor / Cordova wrapper
- Not a Tauri or Electron desktop shell
- Not connected to apps/aphrodite/mobile-broadcaster or other bare-RN apps in the monorepo