---
title: "Build a design system"
method: GET
path: "/api/v1/build-system"
---

# Build a design system

`GET /api/v1/build-system`

## Request

- Base URL: `https://pickshade.com`
- URL: `https://pickshade.com/api/v1/build-system`
- Auth: none declared

Build a full color system from a brand color: 50–950 scales for primary, secondary, accent, neutral and status colors, light and dark theme roles, exported as a Tailwind v4 theme, CSS variables, shadcn/ui globals.css or DTCG tokens, with a contrast audit of text and surface pairs.

## Query parameters

- `primary` string, required: Brand or primary color
- `secondary` string: Any color: #ff5733, rgb(255 87 51), hsl(11 100% 60%), oklch(68% 0.21 34), a CSS or common name like navy, or a Tailwind class like sky-500
- `accent` string: Any color: #ff5733, rgb(255 87 51), hsl(11 100% 60%), oklch(68% 0.21 34), a CSS or common name like navy, or a Tailwind class like sky-500
- `neutral` string: Any color: #ff5733, rgb(255 87 51), hsl(11 100% 60%), oklch(68% 0.21 34), a CSS or common name like navy, or a Tailwind class like sky-500
- `name` string
- `format` 'tailwind' | 'css' | 'shadcn' | 'dtcg'
- `values` 'oklch' | 'hex' | 'rgb' | 'hsl' | 'display-p3'

## Response `200`

Result

## Other responses

- `400`: Invalid input
- `429`: Too many requests. See the Retry-After header

---

[API](https://skmtc.dev/pickshade/apis/pickshade-color-api.md) · [All operations](https://skmtc.dev/pickshade/apis/pickshade-color-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pickshade/apis/pickshade-color-api/revisions/00f0b7c55ea7?raw)