Eve library

@nyx/mobile — NOT a native mobile app

Other

Revision 1

On this page

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 dev runs vite, pnpm build runs tsc && vite build (produces a static bundle), pnpm preview serves 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.geolocation for 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.

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 by apps/*/** but any explicit entries should be updated)
  • Any @nyx/mobile import 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