@linkurious/eslint-config-ogma

A shareable ESLint 9 flat config for TypeScript projects with opinionated rules for code quality and consistency.

Features

• ✨ ESLint 9 flat config format
• 🔧 TypeScript support with typescript-eslint
• 📦 Import/export linting with eslint-plugin-import
• 🤝 Promise best practices with eslint-plugin-promise
• 💅 Prettier integration for code formatting
• 📋 Organized import ordering rules

Installation

npm install --save-dev @linkurious/eslint-config-ogma eslint typescript

Usage

Basic Setup

Create an eslint.config.js file in your project root:

import ogmaConfig from "@linkurious/eslint-config-ogma";

export default ogmaConfig;

With Custom Overrides

import ogmaConfig from "@linkurious/eslint-config-ogma";

export default [
  ...ogmaConfig,
  {
    // Your custom rules
    rules: {
      "no-console": "warn", // Override the default 'error'
      // Add your project-specific rules here
    },
  },
];

File-Specific Configuration

import ogmaConfig from "@linkurious/eslint-config-ogma";

export default [
  ...ogmaConfig,
  {
    files: ["**/*.test.ts", "**/*.spec.ts"],
    rules: {
      "no-console": "off", // Allow console in tests
    },
  },
];

Ignoring Files

import ogmaConfig from "@linkurious/eslint-config-ogma";

export default [
  ...ogmaConfig,
  {
    ignores: ["dist/**", "build/**", "node_modules/**", "**/*.d.ts"],
  },
];

Package.json Scripts

Add these scripts to your package.json:

{
  "scripts": {
    "lint": "eslint .",
    "lint:fix": "eslint . --fix"
  }
}

What's Included

This config includes:

• Base configs: ESLint recommended + TypeScript recommended
• Import linting: Organized imports with alphabetical sorting
• Promise linting: Best practices for Promise usage
• TypeScript support: Full TypeScript parsing and linting
• Prettier integration: Automatic formatting conflict resolution

Key Rules

• no-console: Error (use proper logging instead)
• @typescript-eslint/ban-ts-comment: Warning
• @typescript-eslint/no-non-null-assertion: Off (allows ! assertions)
• import/order: Enforces organized import grouping and alphabetical sorting

Requirements

• ESLint 9.x
• TypeScript 4.x or 5.x
• Node.js 16+ (required by ESLint 9)

Migration from v1.x

If you're upgrading from v1.x (ESLint 8), you'll need to:

1. Update to ESLint 9: npm install --save-dev eslint@^9.0.0
2. Convert your .eslintrc.* to eslint.config.js (flat config format)
3. Update your config import as shown in the usage examples above

License

Apache-2.0 © Linkurious SAS