createApp Config Reference

Docs Home | Previous: Decorator Reference | Next: Examples Index

createApp(config) builds routes, OpenAPI spec, and docs endpoints.

Required

FieldTypeDescription
schemaSchemaAdapterAdapter used for validation and JSON Schema conversion

Core Runtime

FieldType
controllersclass[]
providersProvider[]
importsModuleClass[]
validateResponseboolean
errorFormatterfunction

Request Pipeline Extensions

FieldType
guardsCanActivate class[]
interceptorsInterceptor class[]
middlewaresMiddlewareFunction[]
securityGuardsRecord<string, CanActivateSecurity class>

OpenAPI and Docs

FieldType
openapiOpenAPIConfig
swaggerboolean or SwaggerUIConfig
moduleViewerboolean or ModuleViewerConfig

moduleViewer registers docs routes when there are imported modules or direct app-level controllers/providers to visualize.

View Rendering

FieldType
viewEngineViewEngineConfig

Return Value

createApp returns:

  • routes: Bun route map
  • fetch: fallback handler
  • spec: generated OpenAPI document

See src/types.ts for complete type definitions.