Skip to content
OxyHQPublic

About

Moovo — courier/transport platform by Oxy (packages, food, moves; own couriers + external providers)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

248 Commits

Folders and files

Repository files navigation

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.

Expo SDK 56 React Native 0.85 TypeScript Bun Express PostgreSQL


🚚 Three sides of one delivery

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.

🔑 Identity comes from Oxy

There is no Moovo account. Sign in is the device first Oxy session, handled end to end by @oxy.so/services on the client and @oxy.so/core on the server.

No local token providers, no auth interceptors, no hand rolled bearer parsing. See the Oxy platform repo for how the session itself works.

Packages

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.

Quick start

bun install
cp packages/backend/.env.example packages/backend/.env
bun run dev:backend
bun run dev:frontend

Bun 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 --noEmit

bun 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

Conventions

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.


Part of the Oxy ecosystem

About

Moovo — courier/transport platform by Oxy (packages, food, moves; own couriers + external providers)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages