Upgrade to v7

Ultracite v7 introduces support for multiple linting providers: Biome, ESLint + Prettier + Stylelint, and Oxlint + Oxfmt.

What Changed

Multi-Provider Support

Ultracite now supports three linting toolchains:

• Biome — The modern, all-in-one toolchain (default)
• ESLint + Prettier + Stylelint — The most mature ecosystem
• Oxlint + Oxfmt — The fastest option

Updated Preset Paths

Preset paths now include the provider name to distinguish between linters:

New CLI Flag

The --linter flag allows you to specify which provider to use:

npx ultracite init --linter biome
npx ultracite init --linter eslint
npx ultracite init --linter oxlint

Migration

For Biome Users (Default)

Update your biome.jsonc to use the new preset paths:

{
  // Before (v6)
  "extends": ["ultracite/core", "ultracite/react", "ultracite/next"]

  // After (v7)
  "extends": ["ultracite/biome/core", "ultracite/biome/react", "ultracite/biome/next"]
}

Switching to ESLint

If you'd like to switch to ESLint + Prettier + Stylelint:

npx ultracite init --linter eslint

This will create eslint.config.mjs, prettier.config.mjs, and stylelint.config.mjs files:

import { defineConfig } from "eslint/config";
import core from "ultracite/eslint/core";
import react from "ultracite/eslint/react";
import next from "ultracite/eslint/next";

export default defineConfig([
  {
    extends: [core, react, next],
  },
]);

Switching to Oxlint

If you'd like to switch to the fastest option:

npx ultracite init --linter oxlint

This will create .oxlintrc.json and .oxfmtrc.jsonc files:

{
  "extends": [
    "./node_modules/ultracite/config/oxlint/core/.oxlintrc.json",
    "./node_modules/ultracite/config/oxlint/react/.oxlintrc.json",
    "./node_modules/ultracite/config/oxlint/next/.oxlintrc.json"
  ]
}

Quick Upgrade

For the fastest upgrade path, run:

npx ultracite init

When prompted, select your preferred linting provider. Ultracite will update your configuration files automatically.