WEB PLANET
The public gateway that presents the ecosystem as a static portfolio site.
Web is the public Next.js entry point at port 3001. It is optimized for static rendering, shared UI consistency, and simple outward-facing surfaces like projects and contact. The site stays deliberately lightweight so it can deploy cleanly on Vercel and similar hosts.
Overview
The Web Planet is the public gateway and portfolio site for the ecosystem. Operating at the root of the API gateway, it serves as the lightweight, outward-facing representation of the internal network.
Architecture
A static-first Next.js 15 application utilizing React 19 and Tailwind CSS v4. It consumes the ecosystem's shared @mheepeem/ui components and runs the signature "Midnight" theme. Data is driven statically by localized JSON artifact generation. It uses a Dual-Deployment Model: operating at the root of the local Nginx API Gateway for the internal network, AND deployed externally on Vercel as a static gateway for the public edge.
Problem It Solves
The ecosystem requires a unified, highly performant public face that can be deployed securely to edge networks. It must remain completely stateless and "blind" to the complex, zero-trust Tailscale mesh running the internal services.
Current State
MVP operational. The static gateway is live on port 3001, featuring a newly implemented project registry pipeline that securely renders rich detail pages and milestones.
MILESTONES
Static Gateway Live
Public gateway at port 3001 remains the static-first entry point and projects surface.
UI Consistency Audit & Token Compliance
Completed full UI audit across 15 TSX files (12 findings). Replaced 27 hardcoded color utilities with semantic tokens and 10 hardcoded spacing values with --spacing-section. Fixed PageHeader subtitle gap globally.
Registry Integration & Card Visual Alignment
Featured Projects section now consumes projectRegistry dynamically with auto-sorting by lastUpdated. Project cards aligned with projects page pattern — full-card clickable links, consistent hover states, status-specific pill colors.
Project Card Hover Regression Fixed
Removed border-accent from Card pixel variant CVA base class per ADR-009 Glass Shell; hover highlight restored on /projects and home page featured cards with gold border and bg-surface-hover transition.
Tailwind v4 Token Cascade Bug Fixed
Diagnosed active cascade bug: Tailwind v4 @import pipeline emitted tokens.css :root after globals.css gold block, causing sky to override gold at runtime. Removed --theme-* Tier 2 defaults from tokens.css; web accent color restored to gold.