The Wanderer's
Atlas

Rather than reach for code, the session first read the whole docs/ folder and mapped the existing site — the homepage globe, the six content domains, the design tokens — then went looking outward for reference.

A research pass surveyed the state of the art in explorable web worlds — Bruno Simon's drivable portfolio, Jordan Breton's floating island, cozy Zelda-like navigators, Stripe's globe — and pulled out the guardrails that separate a delightful world from a frustrating one: don't trap goal-driven visitors, treat mobile as a first-class tier, keep the real content crawlable beneath the spectacle, make sound strictly opt-in.

Then came the long part: a clarifying loop where every creative decision was put as an explicit question and confirmed one at a time — direction, game depth, breadth, the escape hatch, art style, the intro's motion, sound, the guide, the site chrome, day versus night, the world's very name. Twenty-odd choices, each answered before any of them was assumed.

So the whole design was written down as a build bible — the vision, the six regions, the architecture, the file map, the sixteen-phase plan, the risks and the verification playbook — to be executed deliberately rather than all at once. One more round of questions settled the workflow itself:

Four answers set the rules of the build: one long-running branch behind the ATLAS_LIVE flag; a silent changelog until the flip, so the story could land in a single entry; a cheap concept-board gate before any real art; and audio sourced under permissive licences. With the map drawn and the method agreed, one instruction remained.

And the sixteen phases began — the first of them clearing the ground by deleting a decade-old vendored theme, so the new world had nothing to fight.

Phase 0 was demolition done carefully. The vendored stylesheet came out partial by partial — but only after every rule was proven dead: the CSS was compiled before and after and diffed by structure (the new output a pure subset of the old, 424 rules removed and not one added), and each of the 366 orphaned selectors was tested against the live pages to confirm it matched nothing at all. The entry stylesheet shed roughly a third of its weight, and the first green commit landed on the branch.

Phase 1 laid the foundation no visitor sees: one versioned localStorage key for the whole world, a pure and unit-tested migration that quietly carries a returning visitor's old globe visits into the new passport, the view-mode resolver that decides Atlas-or-Classic before the first paint, and a hidden, noindexed /world route to preview it all. Phase 2 raised the frame on top: the day/night design tokens, the world HUD — compass, passport, sun/moon, sound, return-to-map — and the one-way switch that ties the scene's daylight to the site's dark mode, so the two can never disagree.

The last pass drove every control by hand — the sun/moon flipping both the sky and the theme in lockstep, the passport's Classic escape hatch dissolving the whole frame, the compass listing all six regions — then left the branch green: lint clean, sixty-odd tests passing, and the build split so GSAP and the atlas chrome load only for visitors who actually step into the world. Three phases down; the map itself was next.

Phase 3 was the map itself — and the plan had placed a gate in front of it. Before any real biome art, the build owed one cheap approval: a rendered concept board showing the map's composition, a single fully detailed biome, both day and night palettes, and the world HUD. Art is expensive to redo; a mockup is not. So the session drew the board rather than the map — the six regions laid out corner to corner with the Book Forest worked up to full detail as the benchmark, a working sun/moon that repainted the whole scene live, and every colour pulled straight from the shipped --atlas-* tokens, so what was approved was exactly what the code would produce.

The art direction locked in a single word, and the hub could be built for real. The pan-zoom hook that once drove the mind map was promoted to a shared home — a one-line re-export shim left at the old path so nothing broke — the six biomes became inline-SVG components, and WorldMap stacked them in the planned order: sky, far ranges, the biome landmasses, foreground props, the interactive region hotspots, the easter-egg layer, the name plaques. Activating a region flies the camera to its framing and then navigates; returning from a page reverses the very same read. Under the spectacle sat the accessibility spine — an offscreen <nav> of six real links as the single source of truth, a roving tabindex, arrow keys walking the regions in geographic order, Escape resetting the zoom.

