@max-health/config

Shared configuration presets for Max Health repositories.
Aligned with latest Vite template (ES2023, erasableSyntaxOnly, flat ESLint config with recommended presets).

Install

npm install --save-dev github:max-health-inc/config

Usage

TypeScript

tsconfig.app.json:

{
  "extends": "@max-health/config/tsconfig/app.json",
  "compilerOptions": {
    "paths": { "@/*": ["./src/*"] }
  },
  "include": ["src"]
}

Note: types: ["vite/client"] is included — no vite-env.d.ts file needed!

tsconfig.node.json:

{
  "extends": "@max-health/config/tsconfig/node.json",
  "include": ["vite.config.ts"]
}

tsconfig.json (root):

{
  "files": [],
  "references": [
    { "path": "./tsconfig.app.json" },
    { "path": "./tsconfig.node.json" }
  ]
}

ESLint

eslint.config.js (React):

import { createReactConfig } from '@max-health/config/eslint/react'
import { fileURLToPath } from 'url'
import path from 'path'

const __dirname = path.dirname(fileURLToPath(import.meta.url))

export default createReactConfig({ tsconfigRootDir: __dirname })

eslint.config.js (Node.js):

import { createNodeConfig } from '@max-health/config/eslint/node'
import { fileURLToPath } from 'url'
import path from 'path'

const __dirname = path.dirname(fileURLToPath(import.meta.url))

export default createNodeConfig({ tsconfigRootDir: __dirname })

With security rules (backend/workers):

export default createNodeConfig({
  tsconfigRootDir: __dirname,
  security: true,
})

Without type-checked rules (faster linting):

export default createNodeConfig({
  tsconfigRootDir: __dirname,
  typeChecked: false,
})

Vite

vite.config.ts:

import { createViteConfig } from '@max-health/config/vite'
import tailwindcss from '@tailwindcss/vite'

export default createViteConfig({
  port: 5175,
  plugins: [tailwindcss()],
})

What's included

Config	Key settings
tsconfig/app.json	ES2023, bundler resolution, strict, react-jsx, verbatimModuleSyntax, erasableSyntaxOnly, noUncheckedIndexedAccess, types: ["vite/client"]
tsconfig/node.json	ES2023, bundler resolution, strict, erasableSyntaxOnly, types: ["node"]
eslint/react	typescript-eslint recommended + reactHooks + reactRefresh + type-checked rules + consistent-type-imports
eslint/node	typescript-eslint recommended + type-checked rules + consistent-type-imports
vite	react-swc, @ alias, VITE_PROXY_BASE/VITE_BASE env support

ESLint Options

Option	Default	Description
tsconfigRootDir	—	Root dir for tsconfig resolution
typeChecked	true	Enable no-floating-promises, await-thenable, no-misused-promises
security	false	Enable no-eval, no-implied-eval, no-new-func
ignores	[]	Additional ignore patterns
extraRules	{}	Additional rules to merge

Rules included

Base (always active)

• @typescript-eslint/no-unused-vars (error, ignores _ prefix)
• @typescript-eslint/no-explicit-any (error)
• @typescript-eslint/consistent-type-imports (error, inline-type-imports)
• @typescript-eslint/no-unused-expressions (error)
• eqeqeq (error, allows == null)
• no-var (error)
• prefer-const (error)
• no-console (warn, allows warn/error/info)
• no-debugger (error)
• no-duplicate-imports (error)

Type-checked (opt-in, default: on)

• @typescript-eslint/no-floating-promises (error)
• @typescript-eslint/await-thenable (error)
• @typescript-eslint/no-misused-promises (error)

Security (opt-in, default: off)

• no-eval (error)
• no-implied-eval (error)
• no-new-func (error)

Migration from v1

v2 enables typeChecked by default. If your project doesn't have a tsconfig with project references set up, pass typeChecked: false.

Customization

All factories accept options for overrides. The tsconfig files can be extended with additional compilerOptions. See each file for available options.