eslint-plugin-zod-x

ESLint plugin that adds custom linting rules to enforce best practices when using Zod

Rules

💼 Configurations enabled in.
✅ Set in the recommended configuration.
🔧 Automatically fixable by the --fix CLI option.
💡 Manually fixable by editor suggestions.

Name	Description	💼	🔧	💡
array-style	Enforce consistent Zod array style	✅	🔧
consistent-import-source	Enforce consistent source from Zod imports
no-any	Disallow usage of z.any() in Zod schemas	✅		💡
no-empty-custom-schema	Disallow usage of z.custom() without arguments	✅
no-number-schema-with-int	Disallow usage of z.number().int() as it is considered legacy	✅	🔧
no-optional-and-default-together	Disallow using both .optional() and .default() on the same Zod schema	✅	🔧
no-throw-in-refine	Disallow throwing errors directly inside Zod refine callbacks	✅
prefer-meta	Enforce usage of .meta() over .describe()	✅	🔧
prefer-meta-last	Enforce .meta() as last method	✅	🔧
prefer-namespace-import	Enforce importing zod as a namespace import (import * as z from 'zod')	✅	🔧
prefer-strict-object	Enforce usage of .strictObject() over .object() and/or .looseObject()
require-error-message	Enforce that custom refinements include an error message	✅	🔧
require-schema-suffix	Require schema suffix when declaring a Zod schema	✅	🔧
schema-error-property-style	Enforce consistent style for error messages in Zod schema validation (using ESQuery patterns)

Installation

Install eslint and eslint-plugin-zod-x using your preferred package manager:

npm i --save-dev eslint eslint-plugin-zod-x

yarn add --dev eslint eslint-plugin-zod-x

pnpm add --save-dev eslint eslint-plugin-zod-x

Configuration

1. Import the plugin

   import eslintPluginZodX from 'eslint-plugin-zod-x';

2. Add recommended config to your ESLint setup

   eslintPluginZodX.configs.recommended,

Here’s a minimal example using the flat config format:

// eslint.config.js
import { defineConfig } from 'eslint/config';
import eslint from '@eslint/js';
import eslintPluginZodX from 'eslint-plugin-zod-x';

export default defineConfig(
  eslint.configs.recommended,
  eslintPluginZodX.configs.recommended,
);