unocss-shadcn

Overview

Apply a deterministic setup flow for UnoCSS and unocss-preset-shadcn without running automatic installers. Detect monorepo strictly, route component targets by project shape, and enforce shadcn MCP plus manual-mode component creation.

Core Rules

1. Run in semi-automatic mode only: propose commands and file edits, but do not auto-install dependencies.
2. Detect monorepo only when one of these is true:

• pnpm-workspace.yaml exists at repo root.
• Root package.json contains workspaces.

1. Use destination policy:

• Monorepo: packages/shadcn-ui
• Single project: src/components

1. UnoCSS config location policy:

• Monorepo: configure in each apps/<app>/uno.config.* (NOT at repo root or in packages).
• Single project: configure at project root uno.config.*.

1. Default to presetWind4 unless the user explicitly requests a different version (e.g. presetWind3).
2. For monorepo component package dependencies, write shadcn-related runtime items to peerDependencies.
3. Use shadcn MCP before any component usage or creation.
4. Create shadcn components in manual mode only (do not use Tailwind-oriented auto init flow).
5. If shadcn MCP is unavailable, block the component step and return an explicit error.

Workflow

1. Inspect project files:

• package.json
• pnpm-workspace.yaml
• uno.config. or unocss.config.
• components.json if present

1. Decide branch using strict monorepo detection.
2. Update UnoCSS config to include unocss-preset-shadcn in presets.
3. Generate destination-specific instructions from references:

• Monorepo path: references/monorepo.md
• Single-project path: references/single-project.md

1. Enforce shadcn MCP chain and manual creation mode.
2. Verify with references/checklist.md before claiming completion.

Required MCP Chain (shadcn)

Run these in order before component operations:

1. getprojectregistries
2. searchitemsinregistries or listitemsinregistries
3. getitemexamplesfromregistries
4. Optional reference only: getaddcommandforitems

Use MCP outputs as the source of truth for component API, file content, and dependency hints.

References

• references/monorepo.md: monorepo branch instructions and templates
• references/single-project.md: single-project branch instructions and templates
• references/checklist.md: validation checklist and remediation matrix