# Nern App

Nern is packaged as an installable Progressive Web App, so you can distribute it without Apple App Store, Google Play, or an Apple Developer account.

Best distribution path:

1. Upload this folder to any HTTPS static host.
2. Share the public URL.
3. Users open the URL and install it from their browser.

Good hosts for this kind of app:

- Netlify Drop
- Vercel static deployment
- Cloudflare Pages
- GitHub Pages
- Firebase Hosting
- Any normal HTTPS web server

Local testing:

```powershell
& "C:\Users\pasumarthy\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe" -m http.server 4173 --directory outputs\nudge-crm-app
```

Then open `http://localhost:4173`.

Install behavior:

- iPhone and iPad: open the HTTPS URL in Safari, tap Share, then Add to Home Screen.
- Android: open the HTTPS URL in Chrome, then tap Install app or Add to Home screen.
- Windows and macOS: open the HTTPS URL in Chrome or Edge, then use the install icon in the address bar or the in-app Install button.
- Data is stored on-device with `localStorage`; the service worker caches the app shell for offline use after first load.
- Shared team workspaces are available on the official hosted Nern site. They use signed-in identity and hosted database storage; a separately self-hosted static copy continues to work in device-local mode unless it is connected to the collaboration API.
- Device-local accounts have no password complexity or length rule, but passwords cannot be blank. New accounts receive a one-time recovery code; store it safely because only its salted hash is kept and the original code cannot be displayed again.

Important platform note:

- iPhone users cannot install an unsigned native `.ipa` like a normal app without Apple developer tooling, enterprise management, or jailbreaking. A PWA is the clean no-store route.
- Android users can sideload APKs, but this project is currently a PWA. Wrapping it as an APK is optional and not required for browser install.

Start with `DEPLOY_NOW.md` for the quickest public URL path.

See `NO_APP_STORE_DISTRIBUTION.md` for the full no-store distribution checklist.
