# Style Index

Read this file when the user is choosing a style preset (Phase 2).

---

## Core Recommendation Surface (Phase 1)

Use these 4 presets as the default recommendation surface when the user did not explicitly name a style:

- `Swiss Modern`
- `Enterprise Dark`
- `Data Story`
- `Blue Sky`

This is a recommendation surface, not a hard capability boundary.

- If the user explicitly names any current preset, honor that selection.
- Support tier affects default recommendation priority only.
- Current editorial next-shortlist candidate: `Paper & Ink`

Machine-readable source of truth: `references/preset-support-tiers.json`

---

## 22 Presets

| Preset | Vibe | Best For |
|--------|------|----------|
| Bold Signal | Confident, high-impact | Pitch decks, keynotes |
| Electric Studio | Clean, professional | Agency presentations |
| Creative Voltage | Energetic, retro-modern | Creative pitches |
| Dark Botanical | Elegant, sophisticated | Premium brands |
| Blue Sky | Clean, airy, enterprise-ready | SaaS pitches, AI/tech decks |
| Notebook Tabs | Editorial, organized | Reports, reviews |
| Pastel Geometry | Friendly, approachable | Product overviews |
| Split Pastel | Playful, modern | Creative agencies |
| Vintage Editorial | Witty, personality-driven | Personal brands |
| Neon Cyber | Futuristic, techy | Tech startups |
| Terminal Green | Developer-focused | Dev tools, APIs |
| Swiss Modern | Minimal, precise | Corporate, data |
| Paper & Ink | Literary, thoughtful | Storytelling |
| Aurora Mesh | Vibrant, premium SaaS | Product launches, VC pitch |
| Enterprise Dark | Authoritative, data-driven | B2B, investor decks, strategy |
| Glassmorphism | Light, translucent, modern | Consumer tech, brand launches |
| Neo-Brutalism | Bold, uncompromising | Indie dev, creative manifesto |
| Chinese Chan | Still, contemplative | Design philosophy, brand, culture |
| Data Story | Clear, precise, persuasive | Business review, KPI, analytics |
| Modern Newspaper | Punchy, authoritative, editorial | Business reports, thought leadership |
| Neo-Retro Dev Deck | Opinionated, technical, handmade | Dev tool launches, API docs, hackathon |
| Strategy Consulting | Structured, authoritative, insight-driven | Strategy decks, board materials, due diligence |

## Custom Themes

If `themes/` contains subdirectories with `reference.md`, those are custom themes.
Custom themes are first-class presets — they take **priority** over content-type routing and mood-mapping.
The code layer auto-discovers them via directory scan; no manual registration needed.
When a custom theme is selected, read `themes/<name>/reference.md` as the style reference.

**Per-style detail files** (read only the chosen one):
`references/aurora-mesh.md`, `references/chinese-chan.md`, `references/data-story.md`, `references/enterprise-dark.md`, `references/glassmorphism.md`, `references/neo-brutalism.md`, `references/strategy-consulting.md`

Blue Sky uses `references/blue-sky-starter.html` as its reference file.

---

## Support Tier Snapshot

| Tier | Current Presets | Notes |
|------|-----------------|-------|
| Production | Swiss Modern, Enterprise Dark, Data Story, Blue Sky | Phase 1 default recommendation surface |
| Supported | Paper & Ink, Glassmorphism, Chinese Chan, Bold Signal, Aurora Mesh, Terminal Green, Strategy Consulting | Still selectable directly; not first-line defaults |
| Experimental | Electric Studio, Creative Voltage, Dark Botanical, Modern Newspaper, Neon Cyber, Notebook Tabs, Pastel Geometry, Split Pastel, Vintage Editorial, Neo-Brutalism, Neo-Retro Dev Deck | Keep available when explicitly requested |
| Archive Candidate | None yet | Do not archive before usage evidence exists |

---

## Mood → Preset Mapping

Use when the user answers the mood question in Phase 2.

| Mood | Style Options |
|------|---------------|
| Impressed/Confident | Bold Signal, Enterprise Dark, Neo-Brutalism |
| Excited/Energized | Creative Voltage, Neon Cyber, Aurora Mesh |
| Calm/Focused | Paper & Ink, Chinese Chan, Notebook Tabs |
| Inspired/Moved | Dark Botanical, Vintage Editorial, Glassmorphism |
| Clean/Enterprise | Blue Sky, Electric Studio, Enterprise Dark, Strategy Consulting |
| Data-Driven | Data Story, Enterprise Dark, Swiss Modern, Strategy Consulting |
| Playful/Creative | Split Pastel, Pastel Geometry, Neo-Brutalism |
| Developer-Focused | Terminal Green, Neon Cyber, Neo-Retro Dev Deck |
| Editorial/Organized | Paper & Ink, Notebook Tabs, Modern Newspaper |

---

## Effect → Feeling Guide

Use when designing animations and visual treatments for a chosen style.

| Feeling | Techniques |
|---------|-----------|
| Dramatic/Cinematic | Slow fade-ins 1–1.5s, dark backgrounds, full-bleed images, parallax |
| Techy/Futuristic | Neon glow, particle canvas, grid patterns, monospace accents, glitch text |
| Playful/Friendly | Bouncy easing, large rounded corners, pastels, floating/bobbing animations |
| Professional | Subtle 200–300ms animations, clean sans-serif, minimal decoration |
| Calm/Minimal | Very slow motion, high whitespace, muted palette, generous padding, serif type |
| Editorial | Strong typography hierarchy, pull quotes, serif headlines, one accent color |
