Documentation

Changelog

Recent releases of Laradocs, pulled live from GitHub.

On this page 54

Each release of Laradocs on GitHub, most recent first. This page is rendered live from the GitHub Releases API and cached for an hour.

v1.0.0

🎉 Laradocs v1.0.0 — we're stable!

This is the big one. After the whole 0.x journey, Laradocs is officially 1.0.0 stable, with a frozen public API, a full migration path, and the feature we've been building towards for months: a native OpenAPI renderer.

Thank you to everyone who kicked the tyres through the pre-releases. Let's ship. 🚀

✨ Highlights

📖 Native OpenAPI renderer

The headline of this release. Laradocs now renders OpenAPI specs natively, no external doc UI required.

  • Pillars A & B land the core rendering engine (#140)
  • A redesigned reference layout with a request/response code-sample sidebar (#143)
  • Driver selection: pick native, Scramble, or auto and let Laradocs decide (#147)
  • Clean, summary-based operation slugs so your URLs read like docs, not hashes (#144)
  • A dedicated OpenAPI guide plus updated system requirements (#144, #141)

🗂️ Tabbed code blocks and content tabs

Group your bash / php / json samples into tabs, and organise longer pages with content tabs (#138).

🌍 Internationalisation

  • "Last updated" dates now localise to the active docs locale (#139)
  • Cookie consent integration so a reader's chosen language persists properly (#150)

🔒 Stability and security

  • The public PHP API surface is now frozen (#149). From here, semver means what it says.
  • Security hardening around exec usage to close a potential RCE path (#154)
  • A new production readiness checklist (#151)
  • A full 0.x to 1.0 migration guide (#152)

⬆️ Upgrading from 0.x

Please read the migration guide in #152 before bumping. There are a small number of breaking changes tied to the API freeze, and the guide walks through each one.

What's Changed

New Contributors

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.6.1...v1.0.0

v0.6.0

LaraDocs v0.6.0 🎉

The headline feature this release: your docs can now run as an MCP server, so AI assistants can read them directly. Plus semantic versioning, icon support, configurable layouts, and a batch of authoring and theming upgrades.

✨ Highlights

🤖 Docs as an MCP server

LaraDocs can now expose your documentation as a Model Context Protocol server, built on laravel/mcp. That means AI clients can query your docs directly as a tool, no copy-pasting required. Ships with a client guide covering per-client setup examples and authentication.

🏷️ Semantic doc versioning

Version your documentation using semantic version ranges, giving you cleaner control over how releases map to the docs readers see.

🎨 Icon support in front-matter and body

Add icons to page titles via front-matter and drop them inline in your content for richer, more scannable pages.

🖨️ Built-in print styles

A proper set of @media print styles ship by default, so your docs look right when someone hits print or saves to PDF.

⚙️ More configurability

Article content width is now configurable, the docs middleware stack can be customised, and callout labels are localised with support for inline titles.

⌨️ Platform-aware search shortcut

The search trigger now shows the right shortcut for the reader's platform (⌘K on macOS, Ctrl+K elsewhere).

📦 What's Changed

feat: Expose docs as an MCP server via laravel/mcp by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/104 Ensure MCP tests can run in CI by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/111 docs: MCP client guide, per-client examples and auth section by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/112 feat: icon support for front-matter titles and body content by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/113 feat: Semantic doc versioning by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/114 feat: add built-in @media print styles by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/116 Localize callout type labels and support inline titles by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/117 feat: make article content width configurable by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/118 Show platform-appropriate keyboard shortcut in search trigger (⌘K vs Ctrl+K) by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/119 Make docs middleware stack configurable by @PeteBishwhip in https://github.com/PeteBishwhip/laradocs/pull/120

👋 New Contributors

None, be the first!

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.5.3...v0.6.0

v0.5.3

v0.5.3 - Laravel Boost Support! 🤖

Admit it, we all like delegating documentation to our AI agents!

Well, now you can! This is a special maintenance release that gives you native Laravel Boost guidelines to help your agent help you!

Simple ensure your composer.json file is configured for either ^v0 (Get all updates up to when we drop v1.0!) or v0.5.0 (Pin to v0.5.x), run composer update and finally, just run php artisan boost:install to include them!

CleanShot 2026-06-19 at 12 05 14@2x

What's Changed

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.5.2...v0.5.3

v0.5.0

LaraDocs v0.5.0 🎉

We're halfway to v1.0! This release brings two new quality-assurance commands, multi-version documentation, and full internationalisation support with a language switcher.

✨ Highlights

🌍 Internationalisation LaraDocs now speaks more than one language. This release adds per-language pages and a language switcher (#18), so your docs can serve a global audience out of the box. Translations are managed through Crowdin, with several rounds of updates landing in this cycle.

📚 Multi-version documentation You can now publish and maintain docs across multiple versions of your project, letting readers browse the docs that match the release they're actually running.

🔍 New docs:check command A validation command that catches broken links, detects orphaned pages, and flags redirect cycles before they reach your readers.

📝 New docs:lint command Validates front-matter across your documentation so misconfigured or incomplete page metadata gets caught early.

What's Changed

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.4.0...v0.5.0

v0.4.0

🚀 LaraDocs v0.4.0

This one is packed. New CLI, fancy diagrams, math rendering, and your docs now speak more languages than ever. Let's dig in. 👇

✨ Highlights 🖥️ Deploy CLI has landed! Log in, deploy, clone projects, and manage config right from your terminal. (#66) 📊 Mermaid diagrams now render straight from fenced code blocks. Flowcharts in your docs, zero fuss. (#65) 🧮 KaTeX math support is here. Drop in equations and watch them render beautifully. (#80) 🌍 Localisation goes big. The docs UI is now fully localisable (#67), with automatic locale detection from your lang/vendor/laradocs/ filesystem. (#76) 🧩 Blade components inside markdown. Mix and match your favorite components right in your docs. (#84) 🏷️ Auto-generated tag index pages so your content organizes itself. (#83)

🧪 Under the Hood 🎭 Brand new Playwright end-to-end test suite keeping everything rock solid. (#86) 🌐 Fresh Crowdin translation updates rolling in across the board. (#78, #79, #85)

🔧 Dependency Bumps ⬆️ jsdom 25.0.1 → 29.1.1 (#81) ⬆️ laravel/scout ^10.0 → ^11.2 (#82)

📜 Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.3.0...v0.4.0 Happy documenting! 💙

What's Changed

New Contributors

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.3.0...v0.4.0

v0.3.0

What's Changed

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.2.0...v0.3.0

v0.2.0.1

Note

This is a re-release of v2.0.0 due to an error with Packagist/Composer. There no changes between versions.

What's Changed

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.1.4...v0.2.0.1

v0.2.0

Re-released due to Packagist error.

What's Changed

Full Changelog: https://github.com/PeteBishwhip/laradocs/compare/v0.1.4...v0.2.0

v0.1.2

Highlights

Mobile responsiveness pass and a smarter edit-link template.

Mobile responsiveness

  • Mobile TOC. A collapsed <details> disclosure now renders beneath the page header on small screens (any viewport that hides the right-hand TOC, currently <1180px). Tap to expand the full heading list; caret rotates, list scrolls with overscroll-behavior: contain.
  • Narrow viewport polish. At ≤860px the tabs strip and content padding align, the prev/next pager stacks, page title and empty-state scale down, the footer stacks, and wide tables get horizontal scroll instead of busting the layout. At ≤480px content padding tightens further and the page title shrinks again.
  • The LARADOCS_EDIT_URL template now supports three placeholders:
    • {file} — the real path on disk with its actual extension (handles section _index.md pages and any custom docs.extensions value). Recommended.
    • {path} — same as {file} with the extension stripped. Back-compat with templates that hard-code .md.
    • {ext} — just the extension.
  • Extension handling now uses pathinfo() rather than a hard-coded md|markdown regex, so unusual extensions are stripped correctly too.

Migrate your existing LARADOCS_EDIT_URL from …/docs/{path}.md to …/docs/{file} to pick up the section-landing fix automatically.

v0.1.1

Highlights

A redesigned UI, comprehensive docs, and a handful of correctness fixes.

UI redesign

  • Clean, modern Laravel-leaning aesthetic: Inter throughout, Laravel red (#FF2D20) accent, hairline borders, no editorial flourishes.
  • Sectioned tabs strip below the header — one tab per sidebar group.
  • ⌘K command palette with fuzzy filter (replaces the old inline search box; centred in the header on desktop, falls back inline on narrow screens).
  • Right-hand TOC is now a position-based scrollspy that gives every heading a slice of the scroll range — tail headings that can never reach the trigger line still highlight as you read them.
  • Sidebar and TOC are independent scroll containers below the sticky header + tabs, with overscroll-behavior: contain so wheel events stop chaining into the page.
  • Scroll-margin tuned so clicking a TOC link lands the heading just below the sticky bar (no more headings hiding behind the header).

Docs

  • Documentation parity audit + rewrite. Every config key, command, macro, front-matter field, markdown extension and Facade method is now covered.
  • New guide/cli.md (every Artisan command) and guide/api.md (Facade + DocumentTree / DocumentCollection / Document / Metadata).
  • Expanded coverage of presets, command palette, edit links, footer, header links, accent/font overrides; macros gain the embed entry plus named-vs-positional argument syntax; rich-content covers footnotes, attribute lists and all six callout variants.

Fixes

  • composer serve no longer 500s on first hit: workbench now uses CACHE_STORE=array / SESSION_DRIVER=array instead of the empty in-memory cache table.
  • AssetController no longer hard-codes a 24-hour Cache-Control header — consumers can attach their own caching middleware.
  • Duplicate-title detection on show.blade.php strips the permalink anchor # text before comparing, so a body # Title matching the page title is actually de-duped.
  • ui.accent default changed from #2563eb → #FF2D20 so the inline override matches the bundled CSS.

Compatibility

Behavioural changes worth noting:

  • The legacy inline <input> search box is gone — ⌘K opens the command palette instead. Keep the old behaviour by setting LARADOCS_SEARCH=false and reaching for a published header partial.
  • AssetController no longer emits Cache-Control headers. If you relied on the 24-hour cache, attach a caching middleware to the laradocs.asset route in your app.
Edit this page