Name: android-app
Author: ZACK770

Prompt file imported from ZACK770/studytoy (.windsurf/workflows/android-app.md). Copyright stays with the author.

Android App Workflow (Capacitor)

Prerequisites

Android Studio installed (https://developer.android.com/studio)
Java 17+ (comes with Android Studio)
USB Debugging enabled on your Android device (or use emulator)

Daily Workflow — Update App After Code Changes

Every time you change frontend code and want to update the Android app:

cd frontend
npm run android:sync

This single command does:

tsc — type check
vite build — builds to dist/
cap sync android — copies dist/ into the Android project + updates plugins

Then open in Android Studio:

npm run android:open

Or run directly on a connected device:

npm run android:run

First Time Setup (Already Done)

These steps are already completed:

npm install @capacitor/core @capacitor/cli @capacitor/android @capacitor/camera @capacitor/filesystem
Created capacitor.config.ts with appId app.learnplay.android
npx cap add android — generated android/ folder
Added camera permissions to AndroidManifest.xml
npx cap sync android — synced web assets

Building APK / AAB for Google Play

Open Android Studio: npm run android:open
In Android Studio: Build → Generate Signed Bundle / APK
Choose Android App Bundle (AAB) for Play Store upload
Create a keystore (first time only) — KEEP THIS SAFE, you need it for every update
Build the release AAB
Upload to Google Play Console (https://play.google.com/console)

Publishing to Google Play

Create a Google Play Developer account ($25 one-time fee): https://play.google.com/console/signup
Create a new app in the console
Fill in: app name, description, screenshots, icon, privacy policy
Upload the AAB from step above
Submit for review (takes 1-7 days first time, then hours for updates)

App Icon & Splash Screen

Replace icon files in android/app/src/main/res/mipmap-*/
For splash screen, use @capacitor/splash-screen plugin

Key Files

frontend/capacitor.config.ts — Capacitor configuration
frontend/android/ — Full Android project (open with Android Studio)
frontend/android/app/src/main/AndroidManifest.xml — Android permissions
frontend/src/utils/capacitor.ts — Native camera/gallery utilities
frontend/src/components/NativeFilePicker.tsx — Reusable native file picker component

Important Notes

The android/ folder IS part of the repo (it contains custom permissions & config)
Never manually edit files inside android/app/src/main/assets/ — those are auto-generated by cap sync
Backend URL: The app points to your production backend. For local dev, edit capacitor.config.ts → server.url

Install android-app and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# Android App Workflow (Capacitor) ## Prerequisites - **Android Studio** installed (https://developer.android.com/studio) - **Java 17+** (comes with Android Studio) - USB Debugging enabled on your Android device (or use emulator) ## Daily Workflow — Update App After Code Changes Every time you change frontend code and want to update the Android app: ```bash cd frontend npm run android:sync ``` This single command does: 1. `tsc` — type check 2. `vite build` — builds to `dist/` 3. `cap sync android` — copies `dist/` into the Android project + updates plugins Then open in Android Studio: ```bash npm run android:open ``` Or run directly on a connected device: ```bash npm run android:run ``` ## First Time Setup (Already Done) These steps are already completed: 1. `npm install @capacitor/core @capacitor/cli @capacitor/android @capacitor/camera @capacitor/filesystem` 2. Created `capacitor.config.ts` with appId `app.learnplay.android` 3. `npx cap add android` — generated `android/` folder 4. Added camera permissions to `AndroidManifest.xml` 5. `npx cap sync android` — synced web assets ## Building APK / AAB for Google Play 1. Open Android Studio: `npm run android:open` 2. In Android Studio: **Build → Generate Signed Bundle / APK** 3. Choose **Android App Bundle (AAB)** for Play Store upload 4. Create a keystore (first time only) — **KEEP THIS SAFE, you need it for every update** 5. Build the release AAB 6. Upload to Google Play Console (https://play.google.com/console) ## Publishing to Google Play 1. Create a Google Play Developer account ($25 one-time fee): https://play.google.com/console/signup 2. Create a new app in the console 3. Fill in: app name, description, screenshots, icon, privacy policy 4. Upload the AAB from step above 5. Submit for review (takes 1-7 days first time, then hours for updates) ## App Icon & Splash Screen - Replace icon files in `android/app/src/main/res/mipmap-*/` - For splash screen, use `@capacitor/splash-screen` plugin ## Key Files - `frontend/capacitor.config.ts` — Capacitor configuration - `frontend/android/` — Full Android project (open with Android Studio) - `frontend/android/app/src/main/AndroidManifest.xml` — Android permissions - `frontend/src/utils/capacitor.ts` — Native camera/gallery utilities - `frontend/src/components/NativeFilePicker.tsx` — Reusable native file picker component ## Important Notes - The `android/` folder IS part of the repo (it contains custom permissions & config) - **Never manually edit** files inside `android/app/src/main/assets/` — those are auto-generated by `cap sync` - Backend URL: The app points to your production backend. For local dev, edit `capacitor.config.ts` → `server.url`

{ "prompt": "# Android App Workflow (Capacitor)\n\n## Prerequisites\n- **Android Studio** installed (https://developer.android.com/studio)\n- **Java 17+** (comes with Android Studio)\n- USB Debugging enabled on your Android device (or use emulator)\n\n## Daily Workflow — Update App After Code Changes\n\nEvery time you change frontend code and want to update the Android app:\n\n```bash\ncd frontend\nnpm run android:sync\n```\n\nThis single command does:\n1. `tsc` — type check\n2. `vite build` — builds to `dist/`\n3. `cap sync android` — copies `dist/` into the Android project + updates plugins\n\nThen open in Android Studio:\n\n```bash\nnpm run android:open\n```\n\nOr run directly on a connected device:\n\n```bash\nnpm run android:run\n```\n\n## First Time Setup (Already Done)\n\nThese steps are already completed:\n\n1. `npm install @capacitor/core @capacitor/cli @capacitor/android @capacitor/camera @capacitor/filesystem`\n2. Created `capacitor.config.ts` with appId `app.learnplay.android`\n3. `npx cap add android` — generated `android/` folder\n4. Added camera permissions to `AndroidManifest.xml`\n5. `npx cap sync android` — synced web assets\n\n## Building APK / AAB for Google Play\n\n1. Open Android Studio: `npm run android:open`\n2. In Android Studio: **Build → Generate Signed Bundle / APK**\n3. Choose **Android App Bundle (AAB)** for Play Store upload\n4. Create a keystore (first time only) — **KEEP THIS SAFE, you need it for every update**\n5. Build the release AAB\n6. Upload to Google Play Console (https://play.google.com/console)\n\n## Publishing to Google Play\n\n1. Create a Google Play Developer account ($25 one-time fee): https://play.google.com/console/signup\n2. Create a new app in the console\n3. Fill in: app name, description, screenshots, icon, privacy policy\n4. Upload the AAB from step above\n5. Submit for review (takes 1-7 days first time, then hours for updates)\n\n## App Icon & Splash Screen\n\n- Replace icon files in `android/app/src/main/res/mipmap-*/`\n- For splash screen, use `@capacitor/splash-screen` plugin\n\n## Key Files\n\n- `frontend/capacitor.config.ts` — Capacitor configuration\n- `frontend/android/` — Full Android project (open with Android Studio)\n- `frontend/android/app/src/main/AndroidManifest.xml` — Android permissions\n- `frontend/src/utils/capacitor.ts` — Native camera/gallery utilities\n- `frontend/src/components/NativeFilePicker.tsx` — Reusable native file picker component\n\n## Important Notes\n\n- The `android/` folder IS part of the repo (it contains custom permissions & config)\n- **Never manually edit** files inside `android/app/src/main/assets/` — those are auto-generated by `cap sync`\n- Backend URL: The app points to your production backend. For local dev, edit `capacitor.config.ts` → `server.url`", "variables": [], "notes": "How to build, update and deploy the Android app via Capacitor", "metadata": { "source": { "provider": "github-windsurf-workflows", "repository": "https://github.com/ZACK770/studytoy", "path": ".windsurf/workflows/android-app.md", "ref": "6538a2ea150de22f9b415cfeba93d1ec81e96a4d", "url": "https://github.com/ZACK770/studytoy/blob/6538a2ea150de22f9b415cfeba93d1ec81e96a4d/.windsurf/workflows/android-app.md", "key": "ZACK770/studytoy/.windsurf/workflows/android-app.md" } } }

android-app

About