Setup

How to install Ultracite in your project.

Ultracite can be installed with all major package managers. You'll need Node.js v14.18+ (Node 18+ recommended) and a project with a package.json file.

Installation

The easiest way to get started is to run Ultracite's init script, which will install the necessary packages and set up the config file for you. In your project directory, run:

npx ultracite init

You can optionally pass the following flags to the init command:

FlagDescriptionOptions
--pmThe package manager to use.pnpm, bun, yarn, npm
--frameworksThe frameworks to configure.Comma-separated: react, next, solid, vue, qwik, angular, remix, svelte
--editorsThe editors to configure.Comma-separated: vscode, zed
--agentsThe AI agents to configure.Comma-separated: vscode-copilot, cursor, windsurf, zed, claude, codex, kiro, cline, amp, aider, firebase-studio, open-hands, gemini-cli, junie, augmentcode, kilo-code, goose, roo-code, warp
--hooksThe agent hooks to configure.Comma-separated: cursor, claude
--integrationsAdditional integrations to setup.Comma-separated: husky, lefthook, lint-staged
--migrateMigration tools to remove.Comma-separated: eslint, prettier (removes dependencies, config files, and editor settings)
--skip-installSkip installing dependencies.(no value needed)
--quietSuppress interactive prompts and visual output.(no value needed, automatically enabled in CI)

Programmatic Usage

For tools that need to call Ultracite programmatically (like scaffolding CLIs), you can use the --quiet flag to suppress all interactive prompts and visual output:

Terminal
npx ultracite init --quiet --pm npm

The --quiet flag is automatically enabled when the CI environment variable is set to true or 1, making it suitable for CI/CD pipelines:

Terminal
CI=true npx ultracite init --pm npm

In quiet mode, Ultracite will:

  • Skip all interactive prompts
  • Use sensible defaults for all options
  • Suppress ASCII art, spinners, and log messages
  • Only create the core Biome configuration
  • Exit cleanly with code 0 on success or 1 on failure

Extensions

If you’re using Visual Studio Code, install the official Biome extension, which allows on-save formatting/fixing:

Terminal
code --install-extension biomejs.biome

Additionally, if you use Tailwind CSS, it’s recommended to install the Tailwind CSS IntelliSense extension for class sorting and hints:

Terminal
code --install-extension bradlc.vscode-tailwindcss

How is this guide?