vinext lint

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/cloudflare/vinext/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

vinext lint

​

How It Works

1. eslint with Next.js config — If you have eslint installed with an existing config (.eslintrc.json, eslint.config.js, etc.), vinext runs eslint .
2. oxlint — If oxlint is installed, vinext uses it (much faster than eslint)
3. eslint fallback — If only eslint is installed without config, runs eslint .
4. No linter — Suggests installation options

​

Options

​

Setup

​

Using eslint (Next.js style)

npm install -D eslint eslint-config-next

{
  "extends": "next/core-web-vitals"
}

​

Using oxlint (faster)

npm install -D oxlint

{
  "rules": {
    "typescript": "error",
    "react": "error"
  }
}

​

Examples

​

Basic usage

vinext lint

vinext lint

Using eslint (with existing config)

✓ No linting errors found

Lint passed.

​

With oxlint

vinext lint

vinext lint

Using oxlint

Lint passed.

​

No linter installed

vinext lint

vinext lint

No linter found. Install eslint or oxlint:

  npm install -D eslint eslint-config-next
  # or
  npm install -D oxlint

​

Linter Detection Priority

1. eslint + config files — .eslintrc.json, .eslintrc.js, .eslintrc.cjs, eslint.config.js, eslint.config.mjs
2. oxlint — Checks for node_modules/.bin/oxlint
3. eslint (no config) — Checks for node_modules/.bin/eslint

​

Integration with CI/CD

​

GitHub Actions

name: Lint
on: [push, pull_request]

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm install
      - run: npm run lint  # or vinext lint

​

package.json script

{
  "scripts": {
    "lint": "vinext lint"
  }
}

​

Configuration

​

eslint-config-next rules

• React Hooks
• Next.js best practices
• Accessibility (jsx-a11y)
• Import organization

​

oxlint configuration

{
  "rules": {
    "typescript": "error",
    "react": "error",
    "jsx-a11y": "warn"
  },
  "deny-warnings": true
}

​

Troubleshooting

{
  "extends": "next/core-web-vitals",
  "ignorePatterns": ["dist/", "node_modules/", ".next/"]
}

{
  "rules": {
    "typescript": "warn",
    "react": "error"
  }
}

npm install -D oxlint
vinext lint  # automatically uses oxlint

​

Comparison: eslint vs oxlint

​

Next Steps