Swagpi

JSON-based API docs that look swag

---

Swagpi helps you create pretty, interactive docs for your REST API with JSON.

Getting Started

You can get up and running in 30 seconds:

npm i swagpi

const swagpi = require('swagpi')
const app = express()
 
swagpi(app, {
    path: '/api',
    logo: './logo.png',
    config: {
        "Users": [
            {
                verb: 'GET',
                route: "/user",
                title: "Get all users",
                description: "Pulls a list of all users."
            }
        ]
    }
})

That's it! Browse to /api to access the docs.

Swagpi creates a static file server at the path specified. It builds interactive docs based on the JSON.

Config file

You can include a JSON path to a config file to keep the configuration separate:

swagpi(app, {
    path: '/api',
    logo: './logo.png',
    config: './config.json'
})