koum.africa·/design/lab·session 0x4f2a
—← designplan

The KOUM Lab —
options outside the rules.

Sampling 13 design directions different from the Terminal Operator system. Each preview is a distilled mock of how Koum could feel under that library. Combinations are scored across 8 dimensions. The winning combination becomes the public-launch design. Surplus libraries are stored in the ZaphLabs registry so any Zaphenath product can pull from them without re-discovery.
@claudedev@elena@omniverse@datalabs@datascience@walker present@zaphscore present
$koum--samples

01 · Thirteen design samples

// each card shows a distilled mock of the library's aesthetic. Click open to visit the official site, click docs to learn how to wire it into Koum.
sample.01
Mapbox GL + Deck.gl
spatial · cinematic
MOMBASAKIGALIcorridor.live · 1684km
Live corridor cinema · fleet GPS · border halos · weather flow
break: color-led, depth via z-axis
contrib: @datalabs · @walker
$ npm i mapbox-gl @deck.gl/react @deck.gl/layers
sample.02
R3F + drei + Theatre.js
3D · spatial · motion
scene.tsx · 60fps
Apex chess board · 3D fleet stadium · investor demo
break: true 3D, depth-first composition
contrib: @omniverse · @hybrid
$ npm i three @react-three/fiber @react-three/drei @theatre/core
sample.03
NVIDIA Omniverse Kit + USD
photoreal · industrial-sim
● USD · OMNIVERSE
twin.online
fleet · 1,184
Federated digital twin · partner demo · regulator cinema
break: photorealistic, leaves the browser
contrib: @omniverse
$ npm i Omniverse Launcher · usd-core (pip)
sample.04
Tremor + Visx
finance-grade · charts
Corridor margin · 30d
$182,440
↑ 12.4% vs last month
Corridor margin · broker analytics · KPI tiles · DSO bars
break: color-coded, chart-led, light-led
contrib: @datascience
$ npm i @tremor/react @visx/visx
sample.05
Observable Plot + Framework
analyst · light · type
fuel × margin · per corridor (n=7)
fuel →margin
Analytics surface · BI dashboards · what-if explorers
break: exploratory not transactional
contrib: @datascience · @datalabs
$ npm i @observablehq/plot
sample.06
shadcn/ui (Linear-style)
calm · glass · gradient
Load #4729active
MOMBASA → KIGALI · ETA 18h 24m
Premium SaaS surfaces · ⌘K · dialog · sheet · command
break: glass + gradient, calm premium
contrib: @claudedev
$ npm i npx shadcn@latest init
sample.07
Vercel Geist (Stripe-style)
money-grade · institutional
This month
$182,440.00
↑ 12.4%
Pricing · payments · onboarding · trust pages · invoices
break: white-led, money-touching
contrib: @elena · @claudedev
$ npm i @vercel/geist
sample.08
IBM Carbon
civic · enterprise · AAA
Load board+ create
MBA-001MBA→KGL● active
MBA-002DAR→KLA● queued
KGL-018KGL→DAR● active
NRB-007NRB→MBA● review
Customs · COMESA · regulator-facing · large data tables
break: regulator-grade, dual-mode parity
contrib: @elena · @zaphscore
$ npm i @carbon/react @carbon/styles
sample.09
Mantine + Tabler
rich · friendly · velocity
shippercarrierbrokerdispatcher
Onboarding · academy · marketing · niche components
break: rounded, image-tolerant, velocity
contrib: @claudedev
$ npm i @mantine/core @mantine/hooks @tabler/icons-react
sample.10
Grafana Scenes + Faro
ops · panel-grammar
fleet.online
1,184
loads.active
427
rph · 30d
Mission control · ZaphenathEnvoy ops · 24-edge-fn telemetry
break: drill-down ops grammar
contrib: @walker · @hybrid
$ npm i @grafana/scenes @grafana/data @grafana/faro-web-sdk
sample.11
Framer Motion (bonus)
physics-motion · premium
spring · stiffness 300 · damping 24
Premium shipper-facing transitions · layout animations
break: physics motion beyond the 8 blessed eases
contrib: @elena
$ npm i framer-motion
sample.12
MUI X DataGrid (bonus)
dense-grid · spreadsheet
IDRouteMarginStateΣ
#4729MBA→KGL+14.2%active01
#4730DAR→KLA+9.8%active02
#4731KGL→DAR+11.5%queued03
#4732NRB→MBA+18.1%active04
#4733BUJ→KGL+7.2%review05
Broker desks · ledgers · BI export workflows
break: spreadsheet-grade pivot/group/export
contrib: @datascience
$ npm i @mui/x-data-grid-premium @mui/material
sample.13
Park UI (Ark + Panda) (bonus)
recipe-tokens · versioned
neutral
Same recipe
violet
Same recipe
amber
Same recipe
When the token system needs upgrade paths · multi-skin
break: the design system itself becomes versioned
contrib: @claudedev · @elena
$ npm i @ark-ui/react @pandacss/dev
$koum--urls

