/setup

/setup is the one-shot bootstrap command. It front-loads everything acss-kit needs so subsequent commands like /kit-add and /theme-create work without prompting for project conventions every time.

Run it once after installing the plugin in a new (or existing) React + TypeScript project.

Syntax

/setup [--no-theme] [--target=<dir>]

Flags

Flag	Description
`--no-theme`	Skip the starter light/dark theme step. Useful when you already have a theme or plan to run `/theme-create` separately.
`--target=<dir>`	Override the components directory. Defaults to `src/components/fpkit/` (or whatever is recorded in `.acss-target.json`).

What it does

The skill executes eight sequential steps. Every step is idempotent — re-running /setup is safe and never overwrites existing files.

Verify React + TypeScript — Halts if either is missing from dependencies/devDependencies.
Check the React major version — Warns if React 19+ is detected, since ui.tsx may need adjustments.
Detect the package manager — Reads packageManager and lockfiles to choose npm, pnpm, yarn, or bun.
Verify Sass — Halts with copy-paste install instructions if neither sass nor sass-embedded is present.
Set the components target — Prompts for the directory or reuses .acss-target.json if it exists.
Copy ui.tsx — Writes the foundation file from plugin assets to the target.
Seed a starter theme — Generates light.css and dark.css from a hex seed (skipped with --no-theme).
Wire theme imports — Detects the CSS/SCSS entry point and adds idempotent @import statements.

A summary table at the end lists what was created versus what was kept, so you always know which files the command touched.

Examples

Run the standard bootstrap:

/setup

Bootstrap a project that already has its own theme:

/setup --no-theme

Use a non-default components directory:

/setup --target=src/ui/fpkit/

After setup

Once /setup completes, the typical next moves are:

/kit-add button card             # generate your first components
/theme-create "#4f46e5"          # generate a full WCAG-validated theme
/utility-add                     # if acss-utilities is also installed