@hrcd/eslint-config

@hrcd/eslint-config

A comprehensive and opinionated ESLint Flat configuration designed to provide an optimal development experience with Vue, Nuxt and TypeScript projects, while supporting many other technologies.

✨ Features

• 🔄 Auto-fix formatting - No need for Prettier, everything is handled by ESLint
• ⚡ Vue & Nuxt optimized - First-class support for Vue 3 and the Nuxt ecosystem
• 🔒 TypeScript ready - Built specifically for TypeScript projects with strict type checking
• 🌐 Multi-language support - Handles JavaScript, TypeScript, Vue, JSON, YAML, Markdown and more
• 📦 PNPM optimized - Special rules for projects using PNPM workspaces
• 🚀 PNPM Catalog support - Integration with the new PNPM Catalog feature for better dependency management
• 🧹 Style consistency - Ensures consistent code style with sorted imports and logical formatting
• 🛠️ Easily customizable - Opinionated defaults but highly configurable
• 📝 .gitignore integration - Automatically respects your .gitignore files

📥 Installation

# ✨ Auto-detect
npx nypm install @hrcd/eslint-config

# npm
npm install @hrcd/eslint-config

# yarn
yarn add @hrcd/eslint-config

# pnpm
pnpm install @hrcd/eslint-config

# bun
bun install @hrcd/eslint-config

🔧 Configuration

Create an eslint.config.js file at the root of your project:

import { createConfig } from "@hrcd/eslint-config"

export default createConfig()

⚙️ Customization

The configuration is opinionated but flexible. You can customize it to match your project's needs:

import { createConfig } from "@hrcd/eslint-config"

export default createConfig({
  // Enable/disable features
  typescript: true, // TypeScript support
  vue: true,        // Vue support
  nuxt: true,       // Nuxt support

  // Define files to ignore
  ignores: [
    'dist',
    'node_modules',
    // Other patterns to ignore
  ]
})

📊 PNPM Catalog Support

This ESLint config includes optimized rules for projects using PNPM Catalog, the new feature that helps manage and organize packages in PNPM workspaces. It ensures proper dependency declarations, prevents hoisting issues, and maintains catalog structure consistency.

💻 IDE Integration

VS Code

• Install the ESLint extension
• Add to your settings.json:

{
  "eslint.validate": [
    "javascript",
    "typescript",
    "vue",
    "html",
    "markdown",
    "json",
    "yaml"
  ],
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  }
}

🛠️ Development

• Clone this repository
• Install latest LTS version of Node.js
• Enable Corepack using corepack enable
• Install dependencies using bun install

🤝 Contributing

To start contributing, follow these steps:

• First raise an issue to discuss the changes you would like to make.
• Fork the repository.
• Create a branch using conventional commits and the issue number as the branch name. For example, feat/123 or fix/456.
• Make changes following the local development steps above.
• Commit your changes following the Conventional Commits specification.
• Run tests using pnpm run test.
• Create a pull request following the Pull Request Template.
  • To be merged, the pull request must pass the tests/workflows and have at least one approval.
  • If your changes affect the documentation, make sure to update it.
  • If your changes affect the code, make sure to update the tests.
• Wait for the maintainers to review your pull request.
• Once approved, the pull request will be merged in the next release!

Sponsors

Contributors

Published under the APACHE license. Made by @HugoRCD and community 💛

🤖 auto updated with automd (last updated: Thu Apr 03 2025)