Moovo is a courier and transport platform by Oxy.
Send a package, food, or a whole move, carried by Moovo's own couriers or handed to an external provider.
|
A job is created by a sender, offered to couriers, accepted, picked up, and dropped off. Each side gets its own Expo app: the customer app that books it, Moovo Go that the courier carries, and Moovo Hub where a fleet dispatches and watches it. One Express API owns the job, the offers, the quote and the shipment, so the three apps never disagree about the state of a delivery. |
There is no Moovo account. Sign in is the device first Oxy session, handled end to end by No local token providers, no auth interceptors, no hand rolled bearer parsing. See the Oxy platform repo for how the session itself works. |
| Package | Path | What it is |
|---|---|---|
@moovo/frontend |
packages/frontend/ |
Moovo, the customer app: book a send, track jobs, shipments, orders |
@moovo/courier-app |
packages/courier-app/ |
Moovo Go, the courier app: job offers, vehicles, pickup and dropoff |
@moovo/fleet-dashboard |
packages/fleet-dashboard/ |
Moovo Hub, the fleet console: dispatch, fleet, companies, members, stats |
@moovo/backend |
packages/backend/ |
Express API: TypeScript, PostgreSQL via drizzle-orm, Socket.IO |
@moovo/shared-types |
packages/shared-types/ |
Domain DTOs every package imports |
All three apps are Expo, render @oxy.so/bloom primitives with NativeWind, and draw maps with react-native-maps.
Moovo was forked from the Mercaria marketplace shell, and the inherited marketplace code (listings, cart, checkout, stores, reviews) is still in the tree. Treat it as scaffolding on its way out, not as the Moovo domain.
bun install
cp packages/backend/.env.example packages/backend/.env
bun run dev:backend
bun run dev:frontendBun 1.4.3. Use bun and bunx, never npm, yarn or npx.
All the commands
bun run dev # every workspace at once
bun run dev:frontend # customer app
bun run dev:courier # Moovo Go
bun run dev:hub # Moovo Hub
bun run dev:backend # API
bun run build # shared-types, then backend, then frontend
bun run build:courier # Expo web export for Moovo Go
bun run build:hub # Expo web export for Moovo Hub
bun run lint # Biome: format + lint check, whole repo
bun run lint:fix # apply Biome's safe fixes and formatting
bun run format # format only
bun run --filter @moovo/backend test # Vitest
bun run --filter @moovo/backend typecheck # tsc --noEmitbun run android, bun run ios and bun run web target the customer app.
The courier domain
| Model | What it holds |
|---|---|
Job |
One movement: pickup, dropoff, timing, proof of delivery, verification codes |
JobOffer |
A job put in front of a courier, accepted or declined |
CourierProfile |
A person who carries jobs, and their status |
CourierCompany |
A fleet, its members and the jobs it dispatches |
Vehicle |
What a courier carries jobs with |
Quote |
A price for a job before it is booked |
Shipment |
A movement fulfilled by an external provider |
Provider |
An external carrier a shipment can be handed to |
Routes live under packages/backend/src/routes/: jobs, courier, shipments are the live courier surface.
Abuse reports go to CrowdSource, and a delivery is not a listing
Moovo does not run a moderation panel. Reports are committed locally with a durable outbox row in the same transaction, then delivered to CrowdSource, which decides them with a randomly drawn jury and returns signed decisions over a webhook.
What a jury sees is deliberately narrow. A job carries two names, two phone numbers, two street addresses, two precise coordinate pairs and the pickup and dropoff verification codes, and none of that leaves Moovo. Geography travels as a single rounded distanceKm, which answers whether a courier took a detour and identifies nobody, because a distance is translation invariant. The set of fields a delivery may emit is pinned by a test as an exact set, so a field nobody thought to forbid still fails the build.
Moovo has one enforcement lever, the courier's status, applied to courier privileges and never to the Oxy account. There is deliberately no way to cancel a delivery in flight, because that strands a courier holding someone else's property.
Built on @crowdsource.you/core — the client at the root, the Express webhook receiver under /express — and @crowdsource.you/contracts, which must resolve to exactly one copy in the tree. Moovo holds no CrowdSource key: the client presents the Oxy service token this process mints, and CrowdSource resolves the tenant from the Oxy application that token names.
Deploy
Everything ships from GitHub Actions in .github/workflows/:
| Workflow | Target |
|---|---|
ci.yml |
Lint, tests, API build and app builds on every push and pull request |
deploy-aws.yml |
API to AWS ECS Fargate on linux/arm64 |
deploy-cloudflare.yml |
Customer app web build to Cloudflare Pages |
deploy-cloudflare-go.yml |
Moovo Go web build |
deploy-cloudflare-hub.yml |
Moovo Hub web build |
TypeScript first, with no as any, no @ts-ignore and no non null assertions. Styling is NativeWind classes rather than inline styles. State is Zustand, data fetching is TanStack Query, routing is expo-router. Backend auth is @oxy.so/core/server middleware and is never hand rolled.
Longer form docs live in docs/, the full working agreement in AGENTS.md, and setup details in CONTRIBUTING.md.