Introduction

This package provides the shared TypeScript configurations for the entire FRAME monorepo. Each preset targets a specific runtime environment and extends a strictly typed base set of compiler options.

Tip

Shared configurations centralize compiler options and avoid duplication across packages. Any change to the base propagates automatically to all consumers.

Available presets

Preset	Import path	Recommended use
base	@frame/tsconfig/base	Base for all presets. Do not use directly.
next	@frame/tsconfig/next	Next.js applications with App Router
nest	@frame/tsconfig/nest	NestJS applications with decorators
node	@frame/tsconfig/node	Node.js scripts and CLIs
react-library	@frame/tsconfig/react-library	React libraries without a framework

Preset architecture

All presets extend base.json and only override the options required for their environment:

graph TD
  base["base.json"] --> next["next.json"]
  base --> nest["nest.json"]
  base --> node["node.json"]
  base --> react["react-library.json"]

Notable base options

The base preset sets the following compiler options as the starting point for all packages:

Option	Value	Purpose
strict	true	Enables all strict TypeScript checks
noImplicitAny	true	Forbids implicit any
strictNullChecks	true	Distinguishes null and undefined from other types
noUnusedLocals	true	Errors on unused local variables
noUnusedParameters	true	Errors on unused function parameters
noImplicitOverride	true	Requires the override keyword when overriding methods
noImplicitReturns	true	Requires an explicit return on all branches
noFallthroughCasesInSwitch	true	Forbids fallthrough in switch
target	es2022	Modern compilation target
module	esnext	Native ES modules
moduleResolution	bundler	Resolution optimized for modern bundlers
isolatedModules	true	Compatible with per-file transpilation (esbuild, SWC)
incremental	true	Incremental compilation for speed
resolveJsonModule	true	Allows importing .json files
skipLibCheck	true	Skips type checking of third-party .d.ts files
erasableSyntaxOnly	false	Allows non-erasable TypeScript syntax (decorators)

Preset details

next

Extends base and enables the Next.js plugin for IDE analysis:

next.json

{
  "extends": "./base.json",
  "compilerOptions": {
    "jsx": "react-jsx",
    "plugins": [{ "name": "next" }]
  }
}

nest

Extends base and enables decorators for NestJS:

nest.json

{
  "extends": "./base.json",
  "compilerOptions": {
    "target": "ES2023",
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "declaration": true,
    "sourceMap": true,
    "removeComments": true,
    "noImplicitAny": false,
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noImplicitOverride": false
  }
}

Note

NestJS requires emitDecoratorMetadata: true and experimentalDecorators: true for the dependency injection system to work correctly. Strict unused-variable checks are disabled to maintain compatibility with the framework’s decorators.

node

Extends base and adds Node.js types:

node.json

{
  "extends": "./base.json",
  "compilerOptions": { "types": ["node"] }
}

react-library

Extends base and enables JSX for React libraries:

react-library.json

{
  "extends": "./base.json",
  "compilerOptions": { "jsx": "react-jsx" }
}

How to use it in a new package

1. Add the package as a development dependency:

   package.json

   {
     "devDependencies": {
       "@frame/tsconfig": "workspace:*"
     }
   }

2. Create a tsconfig.json at the package root and extend the appropriate preset:

   tsconfig.json

   {
     "extends": "@frame/tsconfig/base",
     "compilerOptions": {
       "outDir": "dist"
     },
     "include": ["src"],
     "exclude": ["node_modules", "dist"]
   }

3. Select the correct preset for the environment:

Environment	Preset
Next.js	@frame/tsconfig/next
NestJS	@frame/tsconfig/nest
Node.js / CLI	@frame/tsconfig/node
React library	@frame/tsconfig/react-library

Caution

Do not modify files in the @frame/tsconfig package directly for a single package. If a package needs additional options, extend them in its own local tsconfig.json.

TypeScript

Compiler options reference

NestJS

Decorators in NestJS

Next.js

TypeScript configuration in Next.js

TypeScript Plugin for Next.js

next TypeScript plugin