visual-themes
32 curated visual theme packs plus a deep knowledge base on color science, typography, motion, global design culture, and generative aesthetics. Use when building any themed visual artifact (simulatio
SKILL.mdskills/ui-ux/visual-themes/SKILL.md
GitHubVisual Themes
32 production-grade visual themes + a research-backed knowledge base on color science, typography, motion, texture, global design culture, and generative aesthetics. Each theme is a complete design system: palette, typography, texture, animation philosophy, UI components, and implementation guidance.
Routing
Each theme lives in its own file under references/themes/. Knowledge base articles live under references/knowledge-base/. Read only the files needed for the current task — never load everything.
Theme Files
| Resource | Path |
|---|---|
| Theme files | references/themes/NN-theme-name.md |
| Animation patterns | references/animation-patterns.md |
Knowledge Base
Load these when making design decisions or answering design questions — not for every themed artifact.
| Topic | Path | When to load |
|---|---|---|
| Color science & perception | references/knowledge-base/01-color-science.md |
Palette construction, contrast decisions, wide-gamut, OKLCH |
| Typography & tokens | references/knowledge-base/02-typography-tokens.md |
Font selection, type scale, design token architecture |
| Motion, texture & materiality | references/knowledge-base/03-motion-texture.md |
Animation philosophy, easing, texture techniques, glass/noise |
| Global aesthetics & culture | references/knowledge-base/04-global-aesthetics.md |
Non-Western design, cultural sensitivity, trend context |
| Generative & data viz | references/knowledge-base/05-generative-dataviz.md |
Generative art principles, data color, chart theming |
| Quick-reference checklists | references/knowledge-base/06-checklists.md |
Pre-flight checks for palette, type, tokens, motion, a11y |
| Bibliography | references/knowledge-base/07-bibliography.md |
Source URLs, further reading |
| Theme generation schema | references/knowledge-base/theme-schema.md |
JSON schema for AI-assisted theme creation |
Cross-Skill References
| Resource | Location |
|---|---|
| Font pairings | design-maestro references/themes.md |
| Advanced CSS/WebGL effects | design-maestro references/advanced-effects.md |
| Anti-slop checklist | design-maestro references/aesthetic-principles.md |
| Motion library | design-maestro references/motion-library.md |
Feedback Loop
FEEDBACK.md lives at the skill root. Read it at the start of every task that uses this skill.
Cycle:
- Detect — After delivering a themed artifact, watch for user corrections, preferences, or complaints about any theme element (colors, animations, styling, component look, performance).
- Search — Check
FEEDBACK.mdfor prior entries on the same theme or issue category. - Scope — Determine if the feedback is theme-specific (e.g., "Kintsugi Ledger gold is too bright") or cross-cutting (e.g., "animations are too slow on all themes").
- Draft & Ask — Draft a FEEDBACK.md entry with category tag and theme tag. Confirm with the user before writing.
- Write on Approval — Append the entry to FEEDBACK.md using the tagged format.
- Compact at 75 — When entries reach 75, consolidate: merge duplicates, promote recurring feedback into the relevant theme file as a permanent rule, and reset the log.
Theme Catalog
Read the descriptions below to select the right theme. Load 1–3 theme files as needed.
Pack 1: Original Collection (Themes 1–15)
1. Alchemist's Journal
File: references/themes/01-alchemists-journal.md
Best for: Reaction-diffusion, Physarum (slime mold), organic growth, L-systems, erosion
Vibe: Da Vinci notebook — living ink bleeding into ancient parchment.
Palette feel: Warm cream canvas, deep charcoal ink, antique gold accents, oxidized copper trails
Animation style: Slow, viscous, ink-like. Things flow and bleed, never snap.
Typography: Serif-heavy (EB Garamond, Libre Caslon). Alchemical manuscript energy.
Key techniques: SVG feTurbulence paper grain, multiply blend for overlapping ink, stroke-dashoffset quill animations
2. Ethereal Porcelain
File: references/themes/02-ethereal-porcelain.md
Best for: Fluid dynamics (smoke/fire), Mandelbulb fractals, ray marching, volumetric rendering
Vibe: Museum gallery — chaotic forces sculpted into slow-moving porcelain. Kintsugi gold repairs the cracks.
Palette feel: Neutral slate gallery wall, porcelain white sculpture, gold in chaos regions, cool grey shadows
Animation style: Slow, heavy, majestic. 0.5x physics. Marble-pour entries, breathing gold glow.
Typography: High-contrast editorial (DM Serif Display + Work Sans light). Gallery-label precision.
Key techniques: Subsurface scattering look, kintsugi gold on high-vorticity, simulated studio lighting
3. Anthropic Serenity
File: references/themes/03-anthropic-serenity.md
Best for: Strange attractors, particle systems, flow fields, generative patterns, mathematical viz
Vibe: High-end editorial warmth — intellectual calm, matte watercolor, thoughtful negative space.
Palette feel: Warm beige canvas, burnt sienna → soft coral gradient, muted forest for density
Animation style: Gentle springs, editorial stagger, watercolor bleed. Deliberate and slow.
Typography: Modern professional (Plus Jakarta Sans + DM Sans + Geist Mono). Clean, warm.
Key techniques: Matte particles with alpha blending, density-based color mapping, 0.5x speed
4. Opalescent Daydream
File: references/themes/04-opalescent-daydream.md
Best for: N-body gravity, orbital mechanics, wave interference, electromagnetic fields
Vibe: Holographic foil — prismatic, airy, soap-bubble iridescence on clean white canvas.
Palette feel: Ghost white/lavender background, holographic cyan→magenta→yellow shifting by velocity
Animation style: Elastic springs (bubble-like overshoot), prismatic scatter, bokeh pulse. Weightless.
Typography: Futuristic (Sora + Manrope + Space Mono). Light, geometric.
Key techniques: HSL gradient by velocity, chromatic aberration, soft bokeh, additive blending (screen)
5. Gouache & Clay
File: references/themes/05-gouache-and-clay.md
Best for: Voronoi, Delaunay, terrain generation, map visualizations, geometric patterns
Vibe: Cut-paper editorial illustration — matte acrylic, zero digital gloss, hand-cut imperfection.
Palette feel: Strong matte backgrounds (terracotta or sage), eggshell white, deep blue-black, vibrant ochre
Animation style: Snappy overshoot (paper snapping into place), stamp-press, hard-shadow lifts.
Typography: Quirky editorial (Bricolage Grotesque + Figtree + Fira Code). Woodblock energy.
Key techniques: Hard directional drop shadows, rough SVG edges, flat fills, stacked-paper 2.5D
6. Liquid Glass
File: references/themes/06-liquid-glass.md
Best for: Modern UI artifacts, settings panels, interactive tools, app mockups, control dashboards
Vibe: iOS 26 / Apple design language — frosted translucency, layered depth, refraction.
Palette feel: Ultra-light grey base, frosted white glass panels, system blue accents
Animation style: Apple springs, glass-slide entries, blur-focus modals, parallax depth.
Typography: System-clean (SF Pro fallback to Plus Jakarta Sans + DM Sans + Geist Mono).
Key techniques: backdrop-filter: blur(20px) saturate(1.8), layered translucency, refraction edges
7. Midnight Observatory
File: references/themes/07-midnight-observatory.md
Best for: Data visualizations, star maps, scientific dashboards, time-series, network graphs
Vibe: Deep space cartography — celestial precision, warm gold constellations on infinite navy.
Palette feel: Deep navy void, warm gold data points, muted teal connections, dusty rose accents
Animation style: Gravitational ease-out, orbital arcs, star-appear glow bloom, constellation lines.
Typography: Dashboard precision (Instrument Sans + Albert Sans + JetBrains Mono).
Key techniques: Star-field backgrounds, golden-ratio layout, constellation-style data connections
8. Brutalist Concrete
File: references/themes/08-brutalist-concrete.md
Best for: Data-heavy dashboards, developer tools, technical simulations, CLI viz, system monitors
Vibe: Tadao Ando meets Swiss typography — raw, exposed, honest. Zero decoration.
Palette feel: Raw concrete greys, near-black text, ONE structural red accent. 95% monochrome.
Animation style: Mechanical and instant. Hard cuts, typewriter reveals, scan-line sweeps. Linear easing.
Typography: Monochrome type (Space Grotesk + JetBrains Mono). Maximum two faces.
Key techniques: Exposed grid, zero border-radius, 2px structural borders, concrete feTurbulence
9. Bioluminescent Deep
File: references/themes/09-bioluminescent-deep.md
Best for: Particle systems, network viz, flow simulations, audio visualizers, neural networks
Vibe: Abyssal ocean — pure darkness punctuated by living, breathing light.
Palette feel: Near-black abyss, electric cyan primary, magenta pulse, deep violet, plankton green
Animation style: Slow organic springs, bioluminescent pulse, signal trace, depth-emerge fades.
Typography: Deep-tech (Sora + Manrope + Fira Code). Clean on dark.
Key techniques: Layered glow rendering, additive blending ('lighter'), vignette, filament connections
10. Vapor Silk
File: references/themes/10-vapor-silk.md
Best for: Music visualizers, relaxation apps, ambient simulations, creative tools, meditation
Vibe: Silk scarves in slow motion — dreamlike pastels, flowing mesh gradients, zero hard edges.
Palette feel: Warm cream base, soft lavender, blush pink, pale mint, dusty mauve. All pastel.
Animation style: Ultra-smooth and long (800ms–1.5s). Silk wave backgrounds, mist-fade reveals.
Typography: Warm approachable (Outfit + Figtree + Space Mono). Friendly, rounded.
Key techniques: Animated mesh gradient (20–30s cycle), generous radius, semi-transparent layering
11. Solarpunk Brass
File: references/themes/11-solarpunk-brass.md
Best for: Sustainability dashboards, growth simulations, ecosystem models, botanical art
Vibe: Organic technology — botanical circuits fused with polished brass instruments.
Palette feel: Warm sunlit linen, forest green growth, polished brass, warm wood, spring patina
Animation style: Dual motion — organic grows/unfurls, mechanical rotates/clicks. Two languages.
Typography: Organic elegance (Fraunces "wonky" + DM Sans + IBM Plex Mono).
Key techniques: Organic + geometric hybrid, brass metallic UI, vine-growth SVG, leaf-vein backgrounds
12. Neon Noir
File: references/themes/12-neon-noir.md
Best for: Real-time data, monitoring dashboards, game UIs, night-mode, security viz
Vibe: Restrained cyberpunk — Blade Runner 2049 color discipline. 90% mono, 10% electric neon.
Palette feel: Charcoal black, smoke panels, hot pink primary neon, electric blue secondary
Animation style: Fast and precise. Neon flicker on entry, glitch on error, pulse beacon for alerts.
Typography: Techy geometric (Space Grotesk + DM Sans + Fira Code with ligatures).
Key techniques: Selective color (neon ONLY on active), scan-line texture, glow only on hover/active
13. Paper Cut
File: references/themes/13-paper-cut.md
Best for: Infographics, educational simulations, storytelling, terrain/map viz, explainers
Vibe: Physical craft digitized — construction paper layers, parallax shadows, pop-up book depth.
Palette feel: Kraft paper base, deep indigo + coral red + sage green layers, cream, mustard
Animation style: Physical and tactile. Layer-slide parallax, paper-fold transitions, stamp-press.
Typography: Crafty editorial (Bricolage Grotesque + Work Sans + Fira Code).
Key techniques: Multi-layer parallax with colored hard shadows, cut-edge SVG paths, 3D fold/unfold
14. Crystalline Matrix
File: references/themes/14-crystalline-matrix.md
Best for: Fractal explorers, geometric simulations, Voronoi/Delaunay, molecular viz
Vibe: Diamond facets — prismatic light splitting through geometric precision. Math made visible.
Palette feel: Cool crystal white, prismatic rainbow at facet edges, platinum structure, graphite depth
Animation style: Geometric and symmetric. Facet rotation (slow), light-catch sparkle, crystal growth.
Typography: Precision minimalism (Instrument Sans + Albert Sans + Geist Mono).
Key techniques: Faceted low-poly rendering, prismatic conic-gradient, wireframe overlay, shard-scatter
15. Warm Darkroom
File: references/themes/15-warm-darkroom.md
Best for: Photo galleries, documentary viz, timeline/history artifacts, atmospheric sims
Vibe: Analog photography — chemical developing, film grain, sepia warmth, intimate darkness.
Palette feel: Warm black, subdued safe-light red, sepia primary, paper white text, chemical blue
Animation style: Chemical reveal — elements develop from darkness (opacity layers, 2–3s). Film grain breathes.
Typography: Photographic editorial (DM Serif Display + Spectral + IBM Plex Mono).
Key techniques: Constant film grain overlay, vignette gradient, photo-develop reveal, dodge-and-burn hover
Pack 2: Research-Informed Collection (Themes 16–30)
16. Ionized Parchment
File: references/themes/16-ionized-parchment.md
Best for: Research tools, reading-heavy dashboards, knowledge bases, documentation, writing apps
Vibe: High-end longform publication that doubles as an app — editorial clarity on warm "paper."
Palette feel: Warm ivory canvas, deep navy ink, oxidized copper accents, slate blue links
Animation style: Invisible. Fades and slides for navigation continuity, nothing theatrical.
Typography: Text-first serif (Newsreader + Source Serif 4 + JetBrains Mono). Bookish authority.
Key techniques: Subtle paper grain, letterpress text-shadow, hierarchy through weight/spacing only
17. Ceramic Glaze UI
File: references/themes/17-ceramic-glaze-ui.md
Best for: Wellness apps, creative tools, simulation UIs, calm productivity, habit trackers
Vibe: Soft ceramic surfaces with a controlled glaze highlight — calm but tactile.
Palette feel: Bisque clay canvas, cobalt glaze accent, celadon secondary, warm taupe neutrals
Animation style: Viscous spring with slight overshoot. Tactile, weighted. Elements settle.
Typography: Rounded humanist (DM Sans + Figtree + Geist Mono). Smooth, friendly.
Key techniques: Matte fills, optional reaction-diffusion shader for empty states, rounded everything
18. Voltage Monochrome
File: references/themes/18-voltage-monochrome.md
Best for: Developer tools, ops dashboards, dense tables, IDE-like interfaces, terminal UIs
Vibe: High-structure monochrome with one "voltage" accent as a spotlight. Hierarchy and focus.
Palette feel: Near white/near black, tight grey ladder, single electric cyan accent used sparingly
Animation style: Snappy micro-interactions, no ambient motion. Mechanical precision.
Typography: Single family (Inter) + mono (JetBrains Mono). Zero pairing friction.
Key techniques: One-accent-only rule, visible grid, zero decoration, density-first spacing
19. Sunlit Concrete
File: references/themes/19-sunlit-concrete.md
Best for: Industrial dashboards, IoT monitoring, logistics, manufacturing UIs, fleet ops
Vibe: Industrial daylight — concrete, steel, safety labels. Physical control room made modern.
Palette feel: Daylight concrete grey, OSHA orange warnings, steel blue links, large metric readouts
Animation style: Mechanical easing, sharp starts/stops. Like pneumatic actuators.
Typography: Condensed industrial (Barlow Condensed + Barlow + IBM Plex Mono). Big numbers.
Key techniques: Concrete noise texture, hard directional shadows, safety color semantics, large KPIs
20. Kintsugi Ledger
File: references/themes/20-kintsugi-ledger.md
Best for: Meditation apps, journaling, narrative games, boutique commerce, personal dashboards
Vibe: Japanese ledger paper meets gold-repaired seams — calm surfaces, deliberate "repair lines."
Palette feel: Washi paper neutrals, sumi ink text, urushi gold accents (very limited), indigo links
Animation style: Ink spreading, contemplative fades. Opacity changes over position changes.
Typography: CJK-friendly (Shippori Mincho + Noto Sans JP + IBM Plex Mono). Calligraphic display.
Key techniques: Paper fiber texture, gold crack-line dividers, ledger grid lines, extreme negative space
21. Mashrabiya Matrix
File: references/themes/21-mashrabiya-matrix.md
Best for: Cultural institutions, educational simulations, data storytelling, museum interactives
Vibe: Islamic geometric lattice as systematic grid language — patterns inform layout.
Palette feel: Sand ivory, deep indigo text, turquoise tile interactive, lapis gold highlights
Animation style: Symmetric and unfolding. Elements expand from center, open like a lattice.
Typography: RTL-ready (Playfair Display + IBM Plex Sans Arabic + IBM Plex Mono).
Key techniques: SVG tiling patterns, bilateral symmetry layouts, RTL-first, ornament-as-structure
22. Monsoon Bazaar Modern
File: references/themes/22-monsoon-bazaar-modern.md
Best for: Music/event apps, playful consumer products, creative coding, festival UIs, food delivery
Vibe: South Asian poster energy made systematic — saturated inks, bold labels, halftone textures.
Palette feel: Raw cotton base, hot magenta/deep indigo/saffron in defined zones
Animation style: Kinetic typography, stamp-press entries, registration jitter. "Controlled loud."
Typography: Bold editorial (Bricolage Grotesque + DM Sans + Fira Code). Poster energy.
Key techniques: Halftone grain overlay, ink edge roughness, registration offset shadows, saturated zones
23. Future Medieval Interface
File: references/themes/23-future-medieval-interface.md
Best for: Games, narrative experiences, interactive fiction, RPG character sheets, art pieces
Vibe: Arcane-modern — illuminated manuscript logic with modern UI constraints.
Palette feel: Dark vellum base, bone white text, gilded gold accents, oxblood highlights, verdigris links
Animation style: Ceremonial and slow. Elements are unveiled, not thrown. Ritual pace.
Typography: Blackletter display (Cinzel Decorative, sparingly) + readable body (Crimson Pro + Fira Code).
Key techniques: Vellum grain, illuminated gold borders, ink-bleed text-shadow, ornament as punctuation
24. Chromed Bloom (Y3K Soft Metal)
File: references/themes/24-chromed-bloom.md
Best for: Consumer tech, product marketing, interactive demos, portfolio showcases, launch pages
Vibe: Futuristic chrome tempered with warmth — soft metal, iridescent edges, controlled gloss. Not cyberpunk.
Palette feel: Soft silver base, iridescent violet primary, rose chrome secondary, brushed metal surfaces
Animation style: Magnetic spring motion. Elements glide, attracted to position. Slight overshoot.
Typography: Geometric futuristic (Sora + DM Sans + Space Mono).
Key techniques: Soft metal gradients, iridescent border sweeps (conic-gradient), specular highlights, no neon
25. Botanical Blueprint
File: references/themes/25-botanical-blueprint.md
Best for: Education, scientific dashboards, simulations, biology tools, environmental data
Vibe: Scientific illustration meets botanical field notes — grids, annotations, gentle greens.
Palette feel: Cool field paper, leaf green accents, sepia wash annotations, blueprint blue for diagrams
Animation style: Diagrammatic. Elements slide along grid axes. Transitions explain relationships.
Typography: Scientific precision (Albert Sans + Instrument Sans + JetBrains Mono). Data-clear.
Key techniques: Blueprint grid background, watercolor washes, annotation leader-line draw, ink + wash separation
26. Night Aquarium
File: references/themes/26-night-aquarium.md
Best for: Media players, ambient data art, night-mode creative tools, audio visualizers, relaxation
Vibe: Deep ocean calm with bioluminescent cues — dark teal depths, soft glow highlights.
Palette feel: Abyssal teal base, bioluminescent cyan accents, jellyfish pink secondary, plankton green ambient
Animation style: Organic and drifting. Slow springs, elements float and settle. Underwater physics.
Typography: Clean on dark (Manrope + Sora + Fira Code). Futuristic, readable.
Key techniques: Depth layering, organic glow box-shadows, optional WebGL caustics, no hard edges
27. Cartographer's Desk
File: references/themes/27-cartographers-desk.md
Best for: Maps, dashboards, investigative journalism, geospatial tools, climate data, urban planning
Vibe: Map-room pragmatism — contour lines, layered paper, precise labeling.
Palette feel: Chart paper base, meridian blue water, terrain ochre land, forest green, contour brown
Animation style: Spatial continuity. Pan, zoom, parallax between layers. Everything has 2D position.
Typography: Dashboard (Instrument Sans + Albert Sans + JetBrains Mono). Small-size legibility.
Key techniques: Procedural contour SVGs, paper stacking with directional shadow, legend-style small-caps labels
28. Signal & Noise Lab
File: references/themes/28-signal-noise-lab.md
Best for: Lab dashboards, simulation UIs, analytics, signal processing, ML experiment trackers
Vibe: Research lab aesthetic — clean surfaces, instrument-like components, measured noise textures.
Palette feel: Lab white base, oscilloscope blue + spectrum orange dual-channel data, calibrated green
Animation style: Instrumental. Transitions show causality (slider → readout), not decoration.
Typography: Technical (Space Grotesk + DM Sans + JetBrains Mono). Readout-focused.
Key techniques: Instrument panel cards with top-bar, anti-banding noise, dual-channel color, axis-aligned grid
29. Riso Playbook
File: references/themes/29-riso-playbook.md
Best for: Creative tools, portfolios, event microsites, generative art UIs, zine-style content
Vibe: Riso print meets modern UI — limited inks, playful overlays, registration offsets.
Palette feel: Newsprint base, riso blue + red + yellow (3 inks only), overprint purple from multiply blend
Animation style: Stamped and physical. Print registration shift on load, ink stamp entries, rapid stagger.
Typography: Bold quirky (Bricolage Grotesque + Work Sans + Fira Code). Poster meets playbook.
Key techniques: Limited ink rule (3 colors + overprints), halftone texture, registration offset text-shadow, flat fills only
30. Quiet Lattice Dashboard
File: references/themes/30-quiet-lattice-dashboard.md
Best for: Financial dashboards, admin panels, BI tools, SaaS analytics, enterprise software
Vibe: Premium dashboard without low-contrast gimmicks — calm neutrals, micro-structure, disciplined hierarchy.
Palette feel: Warm quiet white, panel grey surfaces, calm blue interactive, semantic-only color use
Animation style: Nearly invisible. Quick fades, value morphs. If you notice the animation, it's too much.
Typography: Refined professional (Plus Jakarta Sans + DM Sans + Geist Mono). Three levels only.
Key techniques: Micro-grid at 8% opacity, zero decoration, strict 3-level hierarchy, semantic colors only for semantics
31. Gazette Pixel
File: references/themes/31-gazette-pixel.md
Best for: Mission control dashboards, multi-agent monitors, DevOps status walls, CI/CD pipelines, real-time telemetry, terminal-adjacent UIs
Vibe: Broadsheet newspaper set in dark concrete with pixel-art instrumentation — editorial authority meets 8-bit telemetry.
Palette feel: Warm charcoal canvas, cream ink, Anthropic sienna accent, per-agent accent system, coral focus text
Animation style: Quantized. Tick-based updates (800ms), steps() easing, pixel-bar growth. Zero physics, zero spring, zero bounce.
Typography: Space Grotesk (headline grotesque, 800 weight, ALL CAPS mastheads) + JetBrains Mono (data teletype). Two families only.
Key techniques: 7×7 pixel icons per agent role, 40-block mosaic status bars with role-specific fill patterns, 3×3 status grids, pixel bar charts (10×6 block grids), square step-block progress, newspaper-column KPI layout, full-card semantic color shift on error/warning
32. TUI Block Grid
File: references/themes/32-tui-block-grid.md
Best for: Mission control dashboards, multi-agent monitors, DevOps status walls, CI/CD pipelines, real-time telemetry, terminal-adjacent UIs, agent orchestration panels
Vibe: Terminal UI meets pixel-art telemetry on Vercel-dark canvas — cool blacks, vivid accent pops, quantized data.
Palette feel: True black page, near-black cards, pure neutral greys, vivid saturated agent accents (emerald, amber, blue, purple)
Animation style: Quantized. Tick-based updates (800ms), steps() easing. Only smooth transition: dark↔light mode toggle at 300ms.
Typography: Inter 600 (headlines, sentence case) + Geist Mono 500–800 (all data/labels). Vercel-native stack.
Key techniques: Vercel-dark aesthetic, full light mode variant with accent darkening, 1.5px borders, zero border-radius, pixel blocks (mosaic bars, 3×3 grids, 10×6 bar charts, step blocks), segmented mode toggle
Per-Theme File Anatomy
Every theme file follows this structure:
- Identity — Name, tagline, best-for use cases
- Color Palette — 6–8 colors with hex, role, and usage guidance
- Typography — Display + body + mono recommendation
- Visual Style — Texture, grain, rendering philosophy, compositing/blend modes
- Animation Philosophy — Easing character, timing, motion personality, physics model
- Signature Animations — 3–5 specific effects native to this theme
- UI Components — Buttons, sliders, cards, tooltips, borders
- Dark Mode Variant — Adjusted palette + rules (or light variant if natively dark)
- Mobile Notes — Performance tips, simplified effects, touch considerations
Knowledge Base Quick Reference
The knowledge base files contain deep, research-backed guidance. Key takeaways:
Color: Build palettes in OKLCH, not HSL. Use chroma bell curves. APCA Lc ≥ 75 for body text. Apply gamut masking for harmony. Validate cultural color semantics.
Typography: Pick fonts by role (text/display/data). Variable fonts with optical sizing. Fluid scales via clamp(). Tabular numerals (tnum) in data. Tighten tracking on large type.
Tokens: Three tiers — primitive → semantic → component. Theme-switch by swapping semantic layer. Include motion/radius/density tokens.
Motion: Define intent classes (feedback/transition/attention/ambient). prefers-reduced-motion as first-class mode. Interruptible animation for app-like feel.
Global: Whitespace ≠ luxury universally. Red ≠ danger universally. Support RTL as first-class. Density toggles for high-info cultures.
Generative: Seeded randomness, probability distributions over uniform random. fBM for organic textures. SDFs for resolution-independent UI. Sequential scales vary luminance; categorical scales vary hue at constant luminance.
Usage Rules
- Themes are starting points. Adapt colors, timing, and effects to fit the specific artifact.
- Always pair with design-maestro. Load
aesthetic-principles.mdfor anti-slop rules. - Accessibility is non-negotiable. WCAG AA contrast, focus indicators, keyboard nav, 44px touch targets.
- prefers-reduced-motion always. Every animation must have a reduced-motion fallback.
- Performance budgets. Follow design-maestro limits. Animate only
transform,opacity,filter. - Theme mixing. Combining elements from two themes is fine if intentional.
- Dark themes on dark canvases. Themes 9, 12, 15, 23, 26, 31, 32 are natively dark — they provide light variants instead of dark mode.
- Knowledge base for decisions. Load knowledge base files when making design choices, not for routine theme application.