# Subnautica2Maps — Inner Pages Design Refresh Handoff

Status: DESIGN_GO for current committed inner route scope
Date: 2026-05-21
Task: t_13066796
Stitch SDK: official `@google/stitch-sdk`, model `GEMINI_3_FLASH`
Project ID: `15625124394005741256`

## 1. Development source files

- Content-fit matrix: `content-fit-matrix.md`
- Stitch screen index: `stitch-screen-index.json`
- Verification manifest: `verification.json`
- HTML visual truths: `html/*.html`
- Screenshots: `screens/*.png`
- Contact sheet: `screens-contact-sheet.jpg`
- SDK logs: `logs/stitch-generate.log`

## 2. Pages and Stitch screens

| Page | Route | Desktop screen | Mobile screen | HTML files | Screenshot files |
|---|---|---|---|---|---|
| `map` | `/map/` | `1501ab26892547ff9fc0ee0045a45f92` | `0f0d142b8a14475ea7e3cc4ec3a0eac7` | `map-desktop.html`, `map-mobile.html` | `map-desktop.png`, `map-mobile.png` |
| `resource-detail-template` | `/resources/{slug}/` | `864df5cdb0eb4628bd63febf479c133f` | `1094207886d243519ff7e869d5565426` | `resource-detail-template-desktop.html`, `resource-detail-template-mobile.html` | `resource-detail-template-desktop.png`, `resource-detail-template-mobile.png` |
| `guide-coordinates` | `/guides/how-to-find-coordinates/` | `e292c5bc34dc4936aef6d6204d289e69` | `ca6e7be435e94bf9ad224b2aca102b54` | `guide-coordinates-desktop.html`, `guide-coordinates-mobile.html` | `guide-coordinates-desktop.png`, `guide-coordinates-mobile.png` |
| `guide-map-answer` | `/guides/does-subnautica-2-have-a-map/` | `4ebfe8fd2d47489bb1832155aef5a497` | `b82c43e9525f4109bcf7e156a3579238` | `guide-map-answer-desktop.html`, `guide-map-answer-mobile.html` | `guide-map-answer-desktop.png`, `guide-map-answer-mobile.png` |
| `legal` | `/legal/` | `c68f49d27db346b89f8cda05f6d1da87` | `a25a3d37f2f54328b1a589aa5705bdc1` | `legal-desktop.html`, `legal-mobile.html` | `legal-desktop.png`, `legal-mobile.png` |
| `privacy-policy` | `/privacy-policy/` | `4fbbe079b6fd4efdb3506972f96eebef` | `20dd5b56e8724deda4221b0ae8d00122` | `privacy-policy-desktop.html`, `privacy-policy-mobile.html` | `privacy-policy-desktop.png`, `privacy-policy-mobile.png` |
| `terms-of-service` | `/terms-of-service/` | `580bf750b15e426b9fb98ffe082cc4be` | `53b20751f09848dd96215b403e9da6c0` | `terms-of-service-desktop.html`, `terms-of-service-mobile.html` | `terms-of-service-desktop.png`, `terms-of-service-mobile.png` |

## 3. Design direction

Retro-futurist deep-sea HUD: dark tactical console, self-made coordinate grid, scanner panels, phosphor cyan accents, kelp green action states, amber risk/source labels. The design is intentionally not a SaaS hero or generic article template.

## 4. Design tokens

| Token | Value |
|---|---|
| Background | `#041012` |
| Surface | `#071A1D` |
| Surface elevated | `#0B262A` |
| Text primary | `#E7FFF8` |
| Text secondary | `#8CB7B0` |
| Accent primary | `#27E7C5` |
| Accent secondary | `#B8FF5C` |
| Warning accent | `#FFD166` |
| Error/spoiler | `#FF5C7A` |
| Display font | `Space Grotesk` |
| Body font | `IBM Plex Sans` |

## 5. Route scope decision

Covered current committed repo/sitemap inner routes and templates: `/map/`, `/resources/{slug}/` as resource detail template for silver/copper/sulfur, `/guides/how-to-find-coordinates/`, `/guides/does-subnautica-2-have-a-map/`, `/legal/`, `/privacy-policy/`, `/terms-of-service/`.

Not covered as DESIGN_GO screens because they are not current committed routes: `/biomes/[slug]`, `/blueprints/[slug]`, `/locations/[slug]`, `/resources` hub, `/blueprints` hub. Content-fit matrix records them as follow-up templates only.

## 6. Implementation notes for frontend

- `/map/`: use the Stitch map screens for visual direction, but keep current React map implementation as functional source. Apply visual ideas selectively: denser tactical sidebar, calmer marker drawer, collapsible mobile bottom sheet, source/confidence legend close to marker detail.
- Resource template: preserve answer-first H1, filtered-map CTA, coordinate table, route clue, source/provenance, and noindex distinction for sulfur. Do not let video/source cards replace the map action.
- Guides: keep answer-first copy, then immediately convert the answer into a task path: open map, read coordinates, compare depth, check confidence.
- Legal/privacy/terms: keep distinct hierarchy; do not merge into a duplicate wall. Privacy must emphasize local-only coordinate calculation and localStorage progress.
- Mobile: all screens use narrow single-column composition. Frontend follow-up should specifically polish 390px map bottom-sheet density and 1440px marker density, matching QA residual P2 items.

## 7. Placeholder / asset policy

- No official Unknown Worlds/KRAFTON/Subnautica logos, screenshots, key art, map tiles, or official visual identity were requested or embedded.
- Resource/media support cards should remain generated placeholders + click-to-load `youtube-nocookie` embeds only; do not download, hotlink, or store YouTube thumbnails.
- Stitch generated internal visual assets are reference-only. Production should use self-made SVG/CSS map layers and existing public marker JSON.

## 8. Verification

- 14 Stitch screens exported: 7 page/templates × desktop/mobile.
- All 14 HTML files start as complete HTML documents and are >5 KB after resource desktop repair.
- All 14 screenshots are valid PNG files.
- One transient Stitch service-unavailable error occurred on the first resource desktop attempt; retry succeeded. One SVG-only resource desktop export was detected and repaired; final index points to the repaired full HTML screen.
- Visual contact-sheet review: screens consistently show dark deep-sea HUD/map/game utility language; no blank or asset-only final screenshot remains.

## 9. Design verdict

DESIGN_GO for frontend iteration against current committed route scope.

Frontend follow-up needed: yes — apply selectively to production, with priority on `/map/` bottom-sheet density, marker density, and resource detail information hierarchy. Do not add unimplemented biome/blueprint/location pages to sitemap until routes/data/copy exist.