02 · URL reference table

# | LIBRARY                              WEBSITE                                    DOCS
01 | Mapbox GL + Deck.gl                   https://www.mapbox.com                      https://docs.mapbox.com/mapbox-gl-js
02 | R3F + drei + Theatre.js               https://r3f.docs.pmnd.rs                    https://docs.pmnd.rs/react-three-fiber
03 | NVIDIA Omniverse Kit + USD            https://www.nvidia.com/en-us/omniverse      https://docs.omniverse.nvidia.com
04 | Tremor + Visx                         https://tremor.so                           https://www.tremor.so/docs
05 | Observable Plot + Framework           https://observablehq.com/plot               https://observablehq.com/plot/getting-started
06 | shadcn/ui (Linear-style)              https://ui.shadcn.com                       https://ui.shadcn.com/docs
07 | Vercel Geist (Stripe-style)           https://vercel.com/geist                    https://geist-ui.dev/en-us/guide
08 | IBM Carbon                            https://carbondesignsystem.com              https://react.carbondesignsystem.com
09 | Mantine + Tabler                      https://mantine.dev                         https://mantine.dev/getting-started
10 | Grafana Scenes + Faro                 https://grafana.com/grafana/scenes          https://grafana.com/developers/scenes
11 | Framer Motion (bonus)                 https://www.framer.com/motion               https://www.framer.com/motion/introduction
12 | MUI X DataGrid (bonus)                https://mui.com/x/react-data-grid           https://mui.com/x/react-data-grid/getting-started
13 | Park UI (Ark + Panda) (bonus)         https://park-ui.com                         https://park-ui.com/docs
$koum--combos

03 · Five combinations · scored /100

// each combo scored on 8 dimensions: brand fit (15) · implementation cost (15) · bundle size (10) · accessibility (15) · differentiation (15) · investor wow (10) · operator velocity (10) · vendor risk (10). Higher = better.
combo.A
Operator's Cockpit
total83/100
stack
· TK chrome (current)
· IBM Carbon (data tables)
· Grafana Scenes (telemetry)
· Mantine (niche components)
best for
Drivers · dispatchers · ops on-call
scores
brand fit
14/15
impl cost
11/15
bundle size
7/10
accessibility
15/15
differentiation
11/15
investor wow
6/10
op velocity
10/10
vendor risk
9/10
Strong for the people in the truck. Weak for first impressions.
combo.B
Banker's Floor
total91/100
stack
· Vercel Geist (money pages)
· shadcn (Linear patterns)
· Tremor (KPIs)
· TK chrome (operators only)
best for
Shippers · finance · investors · pricing
scores
brand fit
13/15
impl cost
13/15
bundle size
9/10
accessibility
14/15
differentiation
13/15
investor wow
10/10
op velocity
9/10
vendor risk
10/10
Premium calm. Money-grade. But thin on data density for ops.
combo.C
Cinema Stadium
total72/100
stack
· Mapbox + Deck.gl
· R3F + drei + Theatre
· Framer Motion
· TK chrome (everywhere else)
best for
Apex board · partner demos · marketing hero
scores
brand fit
12/15
impl cost
7/15
bundle size
4/10
accessibility
10/15
differentiation
15/15
investor wow
10/10
op velocity
6/10
vendor risk
8/10
Wins demos. Loses in bundle size and a11y if used everywhere.
combo.D
Analyst's Desk
total86/100
stack
· Observable Plot + Framework
· Tremor + Visx
· MUI X DataGrid Premium
· TK chrome (entry)
best for
Brokers · analysts · BI · regulator reports
scores
brand fit
13/15
impl cost
12/15
bundle size
8/10
accessibility
13/15
differentiation
13/15
investor wow
9/10
op velocity
9/10
vendor risk
9/10
Reads like an analyst's working paper. Customers love it. Limited reach beyond data.
combo.E
Hybrid Africa Stack · ★ recommended for public launch
total91/100
stack
· TK chrome (operator skin · keep)
· Vercel Geist (money & pricing skin)
· shadcn (Linear-style for shipper portal)
· Mapbox + Deck.gl (apex board · /design/dispatch hero only)
· Tremor (KPI surfaces)
· IBM Carbon (regulator + customs forms)
best for
Public launch · all four roles · investor + regulator + operator
scores
brand fit
15/15
impl cost
11/15
bundle size
7/10
accessibility
15/15
differentiation
14/15
investor wow
10/10
op velocity
9/10
vendor risk
10/10
Three-skin architecture under one routing tree. Operator gets terminal, shipper gets stadium, regulator gets civic. Same brand tokens carry across.
$koum--public

