• v0.0.2-alpha 7299f6a642

    zaph0d released this 2026-02-26 18:26:25 +01:00 | 25 commits to main since this release

    📅 Originally published on GitHub: Thu, 26 Feb 2026 17:28:19 GMT
    🏷️ Git tag created: Thu, 26 Feb 2026 17:26:25 GMT

    It builds. It runs. First production deployment

    This release marks the first confirmed working production deployment at pwa.macjuu.com.

    What's working

    • Full Docker Compose stack builds cleanly end-to-end
    • Frontend (Nginx + React SPA) and backend (Express + Android SDK) both start healthy
    • APK generation pipeline confirmed operational
    • All 83 tests passing (46 backend · 37 frontend)

    Changes since v0.0.1-alpha

    Bug fixes

    • @bubblewrap/core APILog does not exist in v1.24.1; replaced with ConsoleLog (zero-arg constructor). Updated Vitest mock to match.
    • TypeScript type errorParameters<typeof TwaManifest> failed because TwaManifest has an overloaded constructor; replaced with as any cast.
    • Docker frontend buildManifestDefaults was imported but unused in BuildForm.tsx; removed to satisfy noUnusedLocals: true.

    Deployment

    • HOST_PORT env var (default 8088) controls which host port the frontend container binds to — avoids conflicts on homelab servers where ports 80 and 8080–8086 are typically occupied.
    • docker-compose.yml now uses ${HOST_PORT:-8088}:80 instead of the hardcoded 80:80.

    Known limitations (alpha)

    • No built-in authentication — protect at reverse proxy level (basic auth, IP allowlist, OAuth2 proxy)
    • Each APK build generates a fresh signing key; upgrading an installed app requires uninstalling first
    • Single-instance only (in-memory build store, no persistence across restarts)

    Install

    git clone https://github.com/niels-emmer/pwa-maker-android.git
    cd pwa-maker-android
    cp .env.example .env          # edit HOST_PORT if 8088 is taken
    docker-compose up -d --build  # first build: ~20 min; subsequent: fast
    
    Downloads