# For Claude: how to use UI Lab

> You are about to build or change a UI. This page is the shortest route from a brief to a good result. Read it fully, then follow the links.

## The loop (do not skip steps)

1. **Brief in five lines**: who and where, mode, the one memorable moment, real content, constraints. If you cannot write them, ask the user one sharp question.
2. **Pick a world** from the router below. If nothing fits, invent one and write its card.
3. **Look at the proof** for that world (a whole site or a pattern). Open it, read its source, run it.
4. **Take apart three outside references**, 5 lines each: idea, technique, palette and type, take, leave. Never copy code, text or assets.
5. **Direction card** (name, metaphor, palette roles, type pair, motion language, signature moment, three refusals), then the swap test.
6. **Vertical slice** of the signature moment first, then build outward.
7. **Verify once, in batch**: fresh load, console clean, every section at 1440 and 375, reduced motion, keyboard. Fix everything, confirm once, stop.
8. **Hand off honestly**: the URL, what you rendered, what you could not test, what is placeholder.

For the common kinds of site (business, app, portfolio, publication, report, shop, event, status page, dashboard), the usual section order is in https://ui-lab-weld.vercel.app/playbook/site-types.md.

Full procedure: https://ui-lab-weld.vercel.app/playbook/00-start-here.md. Bug catalogue to read before verifying: https://ui-lab-weld.vercel.app/playbook/verify.md.

## Router: what the brief smells like, what to build from

