opinionated-defaults
A collection of opinionated web-dev tooling configurations.
A CLI is provided that analyzes your project and generates the appropriate ESLint/Prettier configuration files.
README
A collection of opinionated web-dev tooling configurations.
Quickstart
NOTE
The package manager that the CLI will use to install this package is dependent on what lockfile you have in the root of your project (i.e., having bun.lock will use bun, while having package-lock.json will use npm).
Currently, the only supported package managers are bun and npm.
This package contains a CLI that can be used to generate both eslint.config.ts and prettier.config.mjs files.
You can use it by running one of the following commands.
Supported Framework Configurations:
Eslint:
- Astro
- Elysia.js
- Next.js
Exports:
- eslintConfig (Used to provide autocomplete)
- eslintConfigAstro (Astro)
- eslintConfigBase (General rules for every project)
- eslintConfigElysia (Elysia.js)
- eslintConfigFunctional (Enforces functional style)
- eslintConfigNext (Next.js)
- eslintConfigOxlint (Disables ESlint rules available in Oxlint)
- eslintConfigPrettier (Runs Prettier as ESLint rules)
- eslintConfigReact (General rules for React)
- eslintConfigRelative (Enforces the use of absolute import paths using path aliases)
- eslintConfigStylistic (Enforces code-style through ESLint rules)
- eslintConfigTurbo (Turborepo)
Included plugins:
- eslint-plugin-astro
- eslint-plugin-prettier
- eslint-plugin-no-relative-import-paths
- eslint-plugin-react
- eslint-plugin-react-hooks
- eslint-plugin-turbo
- eslint-plugin-unicorn
- eslint-plugin-functional
- eslint-plugin-next
- eslint-plugin-oxlint
- eslint-plugin-perfectionist
- eslint-stylistic
Prettier:
- Astro
- Next.js
- +Opinionated defaults
Exports:
- prettierConfig (Used to merge configurations and provide autocomplete)
- prettierConfigAstro (Astro prettier rules with Tailwind class ordering)
- prettierConfigNext (Rules for Next.js with Tailwind class ordering)
- prettierConfigBase (General rules for every project)
- prettierConfigSortImports (Prettier-based import sorting)
Included plugins:
Manual Installation:
Alternatively, you can install it manually by running one of the following commands.
bun add @hiddenability/opinionated-defaults -dnpm i @hiddenability/opinionated-defaults -DUsage:
Eslint:
Prettier:
Extending/Combining Prettier Configs:
Since Prettier uses a configuration object instead of a flat config like ESLint, to extend or combine configurations, the prettierConfig function will merge configs for you.
TailwindCSS Plugin:
When using prettier-config-tailwind, make sure to specify the CSS file that contains the @import "tailwindcss" directive.
For example, given the following css file:
This should be a minimal version of your Prettier config:
TODO:
- Improve repository structure (How to manage configuration options within eslint dir?).
- Maybe convert into monorepo with one package per tool instead of multiple exports from one package.
- Prevent importing overlapping configurations (i.e., Next.js ESLint config contains base config).
- Support node module resolution.
- Maybe make declarative configurations instead of just providing wrapped config modules.