typescript

作者: contentstack

TypeScript和ESLint约定、路径别名以及新代码的放置位置。

npx skills add https://github.com/contentstack/kickstart-next-ssg --skill typescript

TypeScript – kickstart-next-ssg

When to use

  • Adding .ts / .tsx files or changing compiler options
  • Understanding the @/ import alias or strictness
  • Adjusting ESLint behavior for this project

Instructions

Compiler (tsconfig.json)

  • strict: true, noEmit: true, jsx: "react-jsx", moduleResolution: "bundler", isolatedModules: true.
  • Path alias: @/* maps to the repository root — e.g. @/lib/contentstack, @/pages/....
  • Include pattern covers **/*.ts, **/*.tsx, and .next/types/**/*.ts.

Layout

  • Shared app logic: lib/ (e.g. Contentstack client, types).
  • Routes and page components: pages/.

ESLint (eslint.config.mjs)

  • Extends eslint-config-next core-web-vitals and TypeScript presets.
  • Explicit rule: @typescript-eslint/no-explicit-any is off (matches existing SDK/metadata typing patterns).
  • Global ignores: .next/, out/, build/, next-env.d.ts.

Commands

  • npm run lint — project ESLint entry point.