NomadonaTrip/alaba

A content distribution platform that subverts the current renting philosophy around content consumption. You get to own. # Alaba Nigerian Nollywood film distribution platform. Viewers license films at ₦500, downloadable for offline playback. Producers receive 70% of each license, paid weekly. - **Product brief:** `consolidated-brief.md` - **Engineering spec (current slice):** `docs/superpowers/specs/2026-05-20-mvp-vertical-slice-design.md` - **Implementation plans:** `docs/superpowers/plans/` ## Quickstart (dev) Prerequisites: Docker Desktop or Docker Engine ≥ 24, Docker Compose v2, `uv` for any local Python work, Node.js 20 + npm, Android Studio (Hedgehog or later) for the mobile client. ### 1. First-time setup ```bash git clone alaba && cd alaba cp infra/.env.example infra/.env # adjust if needed ``` ### 2. Bring up the stack ```bash make up make migrate ``` Verify: ```bash curl localhost # → {"status":"ok","service":"alaba-backend","checks":{"database":"ok"}} ``` Visit the landing page at . ### 3. Run the Android app Open `android/` in Android Studio. When sync completes, start an emulator (API 34+ recommended) and click **Run 'app'**. The app calls `/health` on startup and shows the JSON. To find the backend URL for a real device on your LAN: ```bash make android-url ``` ### Common commands | Command | What it does | |---|---| | `make up` | Start the full stack | | `make down` | Stop containers (volumes preserved) | | `make logs` | Tail all logs | | `make psql` | Open a psql shell against the dev DB | | `make migrate` | Apply pending Alembic migrations | | `make migration msg="..."` | Generate a new migration from model changes | | `make backend-shell` | Bash inside backend-api | | `make test` | Run backend pytest suite | | `make android-url` | Print backend URLs for Android emulator + real device | | `make reset-db` | Drop + recreate + remigrate the dev DB | | `make clean` | Stop + DELETE all volumes (destroys data) | ### Service URLs (dev) | Service | URL | |---|---| | Backend API | | | Backend docs (Swagger) | | | Web portals (Next. …