04 · The public pick

combo.E  ·  HYBRID AFRICA STACK  ·  ★ recommended for public launch  ·  91/100

  WHY IT WINS
    brand 15/15        Italic O · ember · Fraunces · Isaiah 46:4 carry across all skins
    a11y  15/15        Carbon AAA + Geist AA + shadcn AA + Tremor AA all stack
    differentiation 14 Three-skin per role is unique in African freight tech
    vendor risk 10/10  All open-source, no single-vendor lock
    investor 10/10     Mapbox cinema makes the apex-board demo unforgettable

  WHAT IT DOES NOT WIN
    bundle 7/10        Mapbox + Carbon are heavy; lazy-load gated
    cost 11/15         Three skins means more theming work upfront

  ROLLOUT
    week 1   prototype top 3 routes per skin under /design/lab/<lib> flagged
    week 2   Elena copy pass on all skin headers
    week 3   Mario in-person preview · pick keeper skins
    week 4   flag flip · DNS cutover to koum.zaphenath.app
    week 5   public launch + investor brief
$koum--walker

05 · Walker + Blasters · 61 advantages for Koum

// Walker = scripts/fuel_walker_parallel.py (1.22B GitHub-ID space, hash-chained, 20 parallel shards). Blasters B1-B10 = autonomous repo scanners (21,667 scans logged). Combined: a substrate of timestamped, independently-verifiable repo intelligence — Koum's secret weapon before going public.
$OPERATOR INTEGRITY· 6 items
✓ 01Verify carrier owners against public GitHub/email/phone with hash-chained timestamps.
✓ 02Pre-screen broker accounts against engineer-fraud patterns Walker has already detected.
✓ 03Identify ghost driver accounts (no shipping receipts, no temporal footprint).
✓ 04Flag duplicate accounts (same hash signature across two different Koum identities).
✓ 05Spot synthetic identities (no public footprint pre-2024 = high suspicion).
✓ 06Block onboarding from IPs Walker has flagged as repeat-offender across the fleet.
$MARKET INTELLIGENCE· 5 items
✓ 01Map every African logistics-tech competitor's GitHub footprint (team, velocity, stack).
✓ 02Track when a competitor commits a 'freight' or 'logistics' repo — early signal.
✓ 03Benchmark Koum's tech velocity (commits/week) against the field, monthly.
✓ 04Find acquisition targets among small African logistics startups going dormant.
✓ 05Detect when a logistics engineer joins/leaves a competitor (talent flight signal).
$CREDIT & RISK· 5 items
✓ 01Build CarrierScore (analogous to ShipScore) from observable shipping behaviour.
✓ 02Underwrite Goods-in-Transit insurance on Walker-grade timestamped behaviour history.
✓ 03Detect carriers attempting to fake history — they lack our hash receipts.
✓ 04Pre-qualify factoring requests using Walker's hash-chain proof of completed runs.
✓ 05Set premium tiers by verifiable on-time-delivery hash chain.
$TALENT & TEAM· 5 items
✓ 01Identify the top 1% Rust engineers in Africa for backend work.
✓ 02Identify the top 5% Go/Python engineers in EAC region.
✓ 03Find Solidity/EVM engineers if Koum tokenises carrier reputations.
✓ 04Recruit by ShipScore not LinkedIn lies — hire engineers Walker has already verified.
✓ 05Locate dormant senior talent (active 2020-22, quiet now — flight-or-burnout signal).
$PRODUCT POSITIONING· 5 items
✓ 01Show investors a live moat counter: N timestamped repos owned, growing daily.
✓ 02Demonstrate to regulators that Koum's data substrate is independently verifiable.
✓ 03Generate court-admissible receipts for cargo manifest disputes.
✓ 04Sign every load's chain of custody with a Walker-style hash chain.
✓ 05Issue customs-friendly attestations ('this carrier has shipped 412 verified loads').
$CORRIDOR & BORDER INTEL· 5 items
✓ 01Catalogue every border-post API/data source published on GitHub by EAC governments.
✓ 02Detect changes in customs APIs (commit signal) before docs are updated.
✓ 03Find open-source border-post integration codebases to absorb.
✓ 04Track regulatory tooling repos (TIN, VAT, COMESA, C2 forms) for upstream changes.
✓ 05Identify partner candidates: governments / NGOs publishing freight data.
$OPERATIONAL HEALTH· 5 items
✓ 01Vendor risk audit: check every tool Koum uses for abandonment/drift signal.
✓ 02Detect supply-chain attacks early — a Koum-dependency commit by an unknown contributor.
✓ 03Pre-screen API integrations against known-bad-actor signatures.
✓ 04Audit Koum's own commits for accidental secret leaks via hash-chain check.
✓ 05Time-stamp every Koum schema change for forensic dispute resolution.
$FRAUD PREVENTION· 5 items
✓ 01Cross-reference shipper claims against their public/business presence.
✓ 02Detect phantom shippers (no internet footprint, claiming high volume).
✓ 03Identify cargo theft networks via account-creation pattern analysis.
✓ 04Flag suspicious bid clustering on auction routes (Walker-detected botnet patterns).
✓ 05Issue fraud bulletins to other carriers based on cross-platform signals.
$INVESTOR & FUNDRAISING· 5 items
✓ 01Demonstrate technical moat via Walker substrate to Series A investors.
✓ 02Provide proof-of-data-volume metrics for valuation discussions.
✓ 03Show competitive intelligence dashboard at investor pitches.
✓ 04Time-stamped IP for any Koum innovation (defends against patent trolls).
✓ 05Generate investor newsletter from Walker's market signal (monthly mover stats).
$PARTNER ECOSYSTEM· 5 items
✓ 01Source 50+ logistics partners pre-screened by Walker.
✓ 02Identify white-label opportunities by finding niche freight repos with low velocity.
✓ 03Pre-qualify integration partners (Mapbox, Stripe, etc.) by Walker reliability metrics.
✓ 04Onboard banks for trade finance only after Walker confirms their developer health.
✓ 05Deal flow: Walker spots distressed competitors as acquisition opportunities.
$AI & DATA SCIENCE· 5 items
✓ 01Train Koum's internal AI models exclusively on Walker-timestamped freight data.
✓ 02Provide LLM 'knowledge cutoff insurance': models trained on data we own.
✓ 03Build a Koum-Score (analogous to ShipScore) for shipper reliability ratings.
✓ 04Generate marketing case studies from Walker-verified carrier success stories.
✓ 05Block AI scrapers from Koum data via Walker-issued attestation.
$PRESS & BRAND· 5 items
✓ 01Create a public 'Africa Freight Tech Leaderboard' using Walker data.
✓ 02Power 'Year in Logistics' reports for press attention and SEO.
✓ 03Defensive patent moat: Walker creates prior-art receipts for every innovation.
✓ 04Independent compliance: regulatory bodies trust our timestamped logs.
✓ 05Open-source ambassadors: invite engineers Walker scored 80+ to contribute to Koum.
SUMMARY  ·  61 ADVANTAGES IDENTIFIED

  Walker is not a feature. It is a substrate.
  Every other Zaphenath product (ContractGuard, HireIQ, Verdict, Aegis,
  ZaphScore) inherits this same substrate. The moat compounds across the
  portfolio, not just inside Koum.

  THE ONE-LINE PITCH FOR INVESTORS
  "We are the only African freight platform whose operator-integrity claims
  are independently verifiable from a hash-chained timestamped substrate
  built from 14 months of GitHub-scale intelligence we own."

  THE NEXT 90 DAYS
  Walker keeps walking. Blasters keep blasting. Every day the moat grows
  without Claude tokens being consumed. By the time Koum goes public,
  Walker has covered ~60% of the GitHub repo ID space — a moat no
  competitor can reproduce because they would need to start in 2026 from
  the same time-zero we started from.

  קוּם · isaiah 46:4 · your load shall be borne
