| 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):
- Base package (
package.md): Foundation for all subsequent configs
- Workspace structure (
workspace.md): Only if monorepo - must precede package setup
- Linting/formatting (
oxc.md): Requires package structure to be established
- 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
- Development tools (
dev-tools.md): Requires application structure
- 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>