Declaring the section

A collection is a generated section like any other: a source names an artefact and the type that reads it.

export default defineAppConfig({
  duxt: {
    sources: [
      {
        path: 'docs',
        generated: [
          {
            type: 'bruno',
            path: 'api',
            label: 'API'
          }
        ]
      }
    ]
  }
})

!IMPORTANTpath names a directory, not a file. bruno is the first type whose artefact is a tree — bruno.json, the .bru files, folder.bru ordering — so it declares input: 'directory' and reads its own input. Every other type stays on a single file and is unchanged.

#What it builds

/api                              the overview, from `bruno.json`
/api/<folder>                     one page per folder, nested as on disk
/api/<folder>/<request>           one page per request

Folders nest as deeply as the collection does. seq in meta is what orders both folders and requests, exactly as it orders them in Bruno; a folder or request without one sorts by name, so a build is reproducible either way.

#The two policies

Both match openapi, and both types render in the same reference layout — one rendering path, two parsers.

#Options