Skip to content

Update docs for twelve-ui changes#628

Open
formfcw wants to merge 4 commits into
mainfrom
florian/twelve-ui-updates
Open

Update docs for twelve-ui changes#628
formfcw wants to merge 4 commits into
mainfrom
florian/twelve-ui-updates

Conversation

@formfcw
Copy link
Copy Markdown
Contributor

@formfcw formfcw commented Apr 13, 2026

Summary

Docs updates for the Directus 12 studio design refresh (directus/directus#27394).

Extension guides

  • private-view slots table (5.modules.md): clarified the new layout in line with the actual code changes.
    • headline slot is deprecated (not removed). Existing content now renders prepended to the title.
    • actions:append slot is deprecated (not renamed). Existing content keeps rendering in the secondary actions zone alongside the actions slot.
    • actions:primary is a new slot for the page's primary CTA (labeled, prominent button).
    • Added a callout explaining the primary vs. secondary actions split.
  • Theme example (6.themes.md): updated to use the new shell scope, and added a migration callout listing the v12 theme schema breaking changes:
    • navigation.* / header.* background & border tokens → moved to shell.* (CSS vars --theme--navigation--* / --theme--header--*--theme--shell--*).
    • header.headline.foreground / header.headline.fontFamily removed alongside the headline slot.
    • borderColorFocus, boxShadowHover, boxShadowFocus → replaced by focusRingColor (--theme--form--field--input--focus-ring-color).
    • navigation.project.* removed.
    • section.toggle.borderWidth / section.toggle.borderColor removed (use section-level border tokens).
    • headerShadow / sidebarShadow no longer exposed by defineLayout(); boxShadow removed from header theme rules.

Tutorials

Refreshed the two module tutorials that still demonstrated deprecated APIs:

  • understand-available-slots-in-custom-modules.md: dropped the headline slot section (used v-breadcrumb, both deprecated), removed rounded from all v-button examples (prop deprecated, no functional impact), and added a section showing the new actions:primary slot.
  • implement-navigation-in-multipage-custom-modules.md: removed the entire breadcrumb workflow (refs, render logic, #headline slot, screenshots) since both v-breadcrumb and #headline are deprecated in v12.

@formfcw formfcw requested a review from a team as a code owner April 13, 2026 11:55
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 18, 2026 5:46pm

Request Review

…e migration callout; refresh module tutorials
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant