@djangocfg/typescript-config

中文文档
2.1.655发布于 2026/11/12MIT零依赖近 30 天下载 1.5万

Shared TypeScript configurations for Next.js, React libraries, and Node.js projects with strict type checking

原始使用文档
文档目录12 节
  1. Overview
  2. Features
  3. Installation
  4. Usage
  5. Next.js Application
  6. React Library
  7. Base Configuration
  8. Available Configs
  9. Compiler Options
  10. Documentation
  11. Contributing
  12. License

@djangocfg/typescript-config

Shared TypeScript configurations for Next.js, React libraries, and Node.js projects with strict type checking

npm version License: MIT

Part of DjangoCFG — a modern Django framework for building production-ready SaaS applications. All @djangocfg/* packages are designed to work together, providing type-safe configuration, real-time features, and beautiful admin interfaces out of the box.


Overview

@djangocfg/typescript-config provides battle-tested TypeScript configurations for modern web development. It includes presets for Next.js applications, React component libraries, and general TypeScript projects.

Features

  • Strict Mode - Maximum type safety with strict compiler options
  • Next.js Preset - Optimized for Next.js App Router
  • React Library Preset - Configured for publishing React packages
  • Path Aliases - Standard path mapping configuration
  • Modern Target - ES2022 output for modern runtimes

Installation

npm install -D @djangocfg/typescript-config
# or
pnpm add -D @djangocfg/typescript-config
# or
yarn add -D @djangocfg/typescript-config

Usage

Next.js Application

{
  "extends": "@djangocfg/typescript-config/nextjs.json",
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  },
  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
  "exclude": ["node_modules"]
}

React Library

{
  "extends": "@djangocfg/typescript-config/react-library.json",
  "compilerOptions": {
    "outDir": "dist",
    "rootDir": "src"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

Base Configuration

{
  "extends": "@djangocfg/typescript-config/base.json",
  "compilerOptions": {
    "outDir": "dist"
  }
}

Available Configs

ConfigDescription
base.jsonBase strict TypeScript configuration
nextjs.jsonNext.js App Router configuration
react-library.jsonReact component library configuration

Compiler Options

All configurations include these strict options:

{
  "strict": true,
  "esModuleInterop": true,
  "skipLibCheck": true,
  "resolveJsonModule": true,
  "isolatedModules": true,
  "noUncheckedIndexedAccess": true,
  "noImplicitOverride": true,
  "forceConsistentCasingInFileNames": true
}

Documentation

Full documentation available at djangocfg.com

Contributing

Issues and pull requests are welcome at GitHub

License

MIT - see LICENSE for details

版本与发布记录

@djangocfg/typescript-config 共发布 675 个版本,首次发布于 2025/10/13;过去 12 个月发布了 633 个版本。

版本发布日期距今
2.1.655latest2026/11/12今天
2.1.6532026/11/12今天
2.1.6522026/11/11今天
2.1.6512026/11/111 天前
2.1.6502026/11/111 天前
2.1.6482026/11/111 天前

关于 @djangocfg/typescript-config 的常见问题

@djangocfg/typescript-config 是什么?

Shared TypeScript configurations for Next.js, React libraries, and Node.js projects with strict type checking

如何安装 @djangocfg/typescript-config?

在项目目录运行 npm install @djangocfg/typescript-config,或使用 pnpm add / yarn add / bun add。

@djangocfg/typescript-config 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/djangocfg__typescript-config 是否存在。

@djangocfg/typescript-config 可以商用吗?

@djangocfg/typescript-config 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@djangocfg/typescript-config 的下载量有多少?

根据 npm 官方下载统计,@djangocfg/typescript-config 在 2026/10/13 – 2026/11/11 这 30 天内被下载 14,558 次,日均约 485 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@djangocfg/typescript-config 还在维护吗?

最新版本 2.1.655 发布于 2026/11/12(今天);至今共发布 675 个版本,其中过去 12 个月发布了 633 个;首次发布于 2025/10/13。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。