Directory fleet UI
One Next.js app, many directories. You do not install ten separate UI libraries
per site. You change brand/, sometimes directory.config.ts copy, and
occasionally the shared kit in packages/ui when every site should gain a new
variant.
What the template already componentizes
| Surface |
Variants (THEME_VARIANTS) |
Where to preview |
| Header |
bar, masthead, floating, utility |
/design?matrix=1 |
| Hero |
split, centered, editorial, band, aurora |
same |
| Listing card |
row, tile, ledger |
same |
| Footer |
columns, minimal, inverse |
same |
| Button shape |
rounded, pill, square |
preset theme.variants.button |
Eight legacy presets (broadsheet, civic, …) use definePreset(id, { seed, variants }). Better Design kits (30 themes: apple, linear, stripe,
…) use defineBetterDesign(id, { seed, variants }) — see
better-design. Preview at /design?kit=better.
Per site: brand/theme.ts picks one path. private-repo-38ca uses apple + steel
blue seed #0e5f8e.
Stop rule: if the change is niche-specific copy or color, it stays in
brand/ or config. If it is a new layout primitive every directory needs,
add a variant in @directory/ui/directory and register it in
packages/directory/src/theme.ts.
Map: the ten “elite UI” repos → this template
Use these for ideas and review, not as npm installs on every site.
| Repo |
What it is |
Use on directories |
| superdesign / superdesign-skill |
Prompt → many mockups on a canvas |
Explore 3+ hero/card directions before coding; screenshot winners; implement as a new THEME_VARIANTS entry, not a one-off page in apps/web |
| better-design |
MCP: tokens, shadcn overrides, WCAG review |
Run get-ui-principle + get-review-rules on /design screenshots and listing pages; translate fixes into preset tokens and brand:check, not a second CSS framework |
| design-taste |
Taste / anti-slop prompts |
Voice and hierarchy checks on hero intro + FAQ; pair with brand-router for OG/social |
| canvas-ui |
Canvas-driven decorative UI |
Avoid on listing directories (SEO, a11y, Workers bundle). Borrow only static patterns (grids, badges) as CSS in the kit |
| paper-shaders |
WebGL/Shader backgrounds |
Do not ship WebGL on every city page. Optional: CSS-only mesh like hero aurora in globals.css |
| ui-layouts |
Layout recipes |
New hero/footer variants when a pattern repeats across niches; add to variant matrix + E2E design spec |
| Hyperiux |
Immersive / 3D marketing |
Not for reference-desk directories (MRI prices, permits). Playground/nightlife presets only if owner insists |
| motion-primitives |
Motion + React snippets |
Add "use client" wrappers only for chrome (header reveal, stagger). Listing HTML must render without JS |
| cursify |
Cursor effects |
Skip for directories (accessibility, distraction) |
| trickle |
Component kit |
Treat like better-design: steal spacing/hierarchy ideas, implement inside @directory/ui |
Fleet brand + UI pass (one site)
bun run site:use <site> in the multi-site directory monorepo.
- Open
/design and /design?preset=<id>&matrix=1&scheme=dark.
- Pick preset + seed; set
variants if header/hero/card/footer need a non-default combo.
bun run brand:fonts && bun run brand:check.
- Ship
logo.svg, og.png (1200×630), DESIGN.md. Run verify-branding.
- Local data:
bun run db:migrate:local then bun run import <csv> (see site data/).
- Listing photos:
bun run enrich + import:enrichment (not brand).
Reference site for health/clinic UX: private-repo-38ca (clinic + steel blue seed).
When to extend the shared kit
Add a variant when three or more sites need the same pattern. Workflow:
- Implement in
packages/ui/src/directory/<component>.tsx.
- Add enum value to
THEME_VARIANTS in packages/directory/src/theme.ts.
- Show it on
/design matrix and extend apps/web/e2e/design.spec.ts.
- Document in
brand/DESIGN.md template section and this skill.
Sibling skills (install + use together)
Code map (shipped)
See references/toolkit-map.md for file paths. The
template also documents the same table in docs/design-toolkit.md.
| Repo |
Shipped as |
| Superdesign |
/design?matrix=1 exploration |
| Better Design |
elevation tokens, SearchBar glass, floating header blur |
| Design Taste |
copy discipline (no hype adjectives in hero/CTA) |
| Canvas UI |
.pattern-dots on aurora hero |
| Paper Shaders |
aurora hero + CtaBand surface="mesh" |
| UI Layouts |
bento/cards grid layouts, stat cards |
| Hyperiux |
listing tile hover ring |
| Motion Primitives |
stagger-blur / rise-blur CSS |
| Cursify |
skip |
| Trickle |
CtaBand surface="outline" |
Honest status
External repos are not vendored as dependencies. Learnings are variants
and CSS in the shared kit. Full shadcn theme packs belong in Better Design’s
MCP for one-off marketing sites, not in the directory fleet.
1---2name: directory-fleet-ui3description: "Brand and UI pass for multi-site directory fleet sites: pick @directory/ui presets, preview at /design, ship logo/OG/DESIGN.md, and apply elite UI patterns without breaking the one-template rule. Maps external design-agent repos (Superdesign, Better Design, motion kits) to what the template actually supports. Use when upgrading directory landing UX, running a fleet brand pass, or asking whether to install a random shadcn kit."4metadata:5 source: https://skillmd.com/skills/pooriaarab/directory-fleet-ui6---78# Directory fleet UI910One Next.js app, many directories. **You do not install ten separate UI libraries11per site.** You change `brand/`, sometimes `directory.config.ts` copy, and12occasionally the shared kit in `packages/ui` when every site should gain a new13variant.1415## What the template already componentizes1617| Surface | Variants (`THEME_VARIANTS`) | Where to preview |18| --- | --- | --- |19| Header | bar, masthead, floating, utility | `/design?matrix=1` |20| Hero | split, centered, editorial, band, **aurora** | same |21| Listing card | row, tile, ledger | same |22| Footer | columns, minimal, inverse | same |23| Button shape | rounded, pill, square | preset `theme.variants.button` |2425Eight **legacy presets** (`broadsheet`, `civic`, …) use `definePreset(id, {26seed, variants })`. **Better Design kits** (30 themes: apple, linear, stripe,27…) use `defineBetterDesign(id, { seed, variants })` — see28[better-design](../better-design/SKILL.md). Preview at `/design?kit=better`.2930Per site: `brand/theme.ts` picks one path. private-repo-38ca uses **apple** + steel31blue seed `#0e5f8e`.3233**Stop rule:** if the change is niche-specific copy or color, it stays in34`brand/` or config. If it is a new layout primitive every directory needs,35add a variant in `@directory/ui/directory` and register it in36`packages/directory/src/theme.ts`.3738## Map: the ten “elite UI” repos → this template3940Use these for **ideas and review**, not as npm installs on every site.4142| Repo | What it is | Use on directories |43| --- | --- | --- |44| [superdesign](https://github.com/superdesigndev/superdesign) / [superdesign-skill](https://github.com/superdesigndev/superdesign-skill) | Prompt → many mockups on a canvas | Explore 3+ hero/card directions **before** coding; screenshot winners; implement as a new `THEME_VARIANTS` entry, not a one-off page in `apps/web` |45| [better-design](https://github.com/marvkr/better-design) | MCP: tokens, shadcn overrides, WCAG review | Run `get-ui-principle` + `get-review-rules` on `/design` screenshots and listing pages; translate fixes into preset tokens and `brand:check`, not a second CSS framework |46| [design-taste](https://github.com/madebymustafa/design-taste) | Taste / anti-slop prompts | Voice and hierarchy checks on hero intro + FAQ; pair with [brand-router](../brand-router/SKILL.md) for OG/social |47| [canvas-ui](https://github.com/DavidHDev/canvas-ui) | Canvas-driven decorative UI | **Avoid** on listing directories (SEO, a11y, Workers bundle). Borrow only static patterns (grids, badges) as CSS in the kit |48| [paper-shaders](https://github.com/paper-design/shaders) | WebGL/Shader backgrounds | **Do not** ship WebGL on every city page. Optional: CSS-only mesh like hero `aurora` in `globals.css` |49| [ui-layouts](https://github.com/ui-layouts/ui-layouts) | Layout recipes | New hero/footer **variants** when a pattern repeats across niches; add to variant matrix + E2E design spec |50| [Hyperiux](https://github.com/Hyperiux-Immersive/Hyperiux) | Immersive / 3D marketing | Not for reference-desk directories (MRI prices, permits). Playground/nightlife presets only if owner insists |51| [motion-primitives](https://github.com/ibelick/motion-primitives) | Motion + React snippets | Add `"use client"` wrappers only for chrome (header reveal, stagger). Listing HTML must render without JS |52| [cursify](https://github.com/ui-layouts/cursify) | Cursor effects | Skip for directories (accessibility, distraction) |53| [trickle](https://github.com/akaieuan/trickle) | Component kit | Treat like better-design: steal spacing/hierarchy ideas, implement inside `@directory/ui` |5455## Fleet brand + UI pass (one site)56571. `bun run site:use <site>` in the multi-site directory monorepo.582. Open `/design` and `/design?preset=<id>&matrix=1&scheme=dark`.593. Pick preset + seed; set `variants` if header/hero/card/footer need a non-default combo.604. `bun run brand:fonts` && `bun run brand:check`.615. Ship `logo.svg`, `og.png` (1200×630), `DESIGN.md`. Run [verify-branding](../verify-branding/SKILL.md).626. Local data: `bun run db:migrate:local` then `bun run import <csv>` (see site `data/`).637. Listing photos: `bun run enrich` + `import:enrichment` (not brand).6465Reference site for health/clinic UX: **private-repo-38ca** (`clinic` + steel blue seed).6667## When to extend the shared kit6869Add a variant when **three or more** sites need the same pattern. Workflow:70711. Implement in `packages/ui/src/directory/<component>.tsx`.722. Add enum value to `THEME_VARIANTS` in `packages/directory/src/theme.ts`.733. Show it on `/design` matrix and extend `apps/web/e2e/design.spec.ts`.744. Document in `brand/DESIGN.md` template section and this skill.7576## Sibling skills (install + use together)7778| Job | Skill |79| --- | --- |80| Anti-slop typography, corporate-trust | [design-taste](../design-taste/SKILL.md) |81| MCP review, spacing/contrast rules | [better-design](../better-design/SKILL.md) |82| Clone + launch checklist | [build-a-directory](../build-a-directory/SKILL.md) |83| Voice, OG art direction, social registers | [brand-router](../brand-router/SKILL.md) |84| Drift on favicon/OG/header | [verify-branding](../verify-branding/SKILL.md) |85| `.agents/brand.md` in a repo | [design-context](../design-context/SKILL.md) |86| Marketing site scale (not listing chrome) | [marketing-site](../marketing-site/SKILL.md) |8788## Code map (shipped)8990See [references/toolkit-map.md](references/toolkit-map.md) for file paths. The91template also documents the same table in `docs/design-toolkit.md`.9293| Repo | Shipped as |94| --- | --- |95| Superdesign | `/design?matrix=1` exploration |96| Better Design | elevation tokens, `SearchBar` glass, floating header blur |97| Design Taste | copy discipline (no hype adjectives in hero/CTA) |98| Canvas UI | `.pattern-dots` on aurora hero |99| Paper Shaders | aurora hero + `CtaBand surface="mesh"` |100| UI Layouts | bento/cards grid layouts, stat cards |101| Hyperiux | listing tile hover ring |102| Motion Primitives | `stagger-blur` / `rise-blur` CSS |103| Cursify | skip |104| Trickle | `CtaBand surface="outline"` |105106## Honest status107108External repos are **not** vendored as dependencies. Learnings are **variants109and CSS** in the shared kit. Full shadcn theme packs belong in Better Design’s110MCP for one-off marketing sites, not in the directory fleet.