# Tokven

> Describe what you're building. Get a complete design system — colors, typography, tokens, and brand rules — in seconds.

Tokven turns a description or a hex color into a production-ready design system with AI-generated brand intent. Used by developers and designers who want coherent UI without starting from scratch every time.

## What it does

Type "a dark crypto trading dashboard" and get back:
- A named brand with personality and philosophy
- A color palette (primary, secondary, background) with WCAG-validated contrast
- Typography pairing with heading and body fonts
- DO and NEVER rules that keep your UI coherent as you build
- Exportable tokens in CSS, Tailwind v4/v3, or DTCG JSON

The brand brief is editable inline. When you're happy with the direction, move to the configure page to fine-tune colors, spacing, border radius, and shadows. Export when ready.

## Entry points

**Web app** — tokven.dev
Describe your project → get a brand brief → refine tokens → export

**Explore / Vibes** — tokven.dev/explore
Browse 28+ curated design systems by mood. Apply any theme directly to your project.

**MCP server** — works in Cursor, Claude Code, Claude Desktop, Windsurf
```
npx tokven-mcp
```
No account or API key needed. Brings your design system into your AI coding context.

## MCP tools

**generate_tokens** — Full token system from a hex color and mood
**get_token_preview** — Preview palette and vibe before committing
**validate_contrast** — WCAG 2.1 + APCA contrast check
**list_moods** — 14 mood presets (dark, warm, brutalist, luxury etc.)
**derive_color** — Lightweight color math and scale derivation

## Token output

Every generated system includes light + dark mode, 31+ WCAG AA contrast checks, semantic color roles, spacing scale, border radius scale, shadow system, and font pairing with personality metadata.

Export formats: CSS variables, Tailwind v4, Tailwind v3, DTCG JSON.

## Who it's for

Developers building with AI coding agents who need a coherent visual foundation — not just a color picker, but a system with rules that survives the build process.