@ssit-hub/mvp-generate-template/templates/ts-esbuild-express-api/README.md

A beautiful CLI tool to quickly generate MVP project templates with modern frameworks and best practices

# Express API Application with TypeScript and ESBuild

A RESTful API built with Express.js, TypeScript, and ESBuild combining type safety with fast development builds.

## Features

- Express.js server setup
- TypeScript for type safety
- ESBuild for fast bundling
- RESTful API endpoints with typed responses
- CORS enabled
- Security headers with Helmet
- Error handling middleware
- JSON request/response handling
- Basic CRUD operations for users
- Type definitions for API models
- Development with watch mode
- Production builds with minification

## Getting Started

### Prerequisites

- Node.js >= 16.0.0
- npm >= 7.0.0

### Installation

1. Install dependencies:
```bash
npm install
```

### Running the Application

#### Development mode (with watch):
```bash
npm run dev
```

#### Build for production:
```bash
npm run build:prod
```

#### Run production build:
```bash
npm start
```

#### Type checking only:
```bash
npm run typecheck
```

## API Endpoints

### Base URL
```
http://localhost:3000
```

### Endpoints

#### General
- `GET /` - Welcome message and available endpoints
- `GET /health` - Health check endpoint

#### Users API
- `GET /api/users` - Get all users
- `GET /api/users/:id` - Get user by ID
- `POST /api/users` - Create new user
- `PUT /api/users/:id` - Update user by ID
- `DELETE /api/users/:id` - Delete user by ID

### Request/Response Examples

#### Create User
```bash
POST /api/users
Content-Type: application/json

{
  "name": "John Doe",
  "email": "john@example.com"
}
```

#### Response
```json
{
  "success": true,
  "data": {
    "id": 3,
    "name": "John Doe",
    "email": "john@example.com"
  },
  "message": "User created successfully"
}
```

## Project Structure

```
src/
├── index.ts                 # Main application entry point
├── types/
│   └── index.ts            # Type definitions
├── routes/
│   └── api.ts              # API routes with types
└── middleware/
    └── errorHandler.ts     # Error handling middleware
dist/                       # Built application (generated)
├── index.js                # Compiled and bundled output
esbuild.config.mjs          # ESBuild configuration
tsconfig.json               # TypeScript configuration
```

## Type Definitions

### User Interface
```typescript
interface User {
  id: number;
  name: string;
  email: string;
}
```

### API Response Interface
```typescript
interface ApiResponse<T> {
  success: boolean;
  data?: T;
  error?: string;
  message?: string;
  count?: number;
}
```

## Environment Variables

- `PORT` - Port number for the server (default: 3000)
- `NODE_ENV` - Environment (development/production)

## Scripts

- `npm start` - Run the built application
- `npm run dev` - Run in development mode with watch
- `npm run build` - Build for development
- `npm run build:prod` - Build for production with minification
- `npm run typecheck` - Check types without compilation

## License

MIT