Sit-We-Go

A community-driven, open-source mobility platform

Sit-We-Go is an open mobility platform built to empower drivers and riders alike. This repository hosts the backend services that power the Sit-We-Go ride-hailing experience.

Vision

Sit-We-Go aims to empower service providers with a high-tech, cost-effective platform built on open foundations. Our vision is centered on the following principles:

1. Driver-Centric: Ensuring fair earnings and economic empowerment for drivers, with minimal commissions and transparent pricing.
2. Open: Utilizing open code, open data, and open standards to foster transparency, innovation, and collaboration within the community.
3. Optimize: Achieving sustainable, population-scale growth through continuous optimization of infrastructure, mapping, and development costs while maintaining high reliability and a rich user experience.
4. Multimodal: Supporting various modes of transport to provide comprehensive, integrated mobility solutions for a seamless user experience.
5. Shared Transport: Promoting shared mobility options to reduce traffic congestion, lower costs, and minimize carbon emissions, contributing to a sustainable future.

As engineers, we often seek opportunities where one person can serve millions of others. Sit-We-Go is an effort to enable the careers of those who serve one-to-one — drivers who transport people each and every day. These drivers indirectly serve millions of customers over time.

Core Values

Community-first

Mobility must be owned by the community of citizens and drivers who collaborate to create a thriving, equitable, and sustainable environment. Participatory development from the community helps build products to solve large-scale problems like mobility.

Citizens as owners

Drivers invest in their vehicles and work hard every day. Citizens pay for and use the service. They both should own the platform, offering quality service at a fair price, without intermediaries dictating terms or prices.

Open Platform

Customers participate in community efforts by using the open system, providing feedback, and improving drivers' lives. Our data and roadmap are open for feedback. The team strives to be efficient, prioritize the critical few, and do more with less.

Tech and People are enablers

Mobility is an engineering problem, and technology can make it more efficient, reliable, and sustainable. We need both tech innovation and human involvement. Empathy and support for both citizens and drivers are crucial.

Sustainable Growth

We aim to solve complex, long-term problems sustainably, avoiding unsustainable tactics like discounts and incentives. We pursue initiatives that are financially, environmentally, and socially sustainable, promoting shared mobility and efficient public transportation to reduce traffic, cost, and carbon emissions.

Why Solve This Problem?

Mobility is critical to economic growth, social progress, and individual well-being. People's livelihoods depend on mobility, but current systems could be more efficient, sustainable, and accessible to the masses. To improve this, mobility should be community-driven, open, tech-enabled, and shared.

Join us in this endeavor to transform mobility. We look forward to your contribution and support!

Workspace Layout

This repository is a Rust Cargo workspace. Each crate lives under packages/:

Package	Description
packages/api	Main HTTP service binary (drivers, customers, rides, ride requests, ratings, subscriptions, etc.)
packages/aws	AWS integrations (S3, KMS)
packages/db_store	PostgreSQL access layer
packages/redis_store	Redis access layer and event streams
packages/kafka	Kafka producer/consumer wiring
packages/payment	Payment providers (M-Pesa)
packages/notif_api	Notification API client
packages/email_api	Email API client
packages/sms_api	SMS API client
packages/twilio	Twilio integration
packages/utils	Shared utilities (hashing, HTTP helpers)
packages/shared_macro

Getting Started

Prerequisites

• Rust 1.92.0 (pinned in rust-toolchain.toml — rustup will install it automatically).
• PostgreSQL with the PostGIS extension enabled (the API uses geospatial types for nearby-driver lookups, ride geometries, etc.).
• Redis (standalone or cluster).

1. Set up PostgreSQL

Create a database and enable PostGIS:

CREATE DATABASE sitwego;
\c sitwego
CREATE EXTENSION IF NOT EXISTS postgis;

Migrations under packages/api/migrations are applied automatically on API startup.

2. Set up Redis

Run a local Redis instance (e.g. redis-server or docker run -p 6379:6379 redis:7). For development, standalone mode is fine — set APP_ENV=dev to force standalone against localhost:6379 regardless of cluster settings.

3. Configure environment

Copy the example file and fill in values:

cp .env.example .env
# edit .env with your DATABASE_URL, REDIS_*, JWT, AWS, Twilio, etc.

See .env.example for the full list of variables.

4. Run the API

cargo run --bin api

The service listens on the port defined by PORT (default in scripts is 8090).

Roadmap / TODO

• Surge pricing implementation — dynamic fare multiplier based on demand/supply in a given area.
• Beckn BPP adapter — make Sit-We-Go compliant with the Beckn network as a BPP. Work in progress in packages/beckn-bpp-adapter — not yet complete.

Get Involved

Explore the code, provide feedback, and contribute to the project. Together, we can create a scalable, efficient, safe, and sustainable transportation network.

Community Engagement

Join our GitHub Discussions to ask questions and explore ideas.

Contributing Guidelines

We believe in the power of open-source. This repository aims to foster an open development platform for the mobility stack, where anyone can inspect and contribute. We welcome contributions in the form of bug reports, code patches, documentation updates, feature requests, and notifications of breaking changes in dependencies.

Happy Contributing!

License

AGPL-3.0-or-later