---
slug: "mastering-typescript-skill"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/spillwavesolutions/mastering-typescript-skill@main/README.md"
repo: "https://github.com/spillwavesolutions/mastering-typescript-skill"
source_file: "README.md"
branch: "main"
---
# Mastering TypeScript Skill

Master enterprise-grade TypeScript development with type-safe patterns, modern tooling, and framework integration.

## Overview

This skill provides comprehensive guidance for TypeScript 5.9+ development, covering:

- **Type System Mastery**: Generics, mapped types, conditional types, satisfies operator
- **Enterprise Patterns**: Error handling, validation with Zod, project architecture
- **React Integration**: Type-safe components, hooks, state management (Zustand, Redux Toolkit)
- **NestJS Development**: Scalable APIs, DTOs, authentication, RBAC
- **Modern Toolchain**: Vite 7, pnpm, ESLint 9 flat config, Vitest
- **Cross-Language Insights**: TypeScript compared with Java, Python, C#

## Quick Start

```bash
# Initialize TypeScript project with ESM
pnpm create vite@latest my-app --template vanilla-ts
cd my-app && pnpm install

# Configure strict TypeScript
cat > tsconfig.json << 'EOF'
{
  "compilerOptions": {
    "target": "ES2024",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "noUncheckedIndexedAccess": true,
    "exactOptionalPropertyTypes": true
  }
}
EOF
```

## When to Use This Skill

Use when:
- Building type-safe React, NestJS, or Node.js applications
- Migrating JavaScript codebases to TypeScript
- Implementing advanced type patterns (generics, mapped types, conditional types)
- Configuring modern TypeScript toolchains
- Designing type-safe API contracts with Zod validation

## Installing with Skilz (Universal Installer)

The recommended way to install this skill across different AI coding agents is using the **skilz** universal installer.

### Install Skilz

```bash
pip install skilz
```

### Claude Code

Install to user home (available in all projects):
```bash
skilz install -g https://github.com/SpillwaveSolutions/mastering-typescript-skill
```

Install to current project only:
```bash
skilz install -g https://github.com/SpillwaveSolutions/mastering-typescript-skill --project
```

### OpenCode

```bash
skilz install -g https://github.com/SpillwaveSolutions/mastering-typescript-skill --agent opencode
```

### Gemini

```bash
skilz install -g https://github.com/SpillwaveSolutions/mastering-typescript-skill --agent gemini
```

### OpenAI Codex

```bash
skilz install -g https://github.com/SpillwaveSolutions/mastering-typescript-skill --agent codex
```

## Skill Contents

- **SKILL.md** - Main skill documentation with quick reference
- **references/** - Detailed reference documentation
  - `type-system.md` - Complete type system guide
  - `generics.md` - Advanced generics patterns
  - `enterprise-patterns.md` - Error handling, validation, architecture
  - `react-integration.md` - React + TypeScript patterns
  - `nestjs-integration.md` - NestJS API development
  - `toolchain.md` - Modern build tools configuration
- **assets/** - Templates and starter files
  - `tsconfig-template.json` - Strict enterprise config
  - `eslint-template.js` - ESLint 9 flat config
- **scripts/** - Utility scripts
  - `validate-setup.sh` - Verify TypeScript environment

## Version Information (December 2025)

| Tool | Version | Purpose |
|------|---------|---------|
| TypeScript | 5.9+ | Type checking and compilation |
| Node.js | 22 LTS | Runtime environment |
| Vite | 7.x | Build tool and dev server |
| pnpm | 9.x | Package manager |
| NestJS | 11.x | Backend framework |
| React | 19.x | Frontend library |
| ESLint | 9.x | Linting with flat config |
| Vitest | 3.x | Testing framework |

## Key Features Covered

### Type System
- Union and intersection types
- Discriminated unions for type-safe branching
- Type guards and type narrowing
- The `satisfies` operator for safer type checking
- Template literal types

### Generics
- Generic functions, interfaces, and classes
- Generic constraints with `extends`
- Mapped types and key remapping
- Conditional types with `infer`
- Variadic tuple types

### Enterprise Patterns
- Result/Either types for error handling
- Zod schema validation
- Branded types for domain modeling
- Feature-based project organization

### Framework Integration
- React: Typed components, hooks, Context API
- NestJS: Controllers, services, DTOs, guards
- State management: Zustand, Redux Toolkit

## License

MIT

## Author

Richard Hightower - Based on "Mastering Modern TypeScript" book content