<-/.<.>/.||./.Trellis Docs
Back to All Releases
VERSION 1.3.0

v1.3.0

Native OpenAPI/Redoc integration, variable resolution in headings, TOC responsiveness, and multiple bug fixes.

February 23, 2026
·14 changes

New Features

7 new additions

  • Native OpenAPI/Redoc integration — render OpenAPI 2.x/3.x specs as full-featured API reference pages with Redoc's three-panel layout, schema explorer, and endpoint navigation. Place spec files in api/ and they are automatically discovered, validated, and built into static pages at /api/{slug}/
  • API docs build script — build-api-index.js scans for .yaml, .yml, and .json spec files, validates openapi/swagger keys, converts YAML to JSON, and outputs processed specs to public/api-specs/ with a manifest at _index.json
  • Redoc theme integration — API docs automatically adapt to Trellis light/dark mode with matching colors; re-renders on theme toggle
  • API sidebar item type — new type: 'api' sidebar item for linking to API reference pages ({ type: 'api', id: 'petstore', label: 'Petstore API' })
  • Versioned API specs — when documentation versioning is enabled, version-specific specs can be placed in versioned_docs/{version}/api/
  • API Documentation guide — new docs page at /plugins/api-docs/ covering setup, configuration, Redoc options, supported formats, and limitations
  • Sample Petstore spec — included at api/petstore.yaml for testing and reference

Improvements

3 enhancements

  • Table of contents sidebar now appears at the lg breakpoint (1024px) instead of xl (1280px), matching typical documentation viewing widths
  • Mobile table of contents dropdown now hides at the lg breakpoint to prevent duplicate TOC display
  • Variable expressions ({vars.productName}) in MDX headings are now resolved in the table of contents, search index, and FAQ index

Bug Fixes

4 issues resolved

  • FAQ page no longer crashes with topics.reduce is not a function when faqIndex.json returns a keyed object instead of a flat array
  • FAQ list and search now work in production deployments that use a basePath — fetch URLs are prefixed with NEXT_PUBLIC_BASE_PATH
  • "Edit this page" link now aligns with the right edge of the content area instead of floating in a separate column
  • Content area now expands to fill available width on large screens instead of being constrained by a fixed max-width