11ai Design Styleguides
Create quiet, precise interfaces where typography and information structure do the work. Inspect the existing stack first and reuse its tokens, theme wiring, components, and chart library.
Read the references required by the task:
- Foundations for tokens, type, spacing, themes, motion, and accessibility.
- Components and layouts for page density, navigation, catalogs, tables, cards, CTAs, and responsive behavior.
- Data visualization whenever charts, metrics, reports, or analytical interfaces are involved.
Workflow
- Inventory framework, Tailwind/CSS version, shadcn setup, fonts, semantic tokens, theme provider, icons, charts, breakpoints, and existing conventions.
- Classify the page as root/editorial or non-root/analytical. Root pages may breathe; non-root pages use the compact mode without becoming cramped.
- Write a one-sentence design direction using the content's actual purpose.
- Define hierarchy and data density before decoration. Decide what is summary, comparison, control, detail, provenance, and missing state.
- Implement with semantic tokens and existing components. Do not introduce a second design system or raw color palette.
- For data, preserve exact values and provenance, then choose the simplest chart that reveals the relationship.
- Verify light/dark, mobile/desktop, keyboard, reduced motion, zoom, empty and error states, long text, and high-density data.
Non-negotiables
- Use neutral light/dark semantic tokens and one restrained functional accent.
- Use sans for prose/headings and mono for IDs, commands, metadata, and numbers.
- Build hierarchy through scale, weight, spacing, and borders—not gradients, oversized shadows, or card proliferation.
- Prefer thin separators and quiet surfaces; every container must have a job.
- Keep motion short and functional; honor
prefers-reduced-motion. - Keep exact values accessible even when a chart summarizes them.
- Never trade away focus visibility, contrast, keyboard access, or responsive integrity for visual minimalism.
Handoff
Report the applied density mode, tokens/components reused, visualization choices, responsive/accessibility checks, and any deliberate deviations from the guide. Verify the actual rendered interface before declaring completion.