Ship Android app by wrapping CRA build with Capacitor (#20)

Add Capacitor 7 scaffolding (config, android/, npm scripts, .env.mobile),
native back-button/safe-area chrome, icons/splash, and signing docs so
llm-fe ships one codebase to web and Android.
This commit is contained in:
2026-07-26 19:12:19 -05:00
parent b7f23eb16c
commit 0d90269c53
93 changed files with 5408 additions and 9 deletions
+26 -5
View File
@@ -12,8 +12,8 @@ document root; the shared **web-static** nginx container from
[server-infra](https://git.aimloperations.com/ai_ml_operations/server-infra) serves
those assets. Same pattern as `dta_webapp`.
Android Capacitor shell (display name **Hesychia**) lands via the Capacitor wrap
PR; branding strings there use Hesychia once that tree is on `master`.
Android ships the same CRA `build/` via **Capacitor** (display name **Hesychia**;
see `llm-fe/ANDROID.md`).
## Domain migration
@@ -43,11 +43,16 @@ deploy webroots / NPM) when DNS and `server-infra` cut over to hesychia.ai.
chat_web_app/
├── README.md
├── .gitea/workflows/ # Unit tests + deploy-prod / deploy-beta
└── llm-fe/ # CRA npm root (+ Capacitor when Android wrap merges)
└── llm-fe/ # CRA + Capacitor npm root
├── package.json
├── capacitor.config.ts
├── ANDROID.md # Android build, signing, Play Store notes
├── android/ # Native Android project (committed)
├── assets/ # Source icon/splash for @capacitor/assets
├── .env.development # Local dev API/WS URLs
├── .env.beta
├── .env.production
├── .env.mobile # Capacitor shell API/WS URLs
├── public/
└── src/
├── axiosApi.js # Axios instances (JWT Authorization)
@@ -67,7 +72,7 @@ chat_web_app/
- **npm** (lockfile: `llm-fe/package-lock.json`)
- Running [chat_backend](https://git.aimloperations.com/ai_ml_operations/chat_backend)
locally for full chat/auth (default in `.env.development`: port **8001**)
- For Android (after Capacitor wrap merges): JDK 17+, Android Studio / SDK
- For Android: JDK 17+, Android Studio / SDK (see `llm-fe/ANDROID.md`)
## Local setup
@@ -89,6 +94,8 @@ to be visible in the browser bundle.
| `.env.development` | `npm start` | `http://127.0.0.1:8001` |
| `.env.production` | `npm run build` / `build:prod` | `https://chatbackend.aimloperations.com` |
| `.env.beta` | `npm run build:beta` | `https://beta.chatbackend.aimloperations.com` |
| `.env.mobile` | `npm run build:mobile` | prod by default (override for beta shell) |
Required keys (already set in the committed env files):
```env
@@ -101,7 +108,7 @@ this frontend (unlike Django apps under `~/Documents/secrets/`). Change the
committed `.env.*` files if API domains change, then redeploy.
Optional local overrides (gitignored): `.env.local`, `.env.development.local`,
`.env.production.local`.
`.env.production.local`, `.env.mobile.local`.
### 3. Start the backend
@@ -122,6 +129,16 @@ npm start
Open **http://localhost:3000**.
### 5. Android (Capacitor)
```bash
cd llm-fe
npm run build:mobile
npm run android:open
```
Full signing / Play Store notes: [`llm-fe/ANDROID.md`](llm-fe/ANDROID.md).
## npm scripts
| Command | Purpose |
@@ -130,6 +147,10 @@ Open **http://localhost:3000**.
| `npm run build` | Production build into `llm-fe/build/` |
| `npm run build:prod` | Prod build + copy to `/var/www/prod.chat.aimloperations/html` |
| `npm run build:beta` | Beta env build + copy to `/var/www/beta.chat.aimloperations/html` |
| `npm run build:mobile` | Mobile env build + `cap sync android` |
| `npm run android:open` | Open `android/` in Android Studio |
| `npm run android:sync` | `cap sync android` only |
| `npm run assets:generate` | Regenerate Android icons/splash from `assets/` |
| `npm test` | Jest watch mode |
| `npm run test:ci` | Single CI run (`CI=true`, no watch) |