@jterrazz/codestyle

Fast, opinionated linting and formatting for TypeScript. Powered by Oxlint, Oxfmt, tsgo, and Knip.

Quick Start

npm install @jterrazz/codestyle --save-dev

Create oxlint.config.ts:

import { defineConfig } from 'oxlint';
import { oxlint } from '@jterrazz/codestyle';

export default defineConfig({
    extends: [oxlint.node],
});

Create oxfmt.config.ts:

import { defineConfig } from 'oxfmt';
import { oxfmt } from '@jterrazz/codestyle';

export default defineConfig(oxfmt);

Run:

npx codestyle check   # Check everything (types + lint + format + unused code)
npx codestyle fix     # Fix lint and formatting issues

Presets

Pick a base config:

Preset	Use Case
oxlint.node	Node.js (requires .js extensions)
oxlint.expo	Expo / React Native
oxlint.next	Next.js

Architecture preset (additive):

Preset	Use Case
oxlint.hexagonal	Hexagonal architecture enforcement

Architecture Enforcement

Enforce hexagonal architecture boundaries:

import { defineConfig } from 'oxlint';
import { oxlint } from '@jterrazz/codestyle';

export default defineConfig({
    extends: [oxlint.node, oxlint.hexagonal],
});

Rules enforced:

• domain/ cannot import from other layers
• application/ cannot import infrastructure
• presentation/ui/ cannot import navigation
• features/ cannot import other features

Unused Code Detection

codestyle check runs Knip to detect unused files, exports, and dependencies. A base config is automatically merged with any project-local knip.json, handling common ecosystem patterns:

• @jterrazz/* packages auto-ignored
• Published libraries: exports/types/files rules auto-disabled
• Convention paths (fixtures/, expected/, docs/) auto-ignored
• Plugin dependencies (*-plugin-*, @scope/*) auto-ignored

For fine-tuning, create a knip.json with only project-specific overrides.

What Runs

codestyle check runs four tools in parallel:

Tool	Purpose
tsgo	Type checking
oxlint	Linting
oxfmt	Formatting
knip	Unused code analysis

codestyle fix runs three tools in parallel (knip excluded):

Tool	Purpose
tsgo	Type checking
oxlint	Linting (with --fix)
oxfmt	Formatting