Home Server

Server

APK_SERVER_URL=http://192.168.0.103:5000

No auth token is currently set — omit the Authorization header.

---

Web App Deployment

When asked to "deploy" or "serve" a web app (React, Vue, static site, etc.):

Steps

1. Build the app (if it has a build step):
   • Run npm run build (or yarn build, pnpm build)
   • The output is typically in dist/ or build/

   No build tool? (plain HTML/CSS/JS) — skip this step and zip the source files directly.

   The server automatically injects a <base> tag so asset paths work under /apps/<name>/. No need to configure base in vite or homepage in package.json.

2. Zip the build output:

   python3 -c "import shutil; shutil.make_archive('app', 'zip', 'dist')"

   On Windows without Python: powershell -c "Compress-Archive -Path 'dist/*' -DestinationPath app.zip"

   On Linux/macOS with zip: cd dist && zip -r ../app.zip . && cd ..

   The zip must contain index.html at the root (or in a single subdirectory).

3. Upload:

   curl -F "file=@app.zip" \
        -F "app=<appname>" \
        -F "notes=<short description>" \
        "${APK_SERVER_URL}/api/webapps/upload"

4. Report the result:
   • Print the app URL: ${APK_SERVER_URL}/apps/<appname>/
   • Print the dashboard: ${APK_SERVER_URL}

Rules

• App names: lowercase with hyphens (e.g. weather, budget-tracker) — the name becomes the URL path
• Uploading the same app name overwrites the previous deployment
• SPA routing is handled automatically (all non-file paths serve index.html)

---

APK Build & Serve

When asked to "build and serve the APK":

Steps

1. Build the APK:
   • Android/Gradle: ./gradlew assembleDebug
   • Flutter: flutter build apk --debug
   • React Native: cd android && ./gradlew assembleDebug
   • Always build debug — automatically signed with the debug keystore
   • The APK is typically at app/build/outputs/apk/debug/app-debug.apk
2. Upload:

   curl -F "file=@<path-to-apk>" \
        -F "app=<AppName>" \
        -F "version=<version>" \
        -F "notes=<short description of what changed>" \
        "${APK_SERVER_URL}/api/upload"

3. Report the result:
   • Print the download URL: ${APK_SERVER_URL}/apks/<AppName>/<version>/<filename>.apk
   • Print the dashboard: ${APK_SERVER_URL}

Rules

• App names: PascalCase matching the project (e.g. MarketAnalyst, BudgetTracker)
• Filename: use the default from the build (e.g. app-debug.apk)
• Use semver (MAJOR.MINOR.PATCH) — read version from the project's build config
• Check existing versions: curl -s ${APK_SERVER_URL}/api/apps | python3 -m json.tool
• If the version exists, bump the patch and update the build config
• Always build debug
• Include meaningful notes
• Incremental builds: After the first full build, skip --clean on expo prebuild and just re-run ./gradlew assembleDebug. Gradle does incremental compilation — first build may take ~8 min, subsequent builds with code changes should be under 2 min.