Ultracite

JavaScript/TypeScript プロジェクト向けのゼロコンフィグ linting・formatting ツール。Biome（推奨）、ESLint + Prettier、Oxlint + Oxfmt の 3 つの linter バックエンドをサポート。

Ultracite の検出

package.json の devDependencies に ultracite があるかを確認してください。有効な linter は以下で判定します：

• biome.jsonc → Biome
• eslint.config.mjs → ESLint
• oxlint.config.ts → Oxlint

CLI コマンド

# 問題をチェック（読み取り専用）
bunx ultracite check

# 問題を自動修正
bunx ultracite fix

# セットアップの問題を診断
bunx ultracite doctor

# 新規プロジェクトで初期化
bunx ultracite init

bunx は、使用しているパッケージマネージャーに応じて npx、pnpx、yarn dlx に置き換えてください。

check と fix はオプションでファイルパスを指定できます：bunx ultracite check src/index.ts

初期化

bunx ultracite init は対話的なセットアップを実行します。非対話的（CI）な用途では、フラグを渡してください：

bunx ultracite init \
  --pm bun \
  --linter biome \
  --editors universal \
  --agents claude copilot \
  --frameworks react next \
  --integrations husky lint-staged \
  --quiet

フラグ：

• --pm — npm | yarn | pnpm | bun
• --linter — biome（推奨） | eslint | oxlint
• --editors — universal（すべての VS Code ベースエディタ向けに .vscode/settings.json を書き込み） | vscode | zed | cursor | windsurf | antigravity | kiro | trae | void | bob | codebuddy
• --agents — claude | codex | copilot | cline | amp | gemini | cursor-cli など 19 以上
• --frameworks — react | next | solid | vue | svelte | qwik | remix | angular | astro | nestjs
• --integrations — husky | lefthook | lint-staged | pre-commit
• --hooks — サポート対象のエージェント/エディタに対して自動修正フックを有効化
• --type-aware — 型認識 linting を有効化（oxlint のみ）
• --skip-install — 依存関係のインストールをスキップ
• --quiet — プロンプトを非表示（CI=true の場合は自動検出）

Init は Ultracite プリセットを拡張する設定を生成します：

// biome.jsonc
{ "extends": ["ultracite/biome/core", "ultracite/biome/react"] }

フレームワークプリセットは linter ごとに利用可能：core、react、next、solid、vue、svelte、qwik、remix、angular、astro、nestjs

コード標準

Ultracite を使用しているプロジェクトでコードを書く際は、以下の標準に従ってください。完全なルール参照は references/code-standards.md をご覧ください。

主要ルール概要：

Formatting はプロジェクトで設定された linter/formatter によって処理されます。特定の行幅、引用符スタイル、末尾カンマポリシーを強制するのではなく、リポジトリの既存の formatter 設定を尊重してください。

型安全性： 明確さが向上する場合は明示的な型を使用してください。any より unknown を推奨します。不変値には as const を使用し、大雑把なアサーションよりも型絞り込みに依存してください。

最新の JavaScript/TypeScript： const、分割代入、オプショナルチェーン、Null 合体演算子、テンプレートリテラル、for...of、簡潔なアロー関数を推奨します。

非同期と正確性： 非同期関数内の Promise には常に await を使用してください。Promise チェーンより async/await を推奨します。本番環境コードから console.log、debugger、alert を削除してください。

React とアクセシビリティ： 関数コンポーネントを使用し、フック依存関係を正しく保ってトップレベルに配置し、ネストされたコンポーネント定義を避け、適切なラベル、見出し、代替テキスト、キーボード操作に対応したセマンティック HTML を使用してください。

組織、セキュリティ、パフォーマンス、テスト： 関数に焦点を当てる、早期の return を推奨、dangerouslySetInnerHTML と eval() を避ける、特定のインポートとトップレベルの正規表現を推奨、テストから .only と .skip をなくしてください。

トラブルシューティング

bunx ultracite doctor を実行して診断してください。以下をチェックします：

1. Linter インストール（biome/eslint/oxlint バイナリが利用可能か）
2. 設定の妥当性（ultracite プリセットを正しく拡張しているか）
3. package.json 依存関係に Ultracite があるか
4. 競合するツール（古い .eslintrc.*、.prettierrc.* ファイル）

一般的な修正方法：

• 競合する設定： Ultracite への移行後、古い .eslintrc.* と .prettierrc.* ファイルを削除
• 依存関係がない： bunx ultracite init を再度実行するか、devDependencies に手動で ultracite を追加
• ルールが適用されない： 設定ファイルがフレームワークの正しいプリセットを拡張しているか確認