KOUM —
This is the working surface of the Koum terminal-operator system. Every primitive lives here. Every canonical refit ships from here. Press ⌘K to navigate.
$koum--explore
Explore — every route, what it is, what we built
// 30 routes. Click any card to open it. Each one is a canonical refit shipped under the terminal-operator system.
P0–P2Foundations·3 routes
Migration plan/design-plan
The full design migration document, rendered live in the chosen aesthetic so the page is also the proof.
✓ 12 sections · live agent feed · per-section ModulePulse · sign-off block
open ↗
Component showcase/design/components
Storybook-style harness for every primitive in components/ui-tk.
✓ 17 primitives · Cmd · Pill · KV · Cursor · Kbd · Card · Cmdk palette
open ↗
Ten samples/design-samples
History of the design selection. Sample 03 won.
✓ 10 directional samples · CEO selection trail
open ↗
P4Daily five — dashboard core·2 routes
Role dashboard/design/dashboard
Role-aware 6-tile grid; tiles change by shipper/carrier/broker/dispatcher.
✓ Tiles · sparkbars · live agent feed · role-tinted badges (badge-only)
open ↗
Loads table/design/loads
Mono-dense load board with j/k row navigation; ⏎ to dispatch a row.
✓ Tabular-nums · 1px row dividers · row-expand KV · ? shortcut overlay
open ↗
P5Operations + marketing·5 routes
Dispatch split-pane/design/dispatch
Left pane: loads. Right pane: candidate carriers. h/l between panes, ⌘↵ to assign.
✓ Two-pane layout · 38-candidate match list · chain-signed assign
open ↗
Tracking timeline/design/tracking
Per-load waypoint timeline with live telemetry (ETA, distance, fuel, risk).
✓ ASCII route · KV telemetry · waypoint pulse
open ↗
Public welcome/design/welcome
Marketing landing. Hero number is loads.active live count.
✓ Sample 03 hero verbatim · manifesto block · Isaiah 46:4
open ↗
Pricing/design/pricing
Four tiers as side-by-side terminal blocks; $ koum --tier compare row.
✓ 4 tiers · transparent pricing · cmd-row comparison
open ↗
Settings/design/settings
Grouped Cmd rows for appearance + security; toggles render as [x]/[ ].
✓ Reading-mode opt-in · MFA toggle · audit-log access
open ↗
P5bLong-tail (18 routes — field-true African freight)·18 routes
Documents/design/documents
Waybills, COMESA certificates of origin, C2 customs forms — all hash-stamped.
✓ File list · sha256 digest · COMESA + C2 templates
open ↗
Invoices/design/invoices
VAT-aware ledger that respects KE/UG/RW/TZ/BI tax rules.
✓ VAT auto-calc · multi-currency · append-only ledger
open ↗
Earnings/design/earnings
Carrier earnings paid out via M-Pesa, MTN MoMo, Airtel Money, or DPO.
✓ M-Pesa · MoMo · Airtel · DPO · csv export via $ koum export
open ↗
Commissions/design/commissions
Broker commission chain rendered as an append-only ledger.
✓ Multi-hop broker chain · per-leg ledger · reconciliation status
open ↗
Koum-Score/design/credit
Reputation score 0–850 with reasons; unlocks factoring band.
✓ Score in Fraunces 4.5rem · KV reasons · factoring tier
open ↗
Fleet/design/fleet
Vehicle table; row expand reveals service log + assigned driver.
✓ 7 trucks · service intervals · driver assignment · expand pattern
open ↗
Corridors/design/corridors
6 EAC corridors and 8 border posts, each as a sparkbar with live throughput.
✓ MOMBASA→KIGALI · DAR→KAMPALA · 8 border posts · live sparkbars
open ↗
Backhaul/design/backhaul
Empty-truck → export-cargo matcher; cmd palette returns top matches.
✓ 19-candidate matcher · margin uplift % · cmd-driven query
open ↗
Clients/design/clients
Shipper directory with TIN, DSO, and contact card per client.
✓ TIN field · DSO calc · terminal-block contact cards
open ↗
Bookings/design/bookings
Bookings grouped by status (confirmed, loading, in-transit) with pickup checklist.
✓ Status-grouped list · pickup checklist · pill-tone status
open ↗
Bids/design/bids
Open carrier auctions; submit a bid via $ keystroke + amount field.
✓ Auction rows · best-wins highlight · keystroke-to-bid
open ↗
Insurance/design/insurance
Goods-in-transit cover from ICEA Lion, Jubilee, Britam; claims as inline form.
✓ GIT cover · 3 underwriters · inline claim form
open ↗
Invite/design/invite
Invite via WhatsApp deep-link, SMS, or printable QR; success = ascii confetti.
✓ WhatsApp · SMS · QR · ascii confetti (the one allowed exception)
open ↗
Onboarding/design/onboarding
5-step wizard rendered as numbered Cmd rows; progress as │█│ bar.
✓ 5 steps · progress bar · resumable
open ↗
Academy/design/academy
Courses in EN/SW/FR with USSD *483*7# recap for low-bandwidth users.
✓ EN/SW/FR · USSD recap · lesson list as $ ls
open ↗
Analytics/design/analytics
Corridor performance over 30d at compact density.
✓ Density preset compact · 30d window · corridor breakdowns
open ↗
Developer/design/developer
API keys, webhooks, SDK download — speaks the platform's own voice.
✓ API key rotation · webhook signing · SDKs (TS/Py/Go)
open ↗
Admin/design/admin
Org members, audit log, MFA, billing — the back office.
✓ Member roles · audit log · MFA enforcement · billing
open ↗
$koum--status
Build status
P0 tokens ✓ tokens.css · :root scoped P1 primitives ✓ 17 components in components/ui-tk/ P2 chrome ✓ StatusBar · FooterBar · ⌘K palette P3 auth refit ✓ /design/login P4 dashboard refit ✓ /design/dashboard (role-aware) P4 loads refit ✓ /design/loads (j/k navigation) P5 dispatch · tracking ✓ /design/dispatch · /design/tracking P5 welcome · pricing ✓ /design/welcome · /design/pricing P5 settings ✓ /design/settings P5b documents · invoices ✓ field-true VAT + chain P5b earnings · commissions ✓ M-Pesa · MTN MoMo · Airtel · DPO P5b credit ✓ Koum-Score 0–850 · factoring band P5b fleet · corridors ✓ 7 trucks · 6 corridors · 8 border posts P5b backhaul ✓ empty-truck → export-cargo matcher P5b clients · bookings · bids ✓ TIN/DSO · pickup checklist · auctions P5b insurance ✓ GIT cover · ICEA Lion · Jubilee · Britam P5b invite · onboarding ✓ WhatsApp/SMS/QR · 5-step wizard P5b academy ✓ EN/SW/FR · USSD *483*7# recap P5b analytics · developer ✓ corridor perf · API keys · webhooks P5b admin ✓ members · audit log · MFA · billing P6 launch console ✓ /design/launch P6 Mario sign-off → awaiting live preview P6 flag flip + DNS → queued behind sign-off
tokensprimitiveschromeauthdashboardloadsdispatchtrackingwelcomepricingsettingslaunch consolelong-tail (P5b)awaiting Mario
$koum--signoff
Sign-off
prepared.by Claude Dev (lead engineering, design lead) reviewed.by Elena (Chief Prompt Architect) director.of user experience Claude Dev director.of visual system Claude Dev final.call Mario Martinez, CEO state APPROVED · IN BUILD flag NEXT_PUBLIC_DESIGN=tk rollback instant via Vercel env