Home /

Changelog

Latest Updates
& Improvements

All notable changes to @farming-labs/docs are documented here & other related libraries complementing it

v0.1.0pinned

v0.1.0: Stable Release

The first 0.1 stable release for @farming-labs/docs — rolling up the latest framework support, richer docs APIs, built-in feedback and page actions, expanded themes, and showcase-ready website surfaces.

Core Platform

  • Single docs.config model for metadata, navigation, sidebar, theming, search, AI, feedbackand page actions
  • Framework support across Next.js, TanStack Start, SvelteKit, Astro, and Nuxt
  • CLI-guided setup, generated docs routing, API reference support, and multi-framework examples for faster adoption
  • TanStack Start integration across the adapter, example app, docs flow, and init scaffolding

Components & Docs UX

  • Built-in MDX components including Callout Tabsand HoverLink with config and theme-level overrides
  • Docs feedback API with page-aware callback payloads plus built-in Good / Bad page prompts
  • Page actions for copy/open flows, code-block copy hooks, AI search, and polished docs navigation primitives

Themes & Showcase

Docs Site & Stability

  • Expanded reference configurationand customization docs covering feedback, page actions, API reference, themes, and framework setup
  • Interactive changelog with version-anchored links and release callouts across the website
  • Cross-framework build, CI, security, and Turbopack stability work across the docs site and example apps
v0.0.63pinned

v0.0.63: Current Release

Remote API reference, built-in feedback and hover-link components, Turbopack compatibility work, and cross-framework stability updates.

Reference & Docs UX

  • Added remote API reference support and the matching docs coverage
  • Added the built-in HoverLink MDX component and synced it across Next.js, TanStack Start, Astro, SvelteKit, and Nuxt
  • Cleaned up docs-site release/docs coverage, code block titles, and API reference guidance

Feedback & Framework Support

  • Added built-in page feedback with route-aware callback data and theme-aware UI
  • Wired feedback support into the website with a local API route and Prisma-backed storage
  • Expanded supported-framework coverage, examples, and framework test coverage around the new MDX components

Fixes & Stability

  • Fixed Turbopack compatibility issues for Next.js docs apps and generated client fallback handling
  • Fixed theme preset override syncing and docs theme dev-start regressions
  • Improved standalone example/version syncing and related CI/build stability
v0.0.44pinned

v0.0.44: Current Release

TanStack Start support lands across the runtime, example, and docs, with refreshed landing pages and a Nuxt security fix.

TanStack Start

  • Added TanStack Start support across the adapter, example app, and docs flow
  • Shipped a working TanStack Start example with docs routes, search, theme support, and docs.config-driven behavior
  • Added TanStack Start support to the init experience and updated CLI/docs coverage where framework support is listed

Examples & UX

  • Refreshed framework example landing pages with a centered hero, shared visual treatment, and install-first callouts
  • Unified example landing backgrounds and typography across Next.js, TanStack Start, Nuxt, SvelteKit, and Astro

Fixes & Stability

  • Fixed TanStack Start runtime, theme, routing, and build issues discovered during integration
  • Cleaned up package/example version sync and related CI formatting/build issues
  • Updated the Nuxt dependency chain to pull a patched h3 release and clear the high-severity audit finding
v0.0.31

v0.0.31: Current Release

Internationalized docs across all frameworks, locale-aware CLI scaffolding, UI polish, build fixes, and expanded documentation.

Internationalization

  • Query-param i18n across Next.js, SvelteKit, Astro, and Nuxt with locale switching via `/docs?lang=en` and `/docs?lang=fr`
  • Locale selector UI refined and aligned with the theme toggle across the supported themes and examples
  • Localized examples added across frameworks with locale-aware content loading and isolated sidebars per locale

CLI & Scaffolding

  • Init can now scaffold i18n for existing projects
  • CLI prompt flow now supports multi-select locale picking, extra custom locale codes like `pt-BR`, and default locale selection
  • Scaffold generation now creates locale folders such as `docs/en` and `docs/fr`, plus framework-specific wrapper/root files where needed
  • Added tests covering i18n prompt flow, generated config output, and scaffolded files across Next.js, SvelteKit, Astro, and Nuxt

Fixes & Stability

  • Fixed Astro locale selector rendering when the theme toggle is disabled
  • Fixed Astro search keyboard navigation so locale query params are preserved
  • Removed hardcoded locale routing in the Astro example nav config
  • Fixed build and runtime issues across Next.js, Astro, SvelteKit, and Nuxt examples and adapters while landing i18n support
  • Resolved docs/build integration issues including Next.js suspense requirements and adapter/server parsing fixes

