# @nyx/mobile — NOT a native mobile app

**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.

## 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 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
