CLAUDE.md

This is the Unicorn.Land website and design system repository.

Repository Structure

• design-system/ — Design tokens, CSS, Tailwind 4 theme, brand assets, web components
• .deploy/ — Cloudflare Pages deploy directory (static site output)
• reading/ — Long-form reading pages (source HTML)
• docs/plans/ — Design and implementation plans
• .github/workflows/ — CI/CD (Cloudflare Pages deploy)

Design System

Tokens live in design-system/tokens/, CSS in design-system/css/unicorn-land.css, Tailwind theme in design-system/tailwind/theme.css.

• Signature color: Opal #56dbd0 with teal scale
• Neutrals: Warm stone (not blue-gray)
• Font: Outfit (Google Fonts), JetBrains Mono for code
• CSS custom property prefix: --ul-*

Brand

Brand assets in design-system/brand/ — holographic dot, wordmark SVGs, favicon, badges, social templates.

Rainbow gradient shimmer is the signature treatment (not opal-only).

Key Commands

# Install design system deps
cd design-system && npm install

# Preview design system docs
open design-system/docs/index.html

Deployment

The site deploys to Cloudflare Pages. The .deploy/ directory is the publish root. The deploy workflow runs on push to main.