V0.13.0
Name:v0.13.0Status:active

v0.13.0 — Navigation

A focused milestone on navigation primitives. The nav rune learns four contextual layouts (sidebar, header menubar, footer columns, section-landing cards) so a single content model expresses every kind of navigation a site needs — see SPEC-046. Sidebars gain collapsible groups with URL-aware auto-open. A new pagination rune covers prev/next sequential reading flows — see SPEC-047.

Currently planned:

Feature items:

Milestone burndown: 7 open work items remaining; peak 7, started May 150246May 15Jun 15
Open work items Ideal burndown
Progress 0/7 work items

Relationships

Related 9
History 3
  1. 298d4aa
    Created (active)by bjornolofandersson
  2. 29cd7e5
    Content editedby Claude
    plan: split site docs and adoption into dedicated v0.13.0 work items
  3. e9a38e9
    Content editedby Claude
    plan: close v0.12.0, open v0.13.0 with navigation work items
  • WORK-178 — Nav layout foundations: schema + engine wiring for menubar and columns, with Lumina CSS.
  • WORK-179 — Collapsible sidebar: collapsible modifier, NavGroup data-collapsed sentinel, core postProcess auto-open from current URL, nav-collapsible behavior, Lumina styling.
  • WORK-180 — Cards nav layout: extend Frontmatter with optional icon?, enrich NavItem with title/description/icon from the registry, Lumina CSS.
  • WORK-181 — Menubar interactive behavior: nav-menubar (desktop dropdown open/close, mobile hamburger toggle, keyboard navigation, focus management).
  • WORK-182 — Sequential page navigation: pagination rune with auto mode resolving prev/next from declared nav order → frontmatter order → directory order, plus explicit prev/next attributes.

Docs and adoption items:

Work Items

Ready 7
WORK-178 claude/design-tokens-config-njwvw
Nav layout foundations — header menubar and footer columns
Add a layout attribute to the nav rune with values vertical (default, today's behaviour — unchanged), menubar (horizontal, for the header), and columns (column grid, for the footer). Same content model in all three; theme decides the rendering. This is the foundation slice — interactive dropdown / hamburger behaviour (WORK-181), the cards layout (WORK-180), and the collapsible sidebar (WORK-179) all build on the engine plumbing landed here.
high moderate
0/8 criteria
WORK-179 claude/design-tokens-config-njwvw
Collapsible sidebar nav with URL-aware auto-open
Add a collapsible modifier to the nav rune that turns each NavGroup into a collapsible disclosure. Default behaviour: the group containing the current page auto-expands; all others start collapsed. Authors can override per-group via a defaultOpen attribute. Authors never write per-heading state markers; the postProcess pipeline figures out "which one is open" from the current URL.
high moderate
0/10 criteria
WORK-180 claude/design-tokens-config-njwvw
Cards nav layout with frontmatter enrichment
Add layout="cards" to the nav rune for section landing pages. Each item renders as a card; the postProcess pipeline enriches NavItems with title, description, and icon resolved from the linked page's frontmatter via the entity registry. Group headings (##) become section titles above each card grid. Combines with auto to list a section's children automatically without naming each one.
medium moderate
0/9 criteria
WORK-181 claude/design-tokens-config-njwvw
Menubar interactive behavior — dropdowns, hamburger, keyboard
Layer interaction on top of the static menubar layout from WORK-178. On desktop, group triggers open submenus on click (and optionally hover); on mobile, the entire menubar collapses behind a hamburger trigger and groups become accordion sections. Includes keyboard navigation, focus management, and dismissal — all the affordances a real navigation menu needs.
high moderate
0/10 criteria
WORK-182 claude/design-tokens-config-njwvw
Pagination rune for sequential page navigation
Add a pagination rune for prev/next links in sequential reading flows — tutorials, ordered docs, recipes. {% pagination auto /%} derives sibling order from any declared nav rune, falling back to frontmatter order, then directory order. {% pagination prev="..." next="..." /%} is the explicit escape hatch when authors want a curated sequence. Resolution piggybacks on the existing sentinel-postProcess pattern used by breadcrumb auto and nav auto.
medium moderate
0/12 criteria
WORK-183 claude/design-tokens-config-njwvw
Site reference docs for new nav layouts and the pagination rune
Update site/content/runes/nav.md so it documents every new layout value with live preview blocks, and create site/content/runes/pagination.md from scratch covering both auto and explicit forms. Reference-doc work only — site adoption (changing _layout.md files in production) is owned by WORK-184.
medium small
0/26 criteria
WORK-184 claude/design-tokens-config-njwvw
Adopt new nav layouts and pagination across refrakt.md
Roll the new navigation primitives out to the refrakt.md site itself — eat our own dog food. Top-level _layout.md switches header to menubar and footer to columns. Docs and runes sidebars become collapsible. At least one section landing adopts the cards layout. Docs and runes _layout.md files add {% pagination auto /%} for sequential reading.
medium small
0/21 criteria