Changelog

Release history for the Fiskil docs engine.

Changelog

0.6.0

July 2026

engineconfigseo

Four customization features, all opt-in in docs.json.

  • Custom 404 (errors.404) — a themed not-found page with live search-powered suggestions.
  • Fonts (fonts) — any Google font or a self-hosted file, for all text or headings and body separately.
  • Redirects (redirects) — edge 308/307 redirects with wildcard support, so moved pages keep their links.
  • Stronger SEO — JSON-LD structured data, per-page keywords/canonical/ogImage, Twitter cards, and global seo.metatags.
0.5.0

July 2026

engineopenapi

OpenAPI polish from rebuilding the real Fiskil docs on the engine. YAML spec support, grouped-reference sidebar sub-headings, an x-fiskil-notice operation callout, <RequestExample>/<ResponseExample> components, and correct prev/next navigation across products, versions, and groups.

0.4.1

July 2026

engine

Ask AI is now a docked side panel — it slides in beside your content (expandable) on desktop and as a full-height sheet on mobile, replacing the centered dialog.

0.4.0

July 2026

engineconfig

Ask AI and page feedback, both opt-in in docs.json.

  • assistant.enabled adds an AI assistant that answers only from your docs — streaming answers, page citations, Cmd+I, ?assistant= deep links, and up to three starter questions. The model runs on the Fiskil platform; you hold no AI keys. Customize tone with content/assistant/instructions.md.
  • feedback.enabled adds a "Was this page helpful?" widget with optional down-vote comments, aggregated per page in the console.

Upgrading sites: run fiskil doctor — this release adds three route stubs.

0.3.0

July 2026

enginecliconfig

Publishing

  • New fiskil publish command — deploy through the Fiskil platform with a single command; site tokens need zero flags.
  • Hosted deployments fixed: locale and product routing now works on platform-built sites (proxy configuration travels inside the build).

API references

  • openapi.apis replaces openapi.variants: references are identified by product and section, per-spec options move inline, and one product can mount multiple reference sections.
  • Grouped references (groups) with a dropdown or stacked-list switcher, per-group categories, and MDX-only groups.
  • Endpoint categories can attach to labeled sidebar sections via per-spec section and sectionByTag.
  • Cleaner slugs from messy operationIds; remote spec caching is collision-proof.

Content & branding

  • <Update> / <Updates> changelog components with tag filtering — this page is built with them.
  • logo configuration and favicon-by-convention.
  • Custom MDX components via src/mdx-components.tsx, composing engine primitives from @fiskil/docs/mdx.
  • Authored home page convention (content/docs/index.mdx).
  • Sections generalized: any top-level folder is a section tab.

SEO & analytics

  • Sitemap and robots.txt generation, seo.noindex, frontmatter noindex.
  • PostHog integration (integrations.posthog).
  • Markdown content negotiation: .md and .mdx suffixes on any page.
0.2.0

July 2026

cli
  • fiskil init scaffold reworked to a neutral template with a guided tour.
  • Mermaid diagrams render correctly in dark mode across all diagram types.
  • Scaffolding fixed for project paths containing spaces.
0.1.0

July 2026

engine

First release: the @fiskil/docs engine and fiskil CLI — MDX content tree, products and sections, OpenAPI references with an interactive playground, localization, search, theming, and llms.txt out of the box.