ultracite

library7.8.1jsnpmunverified

Ultracite v7.8.1 is a zero-configuration preset for Biome, ESLint, and Oxlint that provides hundreds of preconfigured linting and formatting rules for modern JavaScript/TypeScript projects. It runs via interactive CLI (`npx ultracite init`) and supports monorepos, AI agent integration (Claude Code, Copilot, Cursor, Gemini), and framework-aware rules. Requires peer dependencies oxfmt >=0.1.0 and oxlint ^1.0.0. Compared to alternatives like `eslint-config-prettier`, Ultracite is AI-ready and ships with a `doctor` command for diagnostics.

devops testing

npm install ultracite

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ULTRACITE

ultracite

devopsjavascriptv7.8.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ npx ultracite init

✗ npm install -g ultracite && ultracite init

Use npx to run the CLI without global install.

initCommand

✓ import { init } from 'ultracite'

✗ const init = require('ultracite').init

Package is ESM-only; use dynamic import if needed from CJS.

configType

✓ import type { Config } from 'ultracite'

✗ import { Config } from 'ultracite'

Config is a TypeScript type, not a runtime value.

Initializes Ultracite with Biome linter, npm, VS Code editor, Claude Code agent, React framework, and type-aware linting.

npx ultracite init --linter biome --pm npm --editors vscode --agents claude --frameworks react --type-aware

Debug

Known issues

breakingPrior to v7, the `ultracite` package included its own ESLint config. In v7, all ESLint configuration has been removed and replaced with Biome/Oxlint tooling.

fix

Run `npx ultracite init` to regenerate configuration for the new toolchain.

affects: <7.0.0

deprecatedThe `--skip-install` flag in v7.0.0 had a bug that caused dependency installation to still run. Fixed in v7.4.0.

fix

Upgrade to v7.4.0 or later.

affects: >=7.0.0 <7.4.0

gotchaWhen using ESLint as the linter, Ultracite installs both Prettier and Stylelint as additional formatters. They may conflict with existing configuration.

fix

Use `--linter biome` or `--linter oxlint` to avoid the Prettier/Stylelint chain.

affects: >=7.0.0

gotchaRunning `ultracite check` without arguments applies to the entire project, which can be slow on large monorepos. Use file or glob arguments to limit scope.

fix

Add specific paths, e.g. `ultracite check src/`.

affects: >=7.0.0

deprecatedThe `--type-aware` flag in v7.0.0 enabled type-aware linting for ESLint only; in v7.5.0 it also affects Oxlint. Behavior may differ between linters.

fix

Upgrade to v7.5.0 or later for consistent type-aware behavior.

affects: >=7.0.0 <7.5.0

gotchaIf you have a `.eslintrc.js` file present, Ultracite init will skip ESLint configuration entirely instead of merging.

fix

Remove existing ESLint config before running init if you want Ultracite to manage it.

affects: >=7.0.0

Errors

Common errors & fixes

ERR_PEER_DEPENDENCY: @biomejs/biome not found

Missing peer dependency when using Biome linter

fix

Run `npx ultracite init` again or install `@biomejs/biome` manually.

Error: No such file or directory, open '/path/to/.ultracite.json'

Ultracite hasn't been initialized in this directory

fix

Run `npx ultracite init` to create the configuration file.

TypeError: ultracite.init is not a function

Attempting to import the default export as a function in CommonJS

fix

Use dynamic import: `const { init } = await import('ultracite')`

Warning: The '--skip-install' flag will not install dependencies, but package.json changes are still written.

User expected --skip-install to also skip modifying package.json

fix

Use --skip-install only to skip `npm install`; package.json is still updated.

Upgrade

Version history

7.8.1latest on npm

Audit

Dependencies

oxfmtoptionalpeer dependency for formatting when using Oxlint

oxlintoptionalpeer dependency for linting when using Oxlint

Agent activity

13 hits · last 30 days

node

Resources

githubhttps://github.com/haydenbleasel/ultracite ↗

packageultracite ↗

homepagehttps://www.ultracite.ai/ ↗