johnbekele/abro

abro (አብሮ) — intercity carpooling for Ethiopia. Share the ride, share the cost. # abro (አብሮ) **Intercity carpooling for Ethiopia.** Share the ride, share the cost. `abro` means "together" in Amharic. Drivers already making a long trip — Addis Ababa to Bahir Dar, Adama, Hawassa, Dire Dawa — publish their empty seats. Passengers travelling the same corridor book one. The passenger pays a small deposit online and the balance in cash at pickup. The platform takes a service fee and nothing else. This is a cost-sharing marketplace, not a transport company. We never dispatch a driver, never set a fare above the cost-sharing cap, and never own a vehicle. That distinction is load-bearing — see ADR 0006. --- ## Status: pre-code The repository is set up and the backlog is fully specified. **No application code exists yet.** Every directory below is created by its own issue. If you are picking this up, start here: 1. `docs/PRODUCT_CONTEXT.md` — what we are building and the business rules behind it. 2. `docs/ARCHITECTURE.md` — the intended shape of the system. 3. `docs/adr/` — the decisions that are already made, and why. Do not relitigate these in a pull request; open an issue instead. 4. The open issues labelled `ready` — pick one, and read it fully before starting. Work through the `M0 Foundations` milestone first. It builds the scaffolding everything else depends on. ## Planned layout | Directory | What it will be | Created by | |---|---|---| | `abro-api/` | FastAPI backend. Python 3.12, SQLAlchemy 2, Alembic, PostgreSQL + PostGIS, Redis, ARQ. | `M0` | | `abro-web/` | Next.js 15 App Router. Passenger web, admin CRM, SEO route-pair pages. | `M0` | | `abro-mobile/` | Expo SDK 54. The primary client — Ethiopia is ~96% Android. | `M0` | | `abro-routing/` | Self-hosted Valhalla, Photon, and the PMTiles pipeline over an OSM Ethiopia extract. | `M1` | | `abro-infra/` | Pulumi (Python) on AWS. Staging and production stacks. | `M0` | | `packages/` | Shared TypeScript: generated API client, `@abro/time`, i18n catalogs. | `M0` | | `docs/` | Product cont …