ts-project-initialize

name	ts-project-initialize
description	TypeScript project initialization best practices

Initialize TypeScript projects with proper tooling, type checking, and framework setup.

Reference documentation: package.md, workspace.md, typescript.md, oxc.md, hono.md, tanstack-spa.md, shadcn-ui.md, dev-tools.md, ci.md

<configuration_decisions>

Key Configuration Decisions

Project visibility:

• Public → Include LICENSE file
• Private → Omit license

Package structure:

• Single package → Root-level configuration
• Workspace (monorepo) → Root shared config + per-package configs

Application type:

• Frontend only → TanStack Router + shadcn/ui
• Backend only → Hono
• Full-stack → Hono + TanStack Router + shadcn/ui
• npm library → No framework, focus on build/publish config </configuration_decisions>

<setup_principles>

Setup Dependencies and Order

Required setup sequence (due to configuration dependencies):

1. Base package (package.md): Foundation for all subsequent configs
2. Workspace structure (workspace.md): Only if monorepo - must precede package setup
3. Linting/formatting (oxc.md): Requires package structure to be established
4. Application setup: Location depends on package structure
   • Single package: Root directory
   • Workspace: Separate packages/*/ directories
   • TypeScript (typescript.md): Required for all projects
   • Backend: hono.md
   • Frontend SPA: tanstack-spa.md
   • UI components: shadcn-ui.md
5. Development tools (dev-tools.md): Requires application structure
6. CI/CD (ci.md): Final step after all configs established

Location constraints:

• Single package: All configs at root
• Workspace: Shared configs at root, app-specific in packages/*/ </setup_principles>

<reference_index>

Setup Reference Documents

Core setup (all projects):

• package.md: Package configuration (package.json, pnpm)
• typescript.md: TypeScript strict configuration
• oxc.md: Linting and formatting with oxc
• dev-tools.md: Development utilities
• ci.md: CI/CD pipelines

Structure-specific:

• workspace.md: Monorepo/pnpm workspace setup

Framework-specific:

• hono.md: Backend API with Hono
• tanstack-spa.md: Frontend SPA with TanStack Router
• shadcn-ui.md: UI component library setup

</reference_index>

<best_practices>

Configuration Best Practices

TypeScript:

• Always use strict type checking
• Configure path aliases for clean imports

Package management:

• Use pnpm for all TypeScript projects
• Configure workspace protocol for monorepo dependencies

Tooling consistency:

• oxc for linting and formatting (faster than ESLint/Prettier)
• Consistent script names across workspace packages

</best_practices>