# SexyUI > UI component library and design skill for developers and coding agents. Search first, fetch one component, apply the design rules. ## Find a component (public, no key) - GET /api/search?q={words}&format=text -> one line per match: slug | title | category | access. Options: category=, access=free|pro, limit=1-50 (default 10). - GET /api/categories -> category names with counts. - /catalog.json is the full list (large). Prefer /api/search. - /components/{slug} is a human-readable page per component with a preview. /sitemap.xml lists them all. ## Fetch a component - GET /api/components/{slug}?format=md -> source files, dependencies, setup and license as markdown. Smallest response. - GET /api/components/{slug} -> the same as JSON. - GET /api/components/{slug}?fields=meta -> file paths, byte sizes and dependencies only. - Free components need no credentials. Pro needs the header Authorization: Bearer {license key}. - registryDependencies lists primitives the component imports (shadcn/ui names or registry URLs). Install them with: npx shadcn@latest add ## Design skill (public) - /illustrations -> browse editable SVG illustrations and original product scenes with matching UI patterns. - GET /api/search?category=Illustrations&q={product moment}&format=text -> find an illustration, then fetch through the same component API and license gate. - /skill/illustrations.md -> choose a scene, match light/dark, preserve the license, write useful state copy and connect the action to real UI. - /SKILL.md -> density, layout, spacing, sizing, typography, colour, state and polish rules. Read before writing UI. - /skill/sizes.md -> size table for buttons, inputs, badges, cards, navigation, tables, overlays, feedback, forms, page sections. - /skill/color.md -> colour roles, status colours, dark mode, elevation, z-index, interaction states and motion. - /skill/patterns.md -> app shell, page header, toolbars, tables, empty/loading/error states, forms, feedback, dashboards, writing, accessibility. - /skill/review.md -> pre-ship checklist (measured and by hand) and fault-to-fix table. - /skill/audit.js -> run in the browser (or page.evaluate) to measure a page against the rules; returns pass/fail per check. - /skill/tokens.css and /design-tokens.json -> scales, colour roles (light and dark), elevation and motion as CSS variables and JSON. - /design-rules.csv -> the rules as a spreadsheet. ## Rules for agents - Keep the license key in the SEXYUI_KEY environment variable. Never put it in a URL, a file or output. - Fetch a component only when it is relevant to the task. Keep the license notice with redistributed source. - 401: ask the user for authorized access. 403: the key was not accepted. 429: wait 60 seconds. 503: retry later.