@kitschpatrol/shared-config
v4.7.12
Published
A collection of shared configurations for various linters and formatting tools. All managed as a single dependency, and invoked via a single command.
Downloads
84
Maintainers
Readme
🔬 @kitschpatrol/shared-config
A collection of shared configurations for various linters and formatting tools. All managed as a single dependency, and invoked via a single command.
Table of contents
Overview
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.
Tools
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.)
Packages
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.
Getting started
Dependencies
Node 18+ and pnpm are required. It probably works with NPM and yarn, but I haven't tested it.
Installation
Quick start from scratch:
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 .
Quick add to an existing project:
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
Step-by-step:
Install the requisite
.npmrc
:pnpm dlx @kitschpatrol/repo-config --init
Install the package:
pnpm add -D @kitschpatrol/shared-config
Add default config files for all the tools to your project root:
pnpm shared-config --init
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, seethe @kitschpatrol/prettier-config
package readme for more details.
Usage
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
CLI
Command: shared-config
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> ...]
| Option | Argument | Description |
| ------------------------ | -------- | ---------------------------------------------------------------- |
| --check
-c
| | Check for and report issues. Same as shared-config
. |
| --init
-i
| | Initialize by copying starter config files to your project root. |
| --print-config
-p
| <path>
| Print the effective configuration at a certain path. |
| --fix
-f
| | Fix all auto-fixable issues, and report the un-fixable. |
| --help
-h
| | Print this help info. |
| --version
-v
| | Print the package version. |
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.
Implementation notes
Package architecture
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.
Hoisting caveats
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 inpnpm 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 viapnpm exec
prettier
andeslint
packages are hoisted by default inpnpm
Development notes
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
Background
Motivation
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.
Similar projects
- 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!)
License
MIT © Eric Mika