Codeium

Windsurf Color Design System Rules

Export a structured .windsurfrules file with your brand's 46 semantic color tokens, CSS variables, Tailwind mappings, and WCAG accessibility data — optimized for Windsurf.

Windsurf Markdown rules file compatible with Windsurf AI editor
.windsurfrules
Select a color to generate AI skill preview

Setup Guide for Windsurf

Get your AI color rules working in under 2 minutes.

1

Export your skill file

Go to your palette → Export → AI Coding Rules → Generic. Copy or download the markdown.

2

Create .windsurfrules in your project root

Place the file at the root of your project as .windsurfrules. Windsurf loads this as project context.

3

Start with Windsurf Cascade

Use Cascade to generate UI — it will apply your brand tokens, CSS variables, and accessibility rules.

Project Structure
your-project/
├── .windsurfrules     ← AI color rules
├── src/
│   ├── components/
│   └── styles/
├── package.json
└── ...

How Windsurf Uses Color Design System Rules

When you place a .windsurfrules file in your project, Windsurf reads it as part of its context window. This means every code suggestion, component generation, and refactoring task references your exact color tokens instead of guessing.

The exported file includes all 46 semantic color roles (brand, surface, text, status, border), their hex/RGB/HSL values, CSS custom properties, Tailwind class mappings, and WCAG contrast ratios. Windsurf uses this data to:

  • Generate React/Vue/Svelte components with correct color tokens
  • Suggest accessible color pairs that meet WCAG AA/AAA standards
  • Apply consistent theming across light and dark modes
  • Write CSS/Tailwind code using your design system variables
  • Maintain visual consistency across your entire codebase

Export Your Windsurf Color Rules Now

Create your brand palette, then export AI coding rules from the Export tab. Windsurf will produce on-brand code from day one.