The map came up clean on the first drive: six hotspots correctly labelled, the screen-reader nav mirroring every route, the scene flipping day to night on command. The branch stayed green — lint clean, eighty-nine tests passing with twenty new ones guarding the map's geometry — and the entry bundle didn't move a byte: the whole map, all six biomes and the pan-zoom hook landed in a lazy chunk that only a visitor actually stepping into the world ever loads. Four phases down, and the world finally had its map.

Three phases built in one sitting, each leaning on the last. Phase 4 put the arrival in front of the map: the homepage globe, reused in a new orbit mode with its chrome stripped and a slow auto-rotate, gained an imperative handle so the dive could plunge its camera; CloudBloom and DiveSequence became one GSAP timeline — plunge, whiteout, clouds parting over a map that pulls out from its centre — and AtlasHome turned into the orbit → dive → map state machine, the intro remembered forever after, the whole sequence lazy so GSAP loads only for a visitor who actually dives. Phase 5 raised the first interior: RegionShell wraps a page in a themed biome band — skip link, shared meta, breadcrumb, a real <main> — while leaving the page's own content untouched, and PageShell became the single switch between the Atlas and Classic shells. The Book Forest went first; arriving stamps the region and the RewardToaster pops it with the reused confetti. Phase 6 added the game itself — a pure, unit-tested quest engine over declarative quests and time / return achievements, the passport grown to show them filling, and five easter eggs tucked into the map art. The branch stayed green: lint clean, a hundred-and-one tests with twelve new ones pinning the engine, the entry bundle still inside its budget.

Then the page waves — every remaining route rebuilt as its region's interior, four phases in a row. Wave 2 opened the Coastal Road and the Sahyadri Ridge; wave 3 the Scriptorium trio of blogs, micro-posts and challenges; wave 4 the Workshop of projects and résumé; wave 5 the Hometown Square, carrying the Observatory and the Gallery Trail at their same URLs. Each page changed by exactly one import and one wrapper line, its content identical inside either shell — and each wave brought its own collector quest, so the passport kept growing: Roadrunner, Summiteer, Wordsmith, Tinkerer.

The last two waves landed as their own green commits — and then, for the first time, the world was driven in a live browser. A port collision had been quietly serving a blank page; a dedicated preview pinned to a fixed port put it right, and the whole arrival finally played through end to end: the orbit's counting teasers, Enter into the dive, the map waking at night with its windows lit and stars out, a deep-linked Book Forest interior with its breadcrumb and its Return-to-Map, and the passport filling with dated stamps and live quest progress. No console errors, ten phases down — the final art, the audio, the guide and the flip still ahead.

Three more phases in one sitting, each a different kind of craft. Phase 11 — art & perf grew the five placeholder biomes up to the Book Forest benchmark: a crenellated hill-fort and a switchback summit trail on the Ridge; a START gantry, a medal monument and the striped lighthouse on the Coast; a writing quill and a stamping press at the Scriptorium; two meshing counter-rotating gears and a swinging crane in the Workshop; bunting and a pulsing fountain on the Square. A foreground NearLayer of waves and bushes went in, and a gsap.quickTo parallax where the sky and far ranges lag the camera while the near props lead it. A latent bug fell out along the way — the region header bands reuse the biome art but had never loaded the map's stylesheet, so their lanterns and beams burned at full daylight; the day/night switches were lifted into a shared file the art itself imports, and the headers healed. Phase 12 — audio added a hand-rolled WebAudio manager, dynamically imported the first time a visitor turns sound on (that click is the autoplay unlock), cross-fading a per-region ambient bed as you move — and every one of the seven beds and the SFX sprite was procedurally synthesised from filtered noise and sine partials, so the repo owns its audio outright, licence-clean by construction and loading nothing until asked. Phase 13 — the guide drew a flat-vector mini Sanket — red pheta, moustache, cream bandi over a dark kurta — who speaks one line at a time; a live test caught him greeting visitors over the orbit globe before the map had even appeared, so he was gated to wait until the hub. With him in place, react-joyride was retired entirely — its 92 KB chunk gone, the entry bundle a touch lighter than before it ever arrived.

