feat: ✨ enhance development experience with nodemon and add Swagger documentation

Author: Soapiane

app/main.ts

@@ -3,6 +3,16 @@ import Fastify from 'fastify';
 import registerMiddlewares from './middlewares';
 import registerRoutes from './routers';
 import { PrismaClient } from '@prisma/client';
+import fastifySwagger from '@fastify/swagger';
+import fastifySwaggerUi from '@fastify/swagger-ui';
+
+const isProd = process.env.ENV ? (process.env.ENV === 'PROD') : false;
+
+const host = process.env.HOST || 'localhost';
+const port = process.env.PORT ? Number(process.env.PORT) : 3000;
+
+const domain = process.env.DOMAIN || host+':'+port;
+
 
 // Load environment variables from .env
 dotenv.config();
@@ -38,6 +48,31 @@ async function startServer() {
   // 1. Register middlewares
   registerMiddlewares(fastify);
 
+
+  // 2. Register Swagger plugin (generates the OpenAPI JSON/YAML endpoints)
+  fastify.register(fastifySwagger as any, {
+    swagger: {
+      info: {
+        title: 'My API',
+        description: 'API Documentation generated with Fastify Swagger',
+        version: '1.0.0'
+      },
+      externalDocs: {
+        url: 'https://swagger.io',
+        description: 'Find more info here'
+      },
+      host: domain,
+      schemes: isProd ? ['https'] : ['http'],
+      consumes: ['application/json'],
+      produces: ['application/json']
+    },
+    exposeRoute: true,
+  });
+
+  fastify.register(fastifySwaggerUi, {
+    routePrefix: '/docs'
+  });
+
   // 2. Register routes
   registerRoutes(fastify);