Charon — Vision Document

Authors: Vergel Esteban & Robert Evans Version: 1.0 | December 2025

The Idea: Your Travel Companion, Not Just a Ride

Charon is not a ride-hailing app. It's a travel companion.

In Greek mythology, Charon ferried souls across the river Styx—not adding vessels, but guiding passengers on journeys already in motion. That's our philosophy: add seats, not cars.

Every morning, millions of cars navigate Metro Manila's corridors with empty seats. Meanwhile, commuters wait for rides, adding more vehicles to already-congested roads. Charon connects these two realities—matching passengers with drivers already traveling their route.

Why "Travel Companion"?

Traditional ride-hailing answers one question: "Get me from A to B."

Charon answers a richer question: "What's the best way to get from A to B—right now?"

Charon Helps You...How
Find a seatMatch with drivers commuting your corridor
Discover alternativesSee public transit, walking routes, or combination trips
Plan aheadPre-book by time band, not just on-demand
Stay safeKYC-verified drivers, BLE/QR handshakes, SOS pipeline
Save moneyTransparent fares; fuel-offset credits for drivers
Reduce impactEvery matched ride = one less solo trip
The companion aspect means Charon thinks with you about your journey—suggesting a 3-minute walk to a safer micro-stop, alerting you to a faster corridor, or recommending you take the MRT when traffic is brutal.

Core Principles

  • Add Seats, Not Cars — Fill existing commutes; don't create new traffic
  • Curb Discipline — Safe micro-stops, predictable pickups, minimal driver detour
  • Transparent Fares — Clear breakdown before booking; no hidden fees
  • Safety by Design — KYC, tracking, SOS, car verification, deviation alerts
  • Public-First Economics — Incentivize supply without penalizing passengers

  • Technology Choices

    Maps & Routing

    ChoiceMapbox (primary)
    WhySuperior offline support, custom styling, competitive pricing
    AlternativesGoogle Maps (fallback for geocoding), OpenStreetMap (data layer)
    FeaturesTurn-by-turn, traffic-aware ETA, isochrones for corridor mapping
    Mapbox gives us the flexibility to visualize corridors, micro-stops, and detour budgets in a branded experience. Their Navigation SDK handles driver routing with traffic-aware ETAs.

    Hosting & Compute

    LayerChoiceRationale
    Edge ComputeCloudflare WorkersGlobal presence (300+ cities), sub-50ms cold starts, auto-scaling
    Static/WebCloudflare PagesInstant deploys, preview branches, edge caching
    RealtimeDurable ObjectsStateful WebSocket at edge for live tracking
    Background JobsCloudflare QueuesEvent-driven processing (fare calculation, notifications)
    Why Cloudflare? We're building for the Philippines first, but scaling globally. Cloudflare's edge network means a user in Manila or Cebu gets the same low-latency experience as one in Singapore or San Francisco.

    Coding & Frameworks

    LayerTechnologyRationale
    APIHono (TypeScript)Edge-native, lightweight, excellent DX
    WebReact + Vite + TypeScriptFast builds, ecosystem maturity
    MobileReact Native + ExpoCode sharing, rapid iteration, EAS builds
    ORMDrizzleEdge-compatible, type-safe, SQL-first
    ValidationZodRuntime validation, TypeScript inference

    Database & Data

    StoreChoicePurpose
    PrimaryNeon Postgres (+ PostGIS)Relational data, geo-queries, serverless scaling
    CacheUpstash RedisSessions, rate limits, hot data
    Edge KVCloudflare KVConfig, micro-stop cache, feature flags
    BlobCloudflare R2KYC documents, receipts (zero egress cost)
    Why Neon? Serverless Postgres with instant branching, automatic scaling, and PostGIS for spatial queries.

    Authentication & Payments

    ServiceChoiceWhy
    AuthClerkManaged auth, phone OTP, number masking
    Payments (PH)PayMongoLocal rails (GCash, Maya, cards)
    Payments (Global)Stripe ConnectSplit payments, driver payouts

    The Corridor Model

    Unlike point-to-point ride-hailing, Charon operates on corridors—well-traveled routes where commuters naturally cluster.

    Micro-stops are curated curb locations—mall lay-bys, side streets, building drop-offs—where pickups are safe and predictable. Detour budgets protect existing passengers. A driver publishing their QC→BGC commute has a cumulative detour limit (e.g., 500m).

    What Success Looks Like

    MetricTarget (Pilot, 90 days)
    Match Rate≥95% of requests matched within corridor/time band
    Pickup AccuracyETA within ±4 minutes
    SOS ResponseMedian <60 seconds to human escalation
    Seat Utilization1.8+ passengers per trip (vs. 1.1 solo driving)
    Cost Savings30%+ cheaper than traditional ride-hail

    The Charon Difference

    Traditional Ride-HailCharon
    Adds cars to the roadFills seats in existing cars
    Point-to-pointCorridor-based
    On-demand onlyPre-book by time band
    Surge pricingReverse-surge (incentivize supply)
    Driver waits for youYou walk to a micro-stop
    Anonymous transactionsCohorts, buddy seats, community
    "Move fewer cars. Move cities forward."

    Last updated: December 29, 2025