The compass had only ever offered the six region landings — the other ten pages, from Challenges and the Micro Blog to the Résumé, the Observatory and the Gallery Trail, couldn't be reached from the map at all. So the region registry became the single source of truth for navigation: each region gained an ordered list of its pages, and the compass grew into a full directory grouped by region, every entry carrying a fitting Material Symbols icon. A small gift fell out of grouping by data-region — each group inherits its region's accent colour, so the whole menu reads colour-coded without a line of extra styling.

Two requests, arriving with a screenshot. The view-switcher tabs on the Sports and Treks interiors had collapsed into run-together text: the atlas's scoped reset — written to give bare chrome sane defaults — was quietly out-specifying the Tailwind utilities on the imported page content and stripping the buttons' padding, background and colour. Wrapping the reset's element selectors in :where() dropped its weight below the utilities, and the tabs snapped back into proper pills, identical to the Classic shell. Alongside it came a naming decision: Coastal Road became Marathons, Sahyadri Ridge became Treks, and the Workshop became Projects — trading biome-poetry for plain labels on those three, while the Scriptorium, Book Forest and Hometown Square kept theirs. The rename rippled through the registry, the map plaques and screen-reader nav, the collector-quest copy and an easter-egg hint — and surfaced one last inconsistency: the passport had been reading its stamp names from the globe's own table rather than the atlas registry, so it still said “Creator” where the map now said “Projects.” Pointed at the registry, it finally read in step with the rest of the world.

The last two phases were the flip. Phase 14 — cleanup finally deleted the decade-old vendored theme outright: twenty-eight SCSS partials and the sass dependency gone, the entry stylesheet dropping from 164 KB to 102 KB (25.9 → 15.9 KB gzipped), with a small scoped classic.css left in its place for the escape-hatch shell. A quiet bug fell out with it — rounded-full had been overridden to 0.75rem, which only looks round on short elements and had silently squared off every avatar, icon button and tag pill; it was restored to a true 9999px. The changelog's own headings, force-uppercased by a legacy global, healed the moment the theme left. Phase 15 — the flip set ATLAS_LIVE = true: the Atlas became the site's front door at /, the old /world preview began redirecting home (a 301 at the edge), and the deliberately silent changelog landed its single comprehensive v11.0.0 entry, telling the whole sixteen-phase story at once.

Two questions were put before the flip, and both answers steered it:

One craft note: because the cleanup and the flip both touch App.js, the two were staged apart — the theme-removal slice committed first, the routing swap with the flip — so each commit compiles on its own rather than only as a pair. Beyond the flip lay one small mobile fix that put all six worlds in a single window — told next.

The map is drawn wide — a 2000×1250 landscape with six biomes spread corner to corner — but a phone is tall and narrow. The hub had been resting zoomed onto the hometown square, so a phone only ever showed the centre; the other five worlds were a drag away. The diagnosis: the map's SVG was set to fill-and-crop (slice), which on a portrait screen quietly clips the left and right regions off-frame.

The fix was two moves: rest the camera on the whole map on every viewport, and on phones only, switch the SVG to fit (meet) so nothing is cropped — all six worlds in one window. A twist surfaced mid-investigation: a second Claude Code session was already working in the same repository and had landed most of that change moments earlier. This session reconciled the two — repairing a formatting pass that had tripped the project's lint rules, and keeping the tests green.

The first attempt anchored the fitted map to the bottom, which left a wall of empty sky above it. Feedback arrived as a screenshot and a second sentence:

One character did it — the vertical alignment moved from bottom (xMidYMax) to centre (xMidYMid), with the desktop's immersive full-bleed slice untouched. The change shipped as v11.1.0 alongside an on-screen zoom cluster for touch users, was committed, pushed, and opened as a pull request. Then this dossier — its colours borrowed from the Atlas's own design tokens — was written in the same conversation.