Skip to content

Latest commit

 

History

History
144 lines (98 loc) · 5.31 KB

File metadata and controls

144 lines (98 loc) · 5.31 KB

Incentro IC - Code Standards - Typescript

💫 Introduction

This package provides a set of shared Typescript configuration files that can be used across different projects.

💾 Installation

To install the package, use the following command:

pnpm add -D typescript @incentro-ic/config-typescript

🪛 Usage

After installing the package you can use the provided configuration as a basis by using the extends keyword in your tsconfig.json.

Here's an example:

{
  "extends": "@incentro-ic/config-typescript"
}

Note

The configuration files do not include any includes, files, exclude or compilerOptions.outDir options. You will need to add these options according to your project's requirements.

⚙️ Configs

🏠 Base

This is the base Typescript configuration that is applicable to all projects. The settings in this configuration are primarily related to the strictness of Typescript and should rarely be overridden as they do not affect the output or the compilation target.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript"
}

🦁 App - NestJS

This is the Typescript configuration for all NestJS projects. It extends the base configuration and adds settings that are related to working with NestJS projects, like accepting unused class properties which is a common pattern in NestJS projects.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/app-nest"
}

🔼 App - Next.js

This is the Typescript configuration for all Next.js projects. It extends the base configuration and adds settings that are related to working with React and Next.js' Typescript plugin and type helpers.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/app-next"
}

🔴 App - React Router

This is the Typescript configuration for all React Router projects. It extends the base configuration and adds settings that are related to working with React and React Router projects.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/app-react-router"
}

📦 Package

This is the base Typescript configuration for all projects that are meant to be published as a package and do not specifically target the browser or a Node.js environment. It extends the base configuration and adds settings that are related to the output of the Typescript compiler.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/package"
}

🌎 Package - Browser

This is the Typescript configuration for all projects that are meant to be published as package targeting browser environments. It extends the package configuration and adds settings that are specific to browser environments, like enabling types for methods only available in DOM environments. It targets the latest versions of most major browsers.

Important

This config disables file emission by the Typescript compiler as it is expected that you'll be using a bundler to transform the source files for use in browser environments.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/package-browser"
}

🟩 Package - Node

This is the Typescript configuration for all projects that are meant to be published as Node.js packages. It extends the package configuration and adds settings that are related to Node.js, specifically the LTS version.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/package-node"
}

⚛️ Package - React

This is the Typescript configuration for all projects that are meant to be published as React packages. It extends the browser package configuration and adds settings that are related to interpreting JSX.

Important

This config disables file emission by the Typescript compiler as it is expected that you'll be using a bundler to transform the source files for use in browser environments.

🪛 Usage

{
  "extends": "@incentro-ic/config-typescript/package-react"
}