Documentation

Changelog

Recent releases of Laradocs, pulled live from GitHub.

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

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.