# Meenda

> Meenda is an all-in-one urban mobility, corridor ride-pooling, intercity coach ticketing, and concierge food delivery progressive web app for Southern Africa.

Meenda delivers sub-second, zero-framework progressive web application (PWA) mobility services across Southern Africa (launch market: Gaborone, Botswana). Powered by vanilla ECMAScript modules, PocketBase edge backends, and spatial glassmorphic interfaces, the platform provides on-demand transport and local logistics with fair 7% driver commissions and real-time GPS tracking.

## Core Capabilities

- [Meenda Ride](https://meenda.blyston.online/#/rides): On-demand private urban ride-hailing with real-time GPS tracking and dynamic fare estimates.
- [Meenda Share](https://meenda.blyston.online/#/rides): Dynamic corridor ride-pooling offering up to 25% discounted commuter fares.
- [Meenda Eats](https://meenda.blyston.online/#/eats): Concierge food and essentials delivery connecting local restaurants with couriers.
- [Meenda Coaches](https://meenda.blyston.online/#/coaches): Intercity bus ticketing with seat selection and digital passenger manifests.
- [Driver Partner Hub](https://meenda.blyston.online/#/become-driver): Driver onboarding, earnings calculator, shift management, and 7% commission structure.

## Public Pages

- [Home Overview](https://meenda.blyston.online/#/home): Platform overview, core service verticals, and instant web app launch.
- [Passenger HUD](https://meenda.blyston.online/#/rides): Live map interface for setting pickup, dropoff, and booking trips.
- [Food Delivery](https://meenda.blyston.online/#/eats): Restaurant catalog, menus, cart checkout, and live courier tracking.
- [Intercity Coaches](https://meenda.blyston.online/#/coaches): Regional route search, terminal departure schedules, and bus ticket reservations.
- [How It Works](https://meenda.blyston.online/#/how-it-works): Step-by-step user guides for passengers, drivers, and delivery couriers.
- [About Meenda](https://meenda.blyston.online/#/about): Mission, Southern African transit infrastructure context, and corporate leadership.
- [Become a Driver](https://meenda.blyston.online/#/become-driver): Driver partner application portal, document verification, and vehicle inspection guidelines.

## API & Actions

- [OpenAPI Specification](https://meenda.blyston.online/.well-known/openapi.json): Machine-readable OpenAPI 3.1 specification for edge dispatch, orders, and telemetry.
- [AI Actions Manifest](https://meenda.blyston.online/.well-known/ai-actions.json): Deep-link URL schemes and pre-filled action parameters for autonomous agents.
- [Nearby Drivers Endpoint](https://pb.blyston.online/api/meenda/nearby-drivers): Edge Haversine query discovering online drivers within a 10km geographic radius.
- [Ride Bidding Endpoint](https://pb.blyston.online/api/meenda/bid-ride): Submits atomic driver proposals during the 5-second concurrency window.
- [Resolve Dispatch Endpoint](https://pb.blyston.online/api/meenda/resolve-dispatch): Resolves winning driver assignments based on minimal estimated travel time.

## Optional

- [Technical Architecture](https://meenda.blyston.online/docs/MEENDA_TECHNICAL_ARCHITECTURE.md): In-depth engineering manual detailing system topology, state machines, and algorithms.
- [Product Overview](https://meenda.blyston.online/docs/MEENDA_PRODUCT_OVERVIEW.md): Comprehensive executive brief on commercial strategy and Southern African market fit.
- [LLMs Full Reference](https://meenda.blyston.online/llms-full.txt): Complete uncompressed documentation bundle for large-context reasoning agents.