MISSION CONTROL — www.stanjhae.com
A portfolio built as an operations console. Chijindu Stanley Orji's career is the system under observation: uptime counted live, roles rendered as deploy releases, products as monitored services, and the Lagos → Debrecen → Dubai trajectory drawn as arcs across a rotating dot-matrix globe.
The conceit only holds because the data is real. Every figure on screen traces
to the source CV, encoded in src/data.
Five modules, all statically prerendered, plus the generated metadata routes.
| Channel | Route | Module |
|---|---|---|
| CH 00 | / |
Overview — identity, headline figures, profile, then the rest of the console |
| CH 01 | /deployments |
Roles as a release ledger, an overlap chart and a per-release changelog |
| CH 02 | /systems |
Products as a service registry, with an architecture diagram per system |
| CH 03 | /arsenal |
Capability matrix, core strengths, leadership, AI augmentation, education |
| CH 04 | /comms |
Direct channels, a validating composer and an operator terminal |
/icon, /apple-icon and /opengraph-image are generated at build time from
the same tokens as the site; /robots.txt and /sitemap.xml come from
src/app/robots.ts and src/app/sitemap.ts.
Persistent chrome wraps every route, rendered by components/hud/HudShell. It is
a server component; each moving part is the smallest possible client island
inside it.
- Status bar — call sign, link state, live wall clock and an uptime counter.
Both render
--:--:--placeholders in the server HTML and go live one commit after hydration. Stamping a server timestamp would bake build time into a prerendered page and show a confidently wrong clock. - Module rail — the channel switcher, a left rail at ≥48rem and a bottom
dock below it. Number keys
1–5jump between channels. - Telemetry ticker — the CV as a scrolling readout. No request rate, no latency, no uptime percentage; nothing here is monitoring anything.
- Backdrop — a WebGL field behind everything, and a cursor reticle over it. Both are omitted entirely under reduced motion.
- Cold boot — a POST sequence on first visit, decided by a blocking head
script so the overlay is in the first paint rather than flashing in after it.
Escape skips it;
localStorageremembers. - Command bar —
⌘K/Ctrl+K, built on cmdk. Navigation, theme, uptime and a few undocumented commands. Matches are held to a 0.2 score floor, because cmdk scores any subsequence and without ittraceoutrankedtraceroutewithuptime.
| Concern | Choice |
|---|---|
| Framework | Next.js 16.3.1, App Router, Turbopack, RSC-first |
| UI | React 19.2.8 |
| Language | TypeScript 5.9.3 |
| Styling | Tailwind CSS 4.3.3, CSS-first @theme, no tailwind.config.js |
| Theming | next-themes 0.4.6, class strategy |
| Motion | CSS and Web Animations for UI, gsap 3.15.0 + @gsap/react 2.1.2 for the boot |
| Globe | d3-geo, topojson-client, world-atlas on Canvas 2D |
| Numbers | @number-flow/react |
| Command bar | cmdk |
| Icons | @mdi/js |
| Forms | react-hook-form + zod 4 |
| Lint | ESLint 9.39.5 + eslint-config-next |
TypeScript is on the 5.x line rather than the 7.0 native port: typescript-eslint
(pulled in by eslint-config-next) refuses to load against TS 7.0, which takes
linting offline. ESLint is pinned to 9.x for the same reason — eslint-plugin-react
7.x crashes on ESLint 10. Revisit both once the plugin ecosystem catches up.
npm run dev # Turbopack dev server on :3000
npm run build # production build
npm run start # serve the production build
npm run lint # eslint (flat config)
npm run typecheck # tsc --noEmit
npm test # vitest (unit)Canonicals, /sitemap.xml, robots host and JSON-LD always resolve to
https://www.stanjhae.com, or to NEXT_PUBLIC_SITE_URL when that is set. Set
that variable on the Vercel production project to https://www.stanjhae.com.
Preview
deployments (VERCEL_ENV=preview) stay noindex so stanjhae-two.vercel.app
cannot become the indexed source of truth.
These are enforced by review, not by tooling. They are not negotiable.
- Named parameters. Every function takes one destructured object:
formatDuration({ start, end }), neverformatDuration(start, end). The sole exception iscn, which is variadic by necessity. - No raw elements in feature code. No
div, nospan. Compose withBox,HStack,VStackand passasfor the right semantics. Raw elements are allowed in exactly two places: insidesrc/components/primitives/*and insrc/app/layout.tsx. - No hardcoded colours. Semantic tokens only. If you need a new colour, add
a semantic token to
globals.cssin both themes — never a literal, and never a token named after a hue. - Dynamic classes use object notation.
cn('border-line', { 'border-signal': isActive }), not a ternary inside a template literal. - No inline styles, except genuinely dynamic numeric quantities with no Tailwind equivalent (a gauge fill width, a canvas dimension).
- Icons are sized by font size.
<Icon path={mdiRadar} className="text-2xl" />. There is nosizeprop and there will not be one. - Server-first. Primitives are all server components. Add
'use client'only to the smallest island that genuinely needs it. - Next 16.
paramsandsearchParamsare Promises —awaitthem, and prefer thePageProps<'/route'>utility type. Caching is opt-in via'use cache'.middleware.tsis nowproxy.ts.
Defined once in src/app/globals.css. Dark values sit on :root as well as
.dark, so the console renders correctly even before the theme script runs;
.light overrides them. @theme inline keeps utilities pointed at the raw
custom properties, which is what makes the swap a live re-resolution rather than
a rebuild.
| Token | Utility examples | Role |
|---|---|---|
surface |
bg-surface |
Base console field |
surface-raised |
bg-surface-raised |
Panels sitting above the field |
surface-sunken |
bg-surface-sunken |
Wells, gauge tracks, inset areas |
line |
border-line |
Hairline rules and panel borders |
line-strong |
border-line-strong |
Emphasised edges, scrollbar thumb (≥3:1) |
ink |
text-ink |
Primary text |
ink-muted |
text-ink-muted |
Secondary text, labels |
ink-faint |
text-ink-faint |
Tertiary text (still AA) |
signal |
text-signal bg-signal |
The one accent — active, live, focused |
signal-muted |
border-signal-muted |
Signal at fill/border strength, not text |
on-signal |
text-on-signal |
Text placed on a signal fill |
ok warn alert |
text-ok bg-warn/15 |
Status semantics |
overlay |
bg-overlay |
Scrims behind modals and the command bar |
Also exposed: font-mono / font-display, rounded-panel / rounded-pill,
tracking-label / tracking-chrome, and the decorative utilities
console-scanlines, console-grain, console-grid.
Every text token clears WCAG AA against all three surfaces in both themes — the
ratios are computed from the OKLCH values rather than eyeballed, and DAYLIGHT
OPS ink-faint sits at 0.505 rather than 0.53 precisely so it still clears AA on
surface-sunken. signal-muted does not clear AA at text size and is for fills,
borders and canvas guide strokes only.
Xenon violet, OKLCH hue 312. The reasoning is documented at length in
globals.css: the status hues own green, amber and red, so the accent has to
sit far from them to avoid reading as a state; violet is one of the few hues
that keeps its identity both at L 0.74 on near-black and at L 0.47 on paper
grey; and cyan-on-black is pastiche at this point.
- Geist Mono (
font-mono) — HUD chrome (label,heading) and reading copy (lead,body,meta,caption). - Archivo (
font-display) — page titles (display,title) and the names a stranger reads (name). Loaded with itswdthaxis, sofont-stretch-condensedgenuinely condenses rather than faking it.
label stays 11px tracked-out caps. Anything a recruiter must understand uses
name / body / meta, sentence case, with real leading.
Both are loaded via next/font/google and exposed as --font-console-mono and
--font-console-display.
src/components/primitives/, all re-exported from its index.ts. Import from
the barrel:
import { HStack, Panel, Text, VStack } from '@/components/primitives';Shared Tone union across every primitive:
'neutral' | 'signal' | 'ok' | 'warn' | 'alert'.
| Primitive | Key props |
|---|---|
Box |
as (semantic element), className, plus the element's own props |
HStack |
gap align justify wrap inline full as |
VStack |
same as HStack, column direction |
Text |
variant tone weight align truncate numeric balance as |
Icon |
path (MDI) label spin flip rotate — sized by font size only |
Panel |
title code status headerAccessory footer tone elevation padding ticks scanlines interactive bodyClassName |
StatusPill |
label tone size dot pulse |
Chip |
label/children tone variant size uppercase iconPath as href |
Gauge |
label value min max tone size orientation displayValue showLabel showValue segments |
Divider |
orientation tone label |
Scanline |
variant intensity rounded — decorative, aria-hidden, needs a positioned parent |
Scales: gap is none · xs · sm · md · lg · xl · 2xl · 3xl. Text.variant is
display · title · heading · lead · body · label · readout · caption.
Panel works two ways. Pass title / code / status / headerAccessory and
it renders its own header bar and padded body. Or pass padding="none" and
compose Panel.Header, Panel.Body and Panel.Footer yourself.
src/data/, barrel-exported from src/data/index.ts, types in
src/data/types.ts. Two invariants hold everywhere:
- No display strings. Dates are
MonthStamp({ year, month? }, month optional where the CV gives year precision only).src/lib/formatderives the text. - No invented metrics. Headline figures trace to the CV. Stacks and
topology may be completed from an owned source repo. Where the record gives
a capability rather than a number, the metric is a qualitative string and
its
numericisnull. Do not add uptime percentages — nothing here is actually being monitored.
| Module | Exports |
|---|---|
identity.ts |
identity, getContactChannel, UPTIME_ORIGIN, UPTIME_ORIGIN_ISO |
deployments.ts |
deployments (5 primary), allDeployments (all 8, merged), getDeployment, DEPLOYMENT_COUNT |
ventures.ts |
ventures (3 concurrent entries, same Deployment shape, distinguished by kind) |
systems.ts |
systems (18), systemsByTier, getSystem, getSystemsByTier, SYSTEM_COUNT |
arsenal.ts |
arsenalCategories, coreStrengths, leadershipAndDelivery, aiAugmentedEngineering |
education.ts |
education |
waypoints.ts |
waypoints, trajectoryArcs, currentWaypoint, getWaypoint |
modules.ts |
modules, moduleById, getModule, findModuleByPathname, MODULE_HREFS |
boot.ts |
bootSequence, computeBootTimings, BOOT_TARGET_DURATION_MS, BOOT_STORAGE_KEY |
modules.ts is the navigation manifest and the shared contract between the HUD
rail, the command bar and per-route metadata. Adding a module means adding a
route file and an entry there.
The uptime counter runs from 1 July 2014, the completion of the Covenant
University Computer Engineering programme — the reasoning is commented in
identity.ts.
components/globe/. An orthographic dot-matrix Earth on Canvas 2D, rotating one
turn every ~86 seconds, with the trajectory drawn as animated great-circle arcs.
scene.tsis loaded throughawait import(), which is what keeps d3-geo, topojson-client and the 108 kB Natural Earth atlas out of the initial bundle. d3-geo is used exactly once, to rasterise land into an equirectangular bitmap that then serves as an O(1) land lookup; everything per-frame is unit-vector arithmetic with no allocation.- Dots are bucketed by depth, so ~7,800 of them cost 16 state changes a frame rather than 7,800.
- Colour comes from the theme. Canvas 2D silently ignores an
oklch()string assigned tofillStyleand keeps the previous colour, sopalette.tsround-trips every token through a scratch 2D context to get sRGB channels, and re-reads them when the theme changes. The backdrop does the same for its WebGL uniforms. - The two themes are not each other's mirror image: dark ink on paper carries its
own contrast, whereas grey dots on near-black need a lifted interior tone, a
higher depth-falloff floor and a deliberately drawn limb before the disc reads
as a sphere.
isDarkFieldasks the palette which way round it is rather than asking next-themes, so a third theme would need no new branch. - Debrecen and Budapest are 190 km apart — a few pixels at this scale — so labels are de-collided vertically within each side of the disc and joined back to their markers with leader lines.
- Under reduced motion the loop never starts: one frame is painted with every arc fully traced.
The canvas is aria-hidden. The waypoint manifest beside it is not a caption —
it is the same data as text, in order, with the live station marked.
- Every interactive element has a visible focus ring, verified by walking the tab order in both themes.
- The command bar traps focus while open and returns it to wherever it came from on close, except after a command that changes route.
- The comms form marks invalid fields with
aria-invalid, wiresaria-describedbyto both the hint and the error, and announces errors throughrole="alert". prefers-reduced-motion: reduceskips the boot, freezes the ticker, drops the reticle, the standby sweep and the WebGL backdrop, and holds the globe on a single static frame. Nothing is left animating.- Prefer the
motion-safe:variant in CSS;useReducedMotion()is for decisions that genuinely live in JavaScript.
This is a real CV and the console conceit is not allowed to inflate it.
- No uptime percentages, no latency figures, no request rates. Service status says whether something is still running; it is not an SLA.
- Stacks and product topology may be completed from an owned source repo. Headline figures still trace to the CV.
- The arsenal cites how many times each technology appears in the record. There are no invented proficiency levels.
- The comms form validates locally and hands off to
mailto:. It reports "Validated · Not transmitted" and says so in plain language on the page, because no message is sent, stored or logged by this site. - The only computed figures are the live uptime counter and the trajectory
displacement, which is the great-circle sum over coordinates in
waypoints.ts.
lib/cn.ts—cn(...), clsx + tailwind-merge.lib/format.ts—formatMonthStamp,formatDateRange,computeDuration,formatDuration,formatNumber,formatCompactNumber,toPercent,padNumber,stripReleasePrefix.lib/uptime.ts—computeUptime,formatUptime,formatUptimeCompact. Pure, UTC-based so server and client agree.lib/use-reduced-motion.ts—useReducedMotion(), a client hook. Prefer themotion-safe:/motion-reduce:Tailwind variants where CSS can express it.lib/theme.ts—THEMES,DEFAULT_THEME,getThemeOption,getOppositeTheme.
src/
app/
layout.tsx html/body, fonts, providers, HUD shell
providers.tsx next-themes (client)
globals.css tokens, base styles, console textures
page.tsx CH 00 overview
deployments/ CH 01
systems/ CH 02
arsenal/ CH 03
comms/ CH 04
actions/ the comms server action
icon · apple-icon · opengraph-image · robots · sitemap
components/
primitives/ Box HStack VStack Text Icon Panel StatusPill
Chip Gauge Divider Scanline
hud/ status bar, rail, ticker, backdrop, reticle, standby
boot/ the cold-boot POST sequence
command/ the ⌘K bar
globe/ scene, geometry, palette, mount
overview/ deployments/ systems/ arsenal/ comms/
the per-module feature components
data/ the CV as typed data
lib/ cn, format, colour, uptime, theme, hooks
Route pages render a plain vertical stack. The shell owns the scroll container, the chrome offsets and the page gutters, so a page sets no background, no viewport height and no outer padding.