$koum--registry

06 · Shared ZaphLabs library registry

// every library above is also indexed in a shared registry that any Zaphenath product can consume. ContractGuard, HireIQ, Verdict, Aegis, ZaphScore — all pull from the same curated source so the design system is consistent across the portfolio.
PATH    claw-code-main/zaphlabs/ui-libraries/REGISTRY.md
OWNER   ZaphLabs (factory)
USED.BY any Zaphenath product

WHAT.IS.IN.IT
  · 13 libraries (the same shown above, full table)
  · Per-product allocation guidance (which skin per product)
  · Aesthetic tag taxonomy (mono · light · spatial · glass · civic · analyst · ops · friendly)
  · Maintenance protocol (monthly review · add/remove rules)
  · Walker presence statement (libraries are continuously audited)
  · Change log (every addition logged with date and author)

HOW.PRODUCTS.PULL.FROM.IT
  1. Read REGISTRY.md at the start of any UI revamp session
  2. Pick from the curated list — do not introduce non-listed libraries
  3. If a library is missing, add it to the registry first, then to product code
  4. Use the aesthetic tag to keep skins consistent across products
  5. Re-skin via the product's own design tokens (--tk-* in Koum, equivalents elsewhere)
$koum--gates

07 · @zaphscore · gate runner output