| Brief | Mode | World | Proof | The move |
|---|---|---|---|---|
| a physical product, "the object is the star" | Persuade | [1 Product Hero Scroll](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-solar](https://ui-lab-weld.vercel.app/docs/site-solar.md), [move-frame-scrub](https://ui-lab-weld.vercel.app/docs/move-frame-scrub.md) | The object rotates through stages while label, colour and copy change on state boundaries. |
| premium, timeless, boutique, hospitality, fashion | Persuade | [2 Editorial Quiet Luxury](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-mare](https://ui-lab-weld.vercel.app/docs/site-mare.md) | One oversized photograph cropped with intent; a caption set like a museum label. |
| developers, API, agents, infra | Persuade | [3 Technical Dark](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-lattice](https://ui-lab-weld.vercel.app/docs/site-lattice.md), [move-command-demo](https://ui-lab-weld.vercel.app/docs/move-command-demo.md), [move-code-to-preview](https://ui-lab-weld.vercel.app/docs/move-code-to-preview.md) | A live product component as the hero, not a screenshot. One accent, used sparingly. |
| indie, bold, "does not look corporate" | Persuade | [4 Neo-Brutalist Print](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-hotmess](https://ui-lab-weld.vercel.app/docs/site-hotmess.md) | Hard shadows, flat colour and oversized type, applied with discipline. |
| portfolio, studio, "wow", immersive | Experience | [5 Cinematic Immersive](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-abyss](https://ui-lab-weld.vercel.app/docs/site-abyss.md), [move-scroll-tunnel](https://ui-lab-weld.vercel.app/docs/move-scroll-tunnel.md), [move-drive-world](https://ui-lab-weld.vercel.app/docs/move-drive-world.md) | The scroll is a camera. One world, one continuous move. |
| a consumer app, kids, education, friendly wellness, community | Persuade | [6 Soft Playful](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-pip](https://ui-lab-weld.vercel.app/docs/site-pip.md) | A character that reacts to input, big rounded shapes, springy motion, friendly ink instead of black. |
| a report, a data story, an institution, "clarity", numbers | Read | [7 Swiss Grid / Data Poster](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-commute-report](https://ui-lab-weld.vercel.app/docs/site-commute-report.md) | A visible grid, one earned giant statistic, direct chart labels, and a data table for every chart. |
| a local business: bakery, cafe, studio, shop, craft, food | Persuade | [8 Warm Organic](https://ui-lab-weld.vercel.app/playbook/worlds.md) | [site-crumb](https://ui-lab-weld.vercel.app/docs/site-crumb.md) | Hand-drawn shapes on grainy paper, arch crops, and something genuinely useful (live hours, an order form). |
| timetable, schedule, live status, rail, airline | Persuade | [9 Departures Board](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-departures](https://ui-lab-weld.vercel.app/docs/site-departures.md), [niche-split-flap](https://ui-lab-weld.vercel.app/docs/niche-split-flap.md) | A board whose cells cycle forward to a target; a real table sits behind it. |
| archive, specimens, field guide, craft, slow commerce | Persuade | [10 Botanical Plate](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-herbarium](https://ui-lab-weld.vercel.app/docs/site-herbarium.md), [niche-plate-callouts](https://ui-lab-weld.vercel.app/docs/niche-plate-callouts.md) | An illustration driven by one number; handwriting only for annotation. |
| audio, instruments, hardware, "how it sounds" | Persuade | [11 Hi-Fi Deck](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-tape](https://ui-lab-weld.vercel.app/docs/site-tape.md), [niche-vu-deck](https://ui-lab-weld.vercel.app/docs/niche-vu-deck.md) | The product is the page: a working control you can hear or see change. |
| newsletter, journal, essay, finance, long-form | Read | [12 Broadsheet](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-ledger](https://ui-lab-weld.vercel.app/docs/site-ledger.md), [niche-broadsheet](https://ui-lab-weld.vercel.app/docs/niche-broadsheet.md) | Reading is the interface: columns, sidenotes, size control, a table that does not rely on colour. |
| retro, hacker, terminal, fiction | Experience | [13 CRT Terminal / 16 Terminal BBS](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-arcade](https://ui-lab-weld.vercel.app/docs/site-arcade.md), [niche-crt](https://ui-lab-weld.vercel.app/docs/niche-crt.md), [site-pebble](https://ui-lab-weld.vercel.app/docs/site-pebble.md), [niche-terminal-bbs](https://ui-lab-weld.vercel.app/docs/niche-terminal-bbs.md) | Cosmetic effect, but the content stays readable and keyboard-operable. |
| exhibition, collection, heritage, gallery | Experience | [14 Museum Placard](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-salt-road](https://ui-lab-weld.vercel.app/docs/site-salt-road.md), [niche-museum-placard](https://ui-lab-weld.vercel.app/docs/niche-museum-placard.md) | The caption hierarchy, set exactly as a curator would, with a large-print option. |
| seasonal, grow, cook, calendar of when | Persuade | [15 Seed Packet](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [niche-seed-packet](https://ui-lab-weld.vercel.app/docs/niche-seed-packet.md) | The packet opens to a planting-calendar table with real headers. |
| divination, outcomes, game of chance, storytelling | Experience | [17 Tarot](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [niche-tarot](https://ui-lab-weld.vercel.app/docs/niche-tarot.md) | A small deck with meaning on every card; a flip reachable by keyboard. |
| medicine, dose, safety, compliance | Operate | [18 Clinical Label](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [niche-clinical-label](https://ui-lab-weld.vercel.app/docs/niche-clinical-label.md) | Strict hierarchy; warnings carry an icon and a word, never colour alone. |
| typeface, foundry, design system | Persuade | [19 Type Specimen](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-specimen](https://ui-lab-weld.vercel.app/docs/site-specimen.md), [niche-specimen](https://ui-lab-weld.vercel.app/docs/niche-specimen.md) | Drag the axes and watch the real letterforms change. |
| status, forecast, scores, prices, anything checked quickly and often | Operate | [21 Plain Text Sheet](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-plain-forecast](https://ui-lab-weld.vercel.app/docs/site-plain-forecast.md) | Charts drawn with characters, each with a real table beside it; no decoration. |
| engineering, architecture, drawings, calculations, trades | Persuade | [22 Blueprint](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-blueprint](https://ui-lab-weld.vercel.app/docs/site-blueprint.md), [move-drafting-rules](https://ui-lab-weld.vercel.app/docs/move-drafting-rules.md) | A working diagram driven by a real formula, with the limits of the sums stated. |
| order, checkout, booking, tickets, line items and a total | Operate | [23 Thermal Receipt](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-till-roll](https://ui-lab-weld.vercel.app/docs/site-till-roll.md), [shop-cart](https://ui-lab-weld.vercel.app/docs/shop-cart.md) | The receipt is the form: lines, total and barcode update as the order changes. |
| teach, explain, document, onboard, "how does it work" | Read | [24 Explorable Explainer](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-curves](https://ui-lab-weld.vercel.app/docs/site-curves.md), [article-layout](https://ui-lab-weld.vercel.app/docs/article-layout.md) | Each passage sits beside a figure you can move, with the formula or code updating live. |
| maps, depth, terrain, travel, science | Experience | [20 Nautical Chart](https://ui-lab-weld.vercel.app/playbook/niche-worlds.md) | [site-tidewater](https://ui-lab-weld.vercel.app/docs/site-tidewater.md), [niche-nautical-chart](https://ui-lab-weld.vercel.app/docs/niche-nautical-chart.md) | A generated contour field that responds to a control. |

## Toolbox: techniques that rebuild studied sites

- cursor that carries the brand: [move-label-cursor](https://ui-lab-weld.vercel.app/docs/move-label-cursor.md)
- hover that feels liquid: [move-liquid-hover](https://ui-lab-weld.vercel.app/docs/move-liquid-hover.md)
- text that draws or follows the cursor: [move-glyph-trail](https://ui-lab-weld.vercel.app/docs/move-glyph-trail.md)
- a hero with depth and motion: [move-mesh-gradient](https://ui-lab-weld.vercel.app/docs/move-mesh-gradient.md)
- sticky chapters that tell a story: [move-scrollytelling](https://ui-lab-weld.vercel.app/docs/move-scrollytelling.md)
- a number that counts: [move-odometer](https://ui-lab-weld.vercel.app/docs/move-odometer.md)
- a tab pill that slides: [move-morph-tabs](https://ui-lab-weld.vercel.app/docs/move-morph-tabs.md)
- a live command palette demo: [move-command-demo](https://ui-lab-weld.vercel.app/docs/move-command-demo.md)
- a toast stack: [move-toast-stack](https://ui-lab-weld.vercel.app/docs/move-toast-stack.md)
- an image-sequence scrub: [move-frame-scrub](https://ui-lab-weld.vercel.app/docs/move-frame-scrub.md)
- a cover that tears open to reveal content: [move-perforated-reveal](https://ui-lab-weld.vercel.app/docs/move-perforated-reveal.md)
- a drawing that completes as you scroll: [move-drafting-rules](https://ui-lab-weld.vercel.app/docs/move-drafting-rules.md)
- a header that stays readable over any background: [move-difference-nav](https://ui-lab-weld.vercel.app/docs/move-difference-nav.md)
- a sentence that sharpens word by word: [move-focus-words](https://ui-lab-weld.vercel.app/docs/move-focus-words.md)
- an instrument-panel list with status lights: [move-status-modules](https://ui-lab-weld.vercel.app/docs/move-status-modules.md)
- a portfolio index with two layouts: [move-scatter-grid](https://ui-lab-weld.vercel.app/docs/move-scatter-grid.md)
- a branded preloader: [move-counter-wordmark](https://ui-lab-weld.vercel.app/docs/move-counter-wordmark.md)
- a marquee that reacts to scrolling: [move-band-ticker](https://ui-lab-weld.vercel.app/docs/move-band-ticker.md)
- a name lockup with outline type and a script alias: [move-outline-lockup](https://ui-lab-weld.vercel.app/docs/move-outline-lockup.md)
- a project index without cards: [move-contact-sheet](https://ui-lab-weld.vercel.app/docs/move-contact-sheet.md)
- a background that follows the real time of day: [move-sky-gradient](https://ui-lab-weld.vercel.app/docs/move-sky-gradient.md)
- image placeholders that are tiny: [css-blur-up-placeholder](https://ui-lab-weld.vercel.app/docs/css-blur-up-placeholder.md)
- a playful creature that follows the cursor: [move-feed-the-bee](https://ui-lab-weld.vercel.app/docs/move-feed-the-bee.md)
- halftone imagery without image files: [move-halftone-split](https://ui-lab-weld.vercel.app/docs/move-halftone-split.md)
- a headline with one handwritten word: [move-script-accent](https://ui-lab-weld.vercel.app/docs/move-script-accent.md)
- pictures inside a sentence: [move-inline-chips](https://ui-lab-weld.vercel.app/docs/move-inline-chips.md)
- scroll effects without JavaScript: [css-scroll-reveal](https://ui-lab-weld.vercel.app/docs/css-scroll-reveal.md)
- menus and tooltips without a positioning library: [css-popover-starting](https://ui-lab-weld.vercel.app/docs/css-popover-starting.md)

The full set is the "Signature moves" category in https://ui-lab-weld.vercel.app/llms.txt; the teardown of each studied site is in https://ui-lab-weld.vercel.app/references.md.

## Everyday parts (already built to the accessibility baseline)

- a header with a mobile menu: [site-nav](https://ui-lab-weld.vercel.app/docs/site-nav.md)
- a FAQ: [faq-section](https://ui-lab-weld.vercel.app/docs/faq-section.md)
- cookie consent: [cookie-banner](https://ui-lab-weld.vercel.app/docs/cookie-banner.md)
- an email sign-up: [newsletter-form](https://ui-lab-weld.vercel.app/docs/newsletter-form.md)
- a table people can sort and filter: [data-table](https://ui-lab-weld.vercel.app/docs/data-table.md)
- a blog or docs article: [article-layout](https://ui-lab-weld.vercel.app/docs/article-layout.md)
- a shop and basket: [shop-cart](https://ui-lab-weld.vercel.app/docs/shop-cart.md)
- a settings page: [settings-screen](https://ui-lab-weld.vercel.app/docs/settings-screen.md)
- a 404 page: [not-found-page](https://ui-lab-weld.vercel.app/docs/not-found-page.md)
- a pricing section: [pricing-tiers](https://ui-lab-weld.vercel.app/docs/pricing-tiers.md)
- a contact section: [contact-section](https://ui-lab-weld.vercel.app/docs/contact-section.md)
- a login screen: [auth-screen](https://ui-lab-weld.vercel.app/docs/auth-screen.md)
- a sign-up password field: [password-field](https://ui-lab-weld.vercel.app/docs/password-field.md)
- file upload: [file-dropzone](https://ui-lab-weld.vercel.app/docs/file-dropzone.md)
- search with filters: [faceted-search](https://ui-lab-weld.vercel.app/docs/faceted-search.md)
- a first-run checklist: [onboarding-checklist](https://ui-lab-weld.vercel.app/docs/onboarding-checklist.md)
- features without a card grid: [feature-rows](https://ui-lab-weld.vercel.app/docs/feature-rows.md)
- a numbered process: [how-it-works](https://ui-lab-weld.vercel.app/docs/how-it-works.md)
- a plan comparison: [comparison-table](https://ui-lab-weld.vercel.app/docs/comparison-table.md)
- a closing call to action: [cta-band](https://ui-lab-weld.vercel.app/docs/cta-band.md)
- an about or team section: [team-list](https://ui-lab-weld.vercel.app/docs/team-list.md)
- one strong testimonial: [pull-quote](https://ui-lab-weld.vercel.app/docs/pull-quote.md)
- a search box with suggestions: [combobox](https://ui-lab-weld.vercel.app/docs/combobox.md)
- a date field: [date-picker](https://ui-lab-weld.vercel.app/docs/date-picker.md)
- a dropdown of actions: [menu-button](https://ui-lab-weld.vercel.app/docs/menu-button.md)
- page numbers and breadcrumbs: [pagination-breadcrumbs](https://ui-lab-weld.vercel.app/docs/pagination-breadcrumbs.md)
- a carousel that is safe to use: [accessible-carousel](https://ui-lab-weld.vercel.app/docs/accessible-carousel.md)
- error, warning and success messages: [alert-banners](https://ui-lab-weld.vercel.app/docs/alert-banners.md)
- check that colours are readable: [contrast-checker](https://ui-lab-weld.vercel.app/docs/contrast-checker.md)
- type that scales with the screen: [fluid-type](https://ui-lab-weld.vercel.app/docs/fluid-type.md)
- visible keyboard focus: [focus-rings](https://ui-lab-weld.vercel.app/docs/focus-rings.md)
- page structure without media queries: [layout-primitives](https://ui-lab-weld.vercel.app/docs/layout-primitives.md)
- a component that adapts to its container: [container-query-card](https://ui-lab-weld.vercel.app/docs/container-query-card.md)
- a light, dark and system theme switch: [color-scheme-toggle](https://ui-lab-weld.vercel.app/docs/color-scheme-toggle.md)

## Send the brief back when

- No real content. A site with lorem ipsum cannot be designed, only decorated. Ask for the actual words, numbers and images.
- A world that is not earned by the content. A departures board for a bakery fails the swap test; use a general world.
- Two worlds at once. Cross techniques, keep one identity.
- A hero that needs an asset nobody has (a model, a photoshoot). Say so, propose the cheapest honest substitute, and ask.

## Always on

- Fonts self-hosted (Fontsource). No system font as the display voice. Draw icons; no emoji as icons.
- Contrast 4.5:1 for body text, 44px touch targets, `100svh`, no horizontal scroll at 375px, `prefers-reduced-motion` honoured, keyboard reachable with visible focus.
- Animate transform, opacity, clip-path; not layout properties.
- Refuse unless the brief earns them: identical icon-heading-text card grids, hero-metric rows as filler, eyebrow labels, gradient text, decorative glass, identical fade-up on every block.
- Do not reuse a studied site's code, copy or assets.

## Machine-readable

- https://ui-lab-weld.vercel.app/llms.txt (index), https://ui-lab-weld.vercel.app/patterns.json, https://ui-lab-weld.vercel.app/llms-full.txt (everything), https://ui-lab-weld.vercel.app/references.json
- Each pattern: https://ui-lab-weld.vercel.app/docs/<slug>.md. Each whole site includes every file in its folder.
