Bootstrap REST API with TypeScript, Fastify, and Prisma for Node.js 24

[Copilot]

Initializes a production-ready REST API foundation using TypeScript, Fastify, and Prisma with clean architecture principles.

Structure

• src/common/ - Shared infrastructure

  • config/ - Environment-based configuration with explicit .env path resolution
  • middleware/ - Centralized error handler with structured logging
  • types/ - API response interfaces and pagination types
  • utils/ - Prisma client singleton, Pino logger setup

• src/controllers/ - Request/response handlers

• src/services/ - Business logic layer

• src/routes/ - Fastify route definitions with schema validation

Implementation

Health check endpoint demonstrating the pattern:

// Service layer
export class HealthService {
  async checkHealth(): Promise<HealthStatus> {
    const databaseConnected = await this.checkDatabase();
    return { status: databaseConnected ? 'healthy' : 'unhealthy', ... };
  }
}

// Controller layer
export class HealthController {
  async getHealth(_request: FastifyRequest, reply: FastifyReply) {
    const health = await healthService.checkHealth();
    const response: ApiResponse = { success: true, data: health };
    reply.status(health.status === 'healthy' ? 200 : 503).send(response);
  }
}

// Route registration
await fastify.register(healthRoutes, { prefix: '/api/v1' });

Configuration

• TypeScript strict mode with ES2022 target
• ESLint 9 flat config with TypeScript parser
• Fastify with Helmet (security headers) and CORS
• Prisma with PostgreSQL, includes example schema
• Graceful shutdown handlers for SIGINT/SIGTERM

Scripts

• npm run dev - Hot reload with tsx
• npm run build - TypeScript compilation
• npm run lint - ESLint with Prettier integration
• npm run prisma:generate - Generate Prisma Client
• npm run prisma:migrate - Run migrations

Endpoints: GET / (info), GET /api/v1/health (health check with DB connectivity)

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• checkpoint.prisma.io
  • Triggering command: /usr/local/bin/node /home/REDACTED/work/ldacapi/ldacapi/node_modules/prisma/build/child {"product":"prisma","version":"6.18.0","cli_install_type":"local","information":"","local_timestamp":"2025-10-29T01:24:05Z","project_hash":"811b365c","cli_path":"/home/REDACTED/work/ldacapi/ldacapi/node_modules/.bin/prisma","cli_path_hash":"fc09e426","endpoint":"REDACTED","disable":false,"arch":"x64","os":"linux","node_version":"v20.19.5","ci":true,"ci_name":"GitHub Actions","command":"generate --postinstall \"UNABLE_TO_FIND_POSTINSTALL_TRIGGER__ENVAR_MISSING\"","schema_providers":["postgresql"],"schema_preview_features":[],"schema_generators_providers":["prisma-client-js"],"cache_file":"/home/REDACTED/.cache/checkpoint-nodejs/prisma-fc09e426","cache_duration":43200000,"remind_duration":172800000,"force":false,"timeout":5000,"unref":true,"child_path":"/home/REDACTED/work/ldacapi/ldacapi/node_modules/prisma/build/child","client_event_id":"","previous_client_event_id":"","check_if_update_available":true} (dns block)
  • Triggering command: /usr/local/bin/node /home/REDACTED/work/ldacapi/ldacapi/node_modules/prisma/build/child {"product":"prisma","version":"6.18.0","cli_install_type":"local","information":"","local_timestamp":"2025-10-29T01:25:28Z","project_hash":"811b365c","cli_path":"/home/REDACTED/work/ldacapi/ldacapi/node_modules/.bin/prisma","cli_path_hash":"fc09e426","endpoint":"REDACTED","disable":false,"arch":"x64","os":"linux","node_version":"v20.19.5","ci":true,"ci_name":"GitHub Actions","command":"generate","schema_providers":["postgresql"],"schema_preview_features":[],"schema_generators_providers":["prisma-client-js"],"cache_file":"/home/REDACTED/.cache/checkpoint-nodejs/prisma-fc09e426","cache_duration":43200000,"remind_duration":172800000,"force":false,"timeout":5000,"unref":true,"child_path":"/home/REDACTED/work/ldacapi/ldacapi/node_modules/prisma/build/child","client_event_id":"","previous_client_event_id":"","check_if_update_available":true} (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

bootstrap code using typescript, fastify and prisma for Node.js 24. This project is rest API only. Create a common folder that uses best practices for the routes, services and others.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.