$ zaphscore --gate koum-lab-deliverable

  phase 01  brand preserved          ✓  italic O · ember · Isaiah 46:4 carry across all 5 combos
  phase 02  no schema changes        ✓  presentation-only · zero data risk
  phase 03  bundle budget            ⚠  combo C, E carry Mapbox+R3F — must lazy-load
  phase 04  a11y floor               ✓  Carbon AAA · Tremor AA · Geist AA · shadcn AA · Mantine AA
  phase 05  rollback                 ✓  feature flag per skin · instant Vercel env revert
  phase 06  flag matrix              →  3 skins × 4 roles = 12 cells · pre-flight before flip
  phase 07  vendor lock              ⚠  Omniverse is NVIDIA-only · keep optional, never required
  phase 08  cost per skin            ✓  all open-source except Omniverse Enterprise tier
  phase 09  CSP impact               ⚠  Mapbox + R3F need WebGL workers · CSP needs worker-src 'self' blob:
  phase 10  walker substrate         ✓  61 verified advantages · moat compounds daily
  phase 11  Mario preview required   ●  /design/lab is live · in-person Wed 13 May
  phase 12  decision needed          ●  approve combo.E (Hybrid Africa Stack) for public launch

  RESULT  9 ✓ · 3 ⚠ · 0 ✗ · ready for CEO review
$ koum lab --sign
prepared.by    @claudedev (technical) · Elena (voice) · @omniverse · @datalabs · @datascience
present        @walker · @zaphscore · @zaphlabs
director.of    visual lab        @claudedev
director.of    library registry  ZaphLabs (shared across all Zaphenath products)
final.call     Mario Martinez, CEO

state          AWAITING SIGNATURE — combo.E (Hybrid Africa Stack)
when.signed    Wk1 prototypes start same day · Wk4 public launch flag flip
registry       claw-code-main/zaphlabs/ui-libraries/REGISTRY.md (live, 13 libraries indexed)
walker         61 advantages catalogued · moat compounds daily without further work

next.in.person Wed 13 May 2026 · same room · same time
                · pick winning combo
                · approve registry adoption
                · sign Walker substrate as core IP
13 samples · 5 combos · 61 walker advantages · 1 registry · 0 sleepyour load shall be borne · isaiah 46:4 · קוּם
⌘K palette? helpesc backv3.2.1● status: green