Standalone

npx @fumadocs/openapi-standalone build ./openapi.yaml

npx @fumadocs/openapi-standalone serve ./openapi.yaml --port 8080

import type { Config } from '@fumadocs/openapi-standalone';

export default {
  input: ['./openapi.yaml'],
  outDir: 'out',
} satisfies Config;

import { generateStatic } from '@fumadocs/openapi-standalone';

await generateStatic({
  input: ['./openapi.yaml'],
  outDir: 'out',
});

out/
├── index.html                   # overview of the document
├── pets/listPets/index.html     # a page for each operation
├── 404.html
└── _fumadocs/                   # scripts, styles, documents and search index

import { Hono } from 'hono';
import { createApp } from '@fumadocs/openapi-standalone/hono';

const app = new Hono();

// routes are under `baseUrl`
app.route(
  '/',
  createApp({
    input: ['./openapi.yaml'],
    baseUrl: '/docs',
    // CORS proxy for the API playground, it only forwards requests to the absolute URLs in `servers`
    proxy: true,
  }),
);

export default app;

await generateStatic({
  // file paths and URLs, or a record of document ID -> file path, URL or document object
  input: ['./openapi.yaml', './billing.yaml'],
  // emptied before writing
  outDir: 'out',
  // a page for each 'operation' (default), 'tag' or 'file'
  per: 'operation',
  // folders of operation pages: 'tag' (default when operations have tags), 'route' or 'none'
  groupBy: 'tag',
  // the URL path the docs are served under, default: '/'
  baseUrl: '/docs',
  // default: `info.title` of the document
  title: 'Acme API',
  // a `createProxy()` route for the API playground
  proxyUrl: 'https://example.com/api/proxy',
});