Skip to content
Oxlint Config Setup
CtrlK

Getting Started

Install the tested Oxlint trio, select a prebuilt policy, and run one native lint command.

Oxlint Config Setup ships complete configurations that combine native Oxlint rules with type-aware TypeScript checks by default. The normal path is one loader, one configuration object, and one Oxlint command; syntax-only linting is a separate, explicit choice.

Beta status: v0.1.0 is the current published release. It is a reviewed beta, not a stable or mature release.

Prerequisites

  • Node.js 24.11.0 or later
  • a discoverable tsconfig.json for the standard type-aware configurations
  • pnpm, npm, or another package manager that respects peer dependencies

Install the tested trio

Keep the preset, Oxlint, and the native type-aware backend on the versions verified together:

pnpm add -D oxlint-config-setup oxlint@1.78.0 oxlint-tsgolint@7.0.2001

Create oxlint.config.ts

Recommended is the default. Add only the project contexts you use:

import { getOxlintConfig } from "oxlint-config-setup";

export default getOxlintConfig({
  react: true,
  node: true,
});

Use an explicit level when the default is not the right adoption target:

export default getOxlintConfig({
  level: "essential",
  react: true,
  ai: true,
});

The loader selects one of 24 complete core artifacts, then adds package-owned Testing Library, Playwright, and Storybook overrides from their official flat presets.

Run Oxlint directly

pnpm oxlint .

Add the same command to package.json and CI. Oxlint remains the only lint process; the TypeScript loader resolves package-owned Testing Library and Playwright compatibility plugins for their canonical files.

Choose your next guide