Documentation

  • Updated the root README, CLI skill, and docs website pages to document the new i18n scaffold flow and `docs.config` `i18n` option
  • Expanded changelog coverage for this release so the cross-framework i18n work and related fixes are captured in one place
v0.0.26

v0.0.26

Latest updates and improvements across the docs experience, CLI, and framework integrations.

Highlights

  • General improvements across the docs site and tooling
  • More testing and documentation
  • Added more showcase sites to the showcase page
  • Init command now is GA: `pnpx @farming-labs/docs init`
  • Upgrade command now is GA: `pnpx @farming-labs/docs upgrade`
  • Package manager options in init and upgrade commands: npm, pnpm, yarn, bun
v0.0.14

v0.0.14

Package manager tabs in docs (npm, pnpm, yarn, bun), Create your own theme CTAs on themes pages, changelog and copy cleanup.

Highlights

  • Installation and CLI docs: all install/init/upgrade commands are tabbed by package manager (npm, pnpm, yarn, bun)
  • Docs themes page: tip callout linking to Creating your own theme; marketing /themes page: CTA card to the same guide
  • Changelog: added entries for v0.0.10, v0.0.12, v0.0.13, v0.0.14; minor comment and JSDoc cleanup in showcase API and copy components
v0.0.13

v0.0.13

Docs and dependency updates.

Highlights

  • Documentation and dependency updates
  • Stability and compatibility improvements
v0.0.11

v0.0.11

Static OG images in frontmatter, dedicated OG Images docs, createPageMetadata with openGraph/twitter, and examples version script.

Highlights

  • Frontmatter OG: full `openGraph` and `twitter` in page frontmatter; static images override dynamic endpoint per page
  • Shorthand `ogImage` plus types `PageOpenGraph`, `PageTwitter`; `buildPageOpenGraph` / `buildPageTwitter` in @farming-labs/docs
  • createPageMetadata accepts page openGraph/twitter/ogImage and optional baseUrl; remark-og skips injection when frontmatter has openGraph or ogImage
  • New docs: OG Images guide (/docs/customization/og-images) — dynamic vs static, context passed to image generator
  • API reference: Page Frontmatter openGraph/twitter, data types; OGConfig link to OG Images guide
  • Docs intro: callout that we are complementary to Fumadocs, not a replacement
  • Theme customizer: page actions distinct per theme (body-prefixed selectors so preset CSS overrides base pixel-border)
v0.0.10

v0.0.10

Docs improvements and theme customizer refinements.

Highlights

  • Documentation updates across installation, CLI, and customization guides
  • Theme customizer and preset behavior refinements
v0.0.9

v0.0.9

Theme customizer fixes, onCopyClick, docs updates, omni palette light theme, and hero flash fix.

Highlights

  • Theme customizer: code blocks and tabs fixed for default, colorful, shiny, darksharp, darkbold; pixel-border reverted to minimal styling
  • staticExport: new function to export static HTML pages from MDX files for static hosting
  • onCopyClick callback for code block copy (title, content, url, language) — Next.js, SvelteKit, Astro, Nuxt
  • Docs: why use this, customize themes and share, built-in UI section; API reference for onCopyClick
  • Omni command palette: light theme fixes for colorful preset
  • Multiple models support for AI chat
  • CLI scaffolding improvements & fixes
v0.0.3

v0.0.3: Stable Release

Stable release — improvements across themes, docs, and tooling. Includes all changes from the v0.0.3 beta cycle.

Highlights

  • Stable release following v0.0.3 beta cycle
  • Theme and documentation updates
  • Changelog and homepage version links
v0.0.2

v0.0.2: Stable Release

Second stable release — polish, theme docs, mobile fixes, and customizer improvements from the v0.0.2 beta cycle.

Highlights

  • Interactive /changelog page with version-anchored links
  • Documentation for all 7 themes
  • CSS specificity and pixel-border bleedthrough fixes
  • GreenTree theme, sidebar-icon AI mode, last-updated positioning
v0.0.1

v0.0.1: Initial Release

The first stable release of @farming-labs/docs — an AI-native documentation framework with 7 built-in themes, AI search, multi-framework support, a live theme customizer, and an interactive changelog.

Highlights

  • 7 built-in themes: Default, Colorful, Darksharp, Pixel Border, Shiny, DarkBold, GreenTree
  • Live theme customizer with preset switching and export-to-code
  • AI-powered search with floating, search, and sidebar-icon modes
  • Multi-framework: Next.js, Svelte, Astro, Nuxt
  • Interactive changelog with version-anchored links
  • Dedicated /themes showcase page
  • Mobile-responsive sidebar (layout config scoped to desktop)
