A collection of shared configurations for various linters and formatting tools. All managed as a single dependency, and invoked via a single command.

• Overview
• Getting started
• Usage
• Implementation notes
• Development notes
• Background
• License

This project attempts to consolidate most of the configuration and tooling shared by my open-source and internal TypeScript / Node based projects into a single dependency.

It takes care of dependencies and configurations for the following tools:

• CSpell
• ESLint (including Svelte, Astro, and TypeScript support)
• mdat
• Prettier (including a bunch of extra plugins)
• remarklint
• Stylelint
• VS Code (extension recommendations and extension settings)
• Minimal repo boilerplate (.npmrc, .gitignore, etc.)

This readme is for the @kitschpatrol/shared-config package, which depends on a number of tool-specific packages included in the kitschpatrol/shared-config monorepo on GitHub, each of which is documented in its respective readme, linked below:

• @kitschpatrol/cspell-config
• @kitschpatrol/eslint-config
• @kitschpatrol/mdat-config
• @kitschpatrol/prettier-config
• @kitschpatrol/remark-config
• @kitschpatrol/repo-config
• @kitschpatrol/stylelint-config

Any of these may be installed and run on their own via CLI if desired. However, in general, the idea is to use @kitschpatrol/shared-config to easily run them all simultaneously over a repo with a single command with options to either check or (where possible) fix problems, with output aggregated into a single report.

Node 18+ and pnpm are required. It probably works with NPM and yarn, but I haven't tested it.

Bootstrap a new project and open in VS Code:

git init && pnpm init && pnpm pkg set type="module" && pnpm dlx @kitschpatrol/repo-config --init && pnpm add -D @kitschpatrol/shared-config && pnpm shared-config --init && pnpm i && code .

This might overwrite certain config files, so commit first:

pnpm dlx @kitschpatrol/repo-config --init && pnpm i && pnpm add -D @kitschpatrol/shared-config && pnpm shared-config --init

1. Install the requisite .npmrc:

   pnpm dlx @kitschpatrol/repo-config --init

2. Install the package:

   pnpm add -D @kitschpatrol/shared-config

3. Add default config files for all the tools to your project root:

   pnpm shared-config --init

4. Add helper scripts to your package.json:

   These work a bit like npm-run-all to invoke all of the bundled tools.

   "scripts": {
     "format": "shared-config --fix",
     "lint": "shared-config --lint",
   }

   [!NOTE]
   Prettier formatting for Ruby requires some extra legwork to configure, see the @kitschpatrol/prettier-config package readme for more details.

Various VS Code plugins should "just work".

To lint your entire project, after configuring the package.json as shown above:

pnpm run lint

To run all of the tools in a potentially destructive "fix" capacity:

pnpm run format

A collection of shared configurations for various linters and formatting tools. All managed as a single dependency, and invoked via a single command.

Usage:

shared-config [<file|glob> ...]

Recall that the @kitschpatrol/shared-config package aggregates integration and invocation of the other tool-specific packages in this monorepo. Running a cli command on shared-config effectively runs the same command against all the tool-specific packages.

Each package has a simple /src/cli.ts file which defines the behavior of its eponymous binary. The build step turns these into node "binary" scripts, providing default implementations where feasible.

The monorepo must be kept intact, as the sub-packages depend on scripts in the parent during build.

Pnpm considers module hoisting harmful, and I tend to agree, but certain exceptions are carved out as necessary:

• CSpell, remark, mdat, ESLint, and Prettier all need to be hoisted via public-hoist-pattern to be accessible in pnpm exec scripts and to VS Code plugins.

• Even basic file-only packages like repo-config seem to need to be hoisted via for their bin scripts to be accessible via pnpm exec

• prettier and eslint packages are hoisted by default in pnpm

The repo uses placeholders for the bin script for each tool to avoid circular dependency issues during pnpm install.

To tell git to ignore changes to the placeholders, run pnpm run bin-ignore.

For local development via pnpm, use file: dependency protocol instead of link:

Something to investigate: An approach to ignoring style rules in VS Code, and possibly migrate all style to

xo is really, really close to what I'm after here, but I wanted a few extra tools and preferred to use "first party" VS Code plugins where possible.

• 1stG/configs
• antfu/eslint-config
• awesome-eslint
• lass (xo etc.)
• routine-npm-packages and example
• sheriff
• standard
• trunk
• xo
• vscode-file-nesting-config
• NullVoxPopuli/eslint-configs
• tsconfig/bases
• eslint-config-current-thing (Smart!)

MIT © Eric Mika