Fastify-create NPM

create-fastify-api

Create type-safe Fastify applications with a single command. This package sets up a modern, production-ready Fastify project with TypeScript, TypeBox, and Swagger integration.

Quick Start

npx create-fastify-api my-api
cd my-api
npm run dev

Visit http://localhost:3000/docs to see your API documentation.

Features

✨ What you get out of the box:

⚡️ Fastify - High-performance web framework
🔷 TypeScript - Type safety
📘 TypeBox - Runtime type validation
📚 Swagger UI - API documentation
✅ Request/Response validation
🧪 Built-in testing setup
📝 OpenAPI generation

Usage

Create a New Project

# npm
npx create-fastify-api my-api

# yarn
yarn create fastify-api my-api

# pnpm
pnpm create fastify-api my-api

Options

npx create-fastify-api [project-name] [options]

Options:
  --package-manager   Choose package manager (npm, yarn, pnpm)
  --git              Initialize git repository (default: true)
  --install          Install dependencies (default: true)
  -h, --help         Show help
  -v, --version      Show version

Project Structure

The generated project follows a clean, maintainable structure:

my-api/
├── api/
│   ├── routes.ts          # API route handlers
│   ├── server.ts          # Fastify server configuration
│   ├── server-start.ts    # Server startup script
│   └── generateOpenApi.ts # OpenAPI documentation generator
├── types/
│   ├── ExampleRequest.ts  # Request type definitions
│   ├── ExampleResponse.ts # Response type definitions
│   └── ErrorResponse.ts   # Error response schemas
├── package.json
└── tsconfig.json

Available Scripts

# Start development server
npm run dev

# Run tests
npm test

# Generate OpenAPI documentation
npm run generate-openapi

# Start production server
npm start