@pycolors/eslint-config

⚠️ Read-only mirror

This repository is automatically synced from the PyColors monorepo.
Source of truth: https://github.com/pycolors-io/pycolors/tree/main/packages/eslint-config

👉 Please open issues and pull requests here --- they are synced upstream.

Production-ready ESLint configurations for modern TypeScript and React applications.

Designed to enforce consistent code quality, predictable patterns, and scalable architecture across the PyColors ecosystem.

---

Why this exists

Most teams waste time reinventing lint rules.

PyColors provides a battle-tested baseline so you can focus on shipping product --- not debating formatting rules.

This config is optimized for:

• Next.js apps
• React libraries
• Turborepo monorepos
• TypeScript-first codebases

---

Install

pnpm add -D @pycolors/eslint-config eslint
# or
npm install -D @pycolors/eslint-config eslint

---

Usage

Next.js

Create an eslint.config.mjs:

import { nextJsConfig } from "@pycolors/eslint-config/next-js";

export default nextJsConfig;

React library

import { config } from "@pycolors/eslint-config/react-internal";

export default config;

Base config

import { config } from "@pycolors/eslint-config/base";

export default config;

---

What's inside

This package bundles a curated set of rules:

• ESLint recommended
• TypeScript ESLint
• React + Hooks
• Next.js Core Web Vitals
• Prettier compatibility
• Turbo rules for monorepos
• Only-warn plugin to reduce CI friction

The goal is simple:

👉 strict enough to prevent bugs
👉 practical enough to keep velocity high

---

Design philosophy

PyColors tools are built around one principle:

Consistency scales.

When every project shares the same lint foundation:

• onboarding becomes faster
• reviews become simpler
• architecture becomes predictable

---

Versioning

This package follows Semantic Versioning.

• 1.x → stable baseline
• rule additions → minor
• breaking rule changes → major

---

Roadmap

Planned improvements:

• stricter TypeScript presets
• security-focused rules
• performance linting
• optional formatting layer

---

License

MIT

---

Links

• PyColors → https://pycolors.io
• PyColors Docs→ https://pycolors.io/docs
• UI → https://github.com/pycolors-io/pycolors-ui
• Tokens → https://github.com/pycolors-io/pycolors-tokens