@harperfast/code-guidelines

@harperfast/code-guidelines

This repository contains code guideline tools and configurations for the Harper organization.

Currently exports shared configurations for Prettier, ESLint, and TS Node Type Checking. More tools will be added soon.

Quick Start

• npm i --save-dev @harperfast/code-guidelines

• Add "prettier": "@harperfast/code-guidelines/prettier" to package.json.

• Run npx prettier .

Formatting

We use Prettier for formatting. The default config is exported under the /prettier path (i.e. @harperfast/code-guidelines/prettier).

Review the Sharing Configurations documentation for more information how to use or extend the base config.

Linting

We use ESLint to enforce code quality and integrate Prettier formatting. The default config is exported under the /eslint path (i.e. @harperfast/code-guidelines/eslint).

Using the Harper ESLint Configuration

You must create a local ESLint configuration that imports Harper's ESLint configuration, then you can extend or override the base configuration by adding your own rules.

For more detailed information about extending configurations, see the ESLint Configuration Files documentation.

• Install the required dependencies:

npm i --save-dev @harperfast/code-guidelines eslint prettier

• Create an eslint.config.mjs file in your project root:

import harperConfig from '@harperfast/code-guidelines/eslint';
import { defineConfig } from 'eslint/config';

export default defineConfig([
	...harperConfig,
	// Your custom configuration here
	{
		rules: {
			// Override or add custom rules
		},
	},
]);

• Run ESLint:

npx eslint .

Type Checking

TypeScript configuration files are available under the /tsconfig export path and can be used with the extends property in your own tsconfig.json files.

For example, to use the base Node.js configuration (supporting Node.js v20 or later):

• Start by installing necessary dev dependencies:

   npm i --save-dev typescript @types/node@20 @harperfast/code-guidelines

• Then create a tsconfig.json file in your project with the following content:

{
	"extends": "@harperfast/code-guidelines/tsconfig.node.json",
	"compilerOptions": {
		// Your custom options here
	}
}

• Finally, use TypeScript or Node.js Type Stripping!

   npx tsc
   # or
   node src/index.ts

Configurations are based off of the popular tsconfig bases project.

The following list outlines the available configurations:

• tsconfig.node.json - Node.js v20 or later with Node.js Type Stripping support
• More coming soon!

Adding new configurations

To add a new TypeScript configuration:

• Create a new file in this repository starting with tsconfig. and ending with .json. The name in between should be descriptive of the environment or relevant version (e.g. tsconfig.react.json or tsconfig.node-24.json).
• Update the exports field in package.json to include the new configuration file using the same name as the file.
• Add it to the list above with a brief description.
• Ship it 🚀