A nodejs library to generate the API Docs with multiple UI
npm install @didik-mulyadi/nodejs-api-doc
This package already supports NestJS and ExpressJS.
At this point, we are focusing on adding examples with many js-doc libraries. In the future, we will create our open API doc generation, "One Code for All Frameworks", but don't worry we are still making it support with other libraries.
Install @didik-mulyadi/nodejs-api-doc using pnpm/npm/yarn:
``bash
pnpm add @didik-mulyadi/nodejs-api-doc
npm install @didik-mulyadi/nodejs-api-doc
yarn add @didik-mulyadi/nodejs-api-doc
`
After we set up the package correctly, we can switch the UI in your docs with this.
For example, your API doc location is http://localhost:3000/docs
1. Use Swagger UI, http://localhost:3000/docs?ui=swagger
2. Use Stoplight UI, http://localhost:3000/docs?ui=stoplight
3. Use Redoc UI, http://localhost:3000/docs?ui=redoc
For code examples, see the examples directory or click.
This package supports any package/library that returns the open API object. These are tested framework and library that is compatible with our package:
| Library | Support |
| -------------------------------------------------------------------------------------- | ------- |
| Nest JS + Fastify with @nestjs/swagger | โ
|
| Nest JS + Express with @nestjs/swagger | โ
|
| Express with swagger-jsdoc | โ
|
Here's an example of how to use this package:
Step:
1. Modify your src/main.ts with the below steps
2. Create a swagger config with new DocumentBuilder()
3. Generate open API document object with SwaggerModule.createDocument(app, config)
4. Setup nodejs-api-doc with new NestApiDoc
5. Start nodejs-api-doc with nestApiDoc.start()
``typescript
import { NestApiDoc } from '@didik-mulyadi/nodejs-api-doc'
async function bootstrap() {
const app = await NestFactory.create
AppModule,
new FastifyAdapter()
)
// swagger
const config = new DocumentBuilder()
.setTitle('Node.js API Docs')
.setDescription('This API provides ...')
.setVersion('0.0.1')
.build()
const document = SwaggerModule.createDocument(app, config)
// nodejs-api-doc
const nestApiDoc = new NestApiDoc(app, document, {
defaultUI: 'stoplight',
customPath: '/docs',
})
nestApiDoc.start()
// Run the nestjs
await app.listen(8080, '0.0.0.0')
}
`
Step:
1. Modify your src/main.ts with the below stepsnew DocumentBuilder()
2. Create a swagger config with SwaggerModule.createDocument(app, config)
3. Generate open API document object with new NestApiDoc
4. Setup nodejs-api-doc with nestApiDoc.start()
5. Start nodejs-api-doc with
`typescript
import { NestApiDoc } from '@didik-mulyadi/nodejs-api-doc'
async function bootstrap() {
const app = await NestFactory.create(AppModule)
// swagger
const config = new DocumentBuilder()
.setTitle('Node.js API Docs')
.setDescription('This API provides ...')
.setVersion('0.0.1')
.build()
const document = SwaggerModule.createDocument(app, config)
// nodejs-api-doc
const nestApiDoc = new NestApiDoc(app, document, {
defaultUI: 'stoplight',
customPath: '/docs',
})
nestApiDoc.start()
// Run the nestjs
await app.listen(8080, '0.0.0.0')
}
`
Step:
1. Modify your server.js or main.js with the below stepsconst document = swaggerJsdoc(options)
2. Call the swagger-jsdoc const expressApiDoc = new ExpressApiDoc(app, document)
3. Setup nodejs-api-doc expressApiDoc.start()
4. Start nodejs-api-doc
`typescript
const { ExpressApiDoc } = require('@didik-mulyadi/nodejs-api-doc')
const app = express()
...
// swagger-jsdoc
const options = {
definition: {
openapi: '3.1.0',
info: {
title: 'Node JS API Docs with Express',
version: '0.1.0',
description:
'This is a simple CRUD API application made with Express and documented with Swagger',
license: {
name: 'MIT',
url: 'https://spdx.org/licenses/MIT.html',
},
contact: {
name: 'Didik Mulyadi',
url: 'https://www.linkedin.com/in/didikmulyadi/',
email: 'didikmulyadi12@gmail.com',
},
},
servers: [
{
url: 'http://localhost:3000',
},
],
},
apis: ['./routes/*.js'],
}
const document = swaggerJsdoc(options)
// Nodejs-api-doc
const expressApiDoc = new ExpressApiDoc(app, document)
expressApiDoc.start()
app.listen(3000)
`
#### Nest.JS Fastify Helmet
`typescript
import { NestApiDoc, helmetConfig } from '@didik-mulyadi/nodejs-api-doc';
async function bootstrap() {
...
await app.register(helmet, helmetConfig.nodeApiDocHelmetOption);
...
}
`
If you found any issues or have a good suggestion, feel free to open an issue
We are still updating this package, to make it more useful and easy to use. Here are the next that author wants to do
- [ ] Add readme for bug_report.mdfeature_request.md`
- [ ] Add readme for
Reach me on:
 