v0.0.3-beta.16-20beta

beta.16–20: v0.0.3 Pre-release

Final betas before v0.0.3 stable — refinements and fixes.

Changes

  • Changelog and version pinning updates
  • Documentation and theme polish
v0.0.3-beta.11-15beta

beta.11–15: v0.0.3 Pre-release

v0.0.3 beta cycle — continued improvements.

Changes

  • Theme and layout tweaks
  • Config and customizer updates
v0.0.3-beta.5-10beta

beta.5–10: v0.0.3 Pre-release

v0.0.3 beta cycle — new features and fixes.

Changes

  • Cross-framework and theme improvements
  • Docs and changelog structure
v0.0.3-beta.1-4beta

beta.1–4: v0.0.3 Pre-release

First betas of v0.0.3 — foundation for next release.

Changes

  • Pre-release cycle for v0.0.3
  • Stability and documentation updates
v0.0.2-beta.16-20beta

beta.16–20: Polish, Docs & Mobile Fixes

Final stretch of betas — CSS specificity fixes, theme documentation, changelog page, and mobile sidebar improvements.

Documentation & Pages

  • Interactive /changelog page with animated header and version-anchored links
  • Individual docs pages for all 7 themes with usage, defaults, and customization
  • Updated main themes overview to list all 7 themes with links
  • "Explore more themes" link in customizer navigating to /docs/themes

Bug Fixes

  • Scoped --fd-sidebar-width and --fd-toc-width to desktop via @media (min-width: 1024px)
  • Fixed pixel-border bleedthrough: search button, sidebar folders, breadcrumbs, scrollbars, selection colors
  • Cache-busted preset CSS fetches to prevent stale styles
  • Comprehensive rounded-* class overrides for theme isolation
v0.0.2-beta.11-15beta

beta.11–15: GreenTree, AI Sidebar & Customizer

Introduced the GreenTree theme, AI sidebar-icon mode, configurable last-updated positioning, and customizer integration.

GreenTree Theme

  • Mintlify-inspired preset with emerald accent #0D9373
  • Inter typography, non-collapsible sidebar categories, compact 240px width
  • Integrated into customizer with sidebar-icon AI mode preset

AI Features

  • New sidebar-icon AI mode — Ask AI button next to the search bar
  • Pure AI modal dialog without search tabs
  • Dynamic DOM injection for customizer preview

Configuration

  • lastUpdated.position: "footer" | "below-title" (default: footer)
  • Footer position renders Last updated to the right of Edit on GitHub
v0.0.2-beta.5-10beta

beta.5–10: Themes, Layout & Cross-Framework

Added Shiny and DarkBold themes, configurable sidebar/TOC width, page actions alignment, and cross-framework layout support.

New Themes

  • Shiny — Clerk-inspired, purple accent hsl(256, 100%, 64%), polished light/dark design
  • DarkBold — Vercel-inspired monochrome, Geist typography, tight letter-spacing

Layout & Configuration

  • ui.layout.sidebarWidth and ui.layout.tocWidth config options with CSS variable injection
  • pageActions.alignment: "left" | "right" (default: left)
  • Transparent backgrounds for search and Ask AI button triggers

Cross-Framework

  • Svelte: CSS injection via <svelte:head>
  • Astro: CSS injection via set:html style block
  • Nuxt: CSS injection via useHead() computed property
v0.0.2-beta.1-4beta

beta.1–4: Core, Themes & Customizer

The foundational betas — MDX docs engine, file-system routing, search, four initial themes, the /themes showcase, and the live theme customizer.

Core Framework

  • MDX-based documentation with file-system routing
  • Built-in full-text search with AI-powered answers
  • createTheme and extendTheme helpers
  • Configurable sidebar ordering (numeric, alphabetical, manual)
  • Table of contents, page actions, breadcrumbs, nav cards
  • Next.js first-class support with Svelte, Astro, Nuxt adapters

Initial Themes

  • Default — neutral palette with indigo accent #6366f1
  • Darksharp — all-black with sharp corners, zero border-radius
  • Pixel Border — refined dark UI inspired by better-auth.com
  • Colorful — warm amber accent, Inter typography, directional TOC

Theme Customizer & Showcase

  • Live customizer with color pickers, layout controls, sidebar/TOC style toggles
  • Export-to-code: generates docs.config.ts and global.css snippets
  • Preset switching with 6 built-in presets
  • Dedicated /themes showcase page with "Try it live" links