zlh-grind/CONSTRAINTS.md

ZeroLagHub – Frontend Constraints (ZLH Grind)

These constraints are non-negotiable.
They exist to prevent architectural drift, instability, and "demo-ware" UI patterns.

Runtime & Framework

• Node.js 22 LTS
• Next.js App Router
• React 18
• TypeScript
• Build once → run many
• No runtime builds
• No PM2 during active development

SSR & Client Boundaries

• Any file that touches:
  • window
  • document
  • location
  • WebSockets
  • xterm / DOM refs
    MUST be a client component with "use client" as the first line.
• No browser globals at module scope in server components.
• Prefer useEffect for browser-only logic.

UI Philosophy

• Control-plane first, not marketing gimmicks.
• Flat UI by default.
• Subtlety beats spectacle.
• Readability > novelty.

Explicitly Forbidden

• Neon / RGB accent colors outside error states
• Scanline / CRT / HUD overlays
• Persistent 3D transforms or perspective UI
• Excessive glow stacking
• Clip-path bevel frames
• Continuous decorative animations

Branding

• Brand: ZeroLagHub
• Shorthand: ZLH
• Gaming heritage is acceptable, esports aesthetic is not.