Sidebar with collapsible sections
A sidebar with collapsible sections.
Preview
Built with
The components this screen renders, through their own templates. Changing one of them, or a token they read, changes this screen.
Design system gaps
What the design system lacks to render the original as it is. The screen fills each gap with native HTML on semantic tokens until a component or a token covers it.
- Collapsing the sidebar (off canvas or to an icon rail) has no pattern without script yet.
- The sidebar navigation (groups, items, sub-items, current item) is native HTML on semantic tokens: there is no Navigation component yet.
- Collapsible groups are native details elements on semantic tokens: there is no Disclosure component yet.
- Menus whose trigger is a whole row (team, version or user switcher) use the Dropdown next to the row: its trigger is a Button with a text label, it cannot hold an avatar or two lines.
Changes from the original
- The sidebar does not collapse (that needs script, and so does the trigger button): it is always expanded on wide screens and stacks above the content on narrow ones. The sidebar trigger and its separator are dropped.
- The rail that resizes the sidebar is dropped.
- Rebuilt as static HTML with the design system's component templates; every color, type style, radius, border and spacing comes from its tokens.
- The original visual design (Tailwind classes, the Geist font) is not reused.
- Lucide and Tabler icons are remapped to Material Symbols; brand logos (Apple, Google, GitHub, Meta) are dropped, the buttons keep their text.
- Placeholder images are drawn with semantic tokens.
- No script: behaviour that needs JavaScript (collapsing the sidebar, toasts, drag and drop, client-side tables) is dropped or simplified, and each screen says so.
Code
The HTML the screen renders, from apps/docs/screens/shadcn-ui/sidebar-02.screen.mjs, with the stylesheets of @quantum-ds/tokens, the reference implementation (packages/components/src/) and apps/docs/screens/screens.css.
HTML
<div class="scr-viewport">
<div class="scr-screen">
<div class="scr-shell" data-variant="sidebar" data-side="left">
<nav class="scr-sidebar" aria-label="Documentation">
<div class="scr-sidebar__header">
<div class="scr-identity">
<span class="scr-tile-mark">
<span
class="ds-icon"
data-size="small"
data-color="current"
aria-hidden="true"
>view_agenda</span>
</span>
<span class="scr-identity__text">
<span class="scr-identity__title">Documentation</span>
<span class="scr-identity__subtitle">v1.0.1</span>
</span>
<div class="ds-dropdown">
<button
type="button"
class="ds-button ds-dropdown__trigger"
data-emphasis="ghost"
data-intent="neutral"
data-size="xsmall"
data-part="trigger"
id="sidebar-02-version-trigger"
popovertarget="sidebar-02-version"
>
<span
class="ds-button__label"
data-part="label"
>Version</span>
<span
class="ds-button__icon"
data-part="icon"
data-position="end"
aria-hidden="true"
>expand_more</span>
</button>
<div
class="ds-dropdown__menu"
data-part="menu"
id="sidebar-02-version"
popover
aria-labelledby="sidebar-02-version-trigger"
>
<ul class="ds-dropdown__group" data-part="group">
<li>
<button
type="button"
class="ds-dropdown__item"
data-part="item"
data-intent="neutral"
popovertarget="sidebar-02-version"
popovertargetaction="hide"
>
<span
class="ds-dropdown__item-icon"
data-part="item-icon"
aria-hidden="true"
>check</span>
<span
class="ds-dropdown__item-label"
data-part="item-label"
>v1.0.1</span>
</button>
</li>
<li>
<button
type="button"
class="ds-dropdown__item"
data-part="item"
data-intent="neutral"
popovertarget="sidebar-02-version"
popovertargetaction="hide"
>
<span
class="ds-dropdown__item-label"
data-part="item-label"
>v1.1.0-alpha</span>
</button>
</li>
<li>
<button
type="button"
class="ds-dropdown__item"
data-part="item"
data-intent="neutral"
popovertarget="sidebar-02-version"
popovertargetaction="hide"
>
<span
class="ds-dropdown__item-label"
data-part="item-label"
>v2.0.0-beta1</span>
</button>
</li>
</ul>
</div>
</div>
</div>
<form role="search" action="#">
<div class="ds-search-field" data-size="small">
<label
class="ds-search-field__label"
data-part="label"
for="sidebar-02-search"
>Search</label>
<div class="ds-search-field__field" data-part="field">
<span
class="ds-search-field__icon"
data-part="icon"
aria-hidden="true"
>search</span>
<input
type="search"
class="ds-search-field__control"
data-part="control"
id="sidebar-02-search"
name="q"
placeholder="Search the docs..."
>
</div>
</div>
</form>
</div>
<div class="scr-sidebar__content">
<div class="scr-nav-group" data-collapsible>
<details open>
<summary class="scr-nav__summary">
<span class="scr-nav__label">Getting Started</span>
<span class="scr-nav__chevron">
<span
class="ds-icon"
data-size="small"
data-color="current"
aria-hidden="true"
>chevron_right</span>
</span>
</summary>
<ul class="scr-nav">
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Installation</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Project Structure</span>
</a>
</li>
</ul>
</details>
</div>
<div class="scr-nav-group" data-collapsible>
<details open>
<summary class="scr-nav__summary">
<span class="scr-nav__label">Build Your Application</span>
<span class="scr-nav__chevron">
<span
class="ds-icon"
data-size="small"
data-color="current"
aria-hidden="true"
>chevron_right</span>
</span>
</summary>
<ul class="scr-nav">
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Routing</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#" aria-current="page">
<span class="scr-nav__label">Data Fetching</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Rendering</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Caching</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Styling</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Optimizing</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Configuring</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Testing</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Authentication</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Deploying</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Upgrading</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Examples</span>
</a>
</li>
</ul>
</details>
</div>
<div class="scr-nav-group" data-collapsible>
<details open>
<summary class="scr-nav__summary">
<span class="scr-nav__label">API Reference</span>
<span class="scr-nav__chevron">
<span
class="ds-icon"
data-size="small"
data-color="current"
aria-hidden="true"
>chevron_right</span>
</span>
</summary>
<ul class="scr-nav">
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Components</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">File Conventions</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Functions</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">next.config.js Options</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">CLI</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Edge Runtime</span>
</a>
</li>
</ul>
</details>
</div>
<div class="scr-nav-group" data-collapsible>
<details open>
<summary class="scr-nav__summary">
<span class="scr-nav__label">Architecture</span>
<span class="scr-nav__chevron">
<span
class="ds-icon"
data-size="small"
data-color="current"
aria-hidden="true"
>chevron_right</span>
</span>
</summary>
<ul class="scr-nav">
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Accessibility</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Fast Refresh</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Next.js Compiler</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Supported Browsers</span>
</a>
</li>
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Turbopack</span>
</a>
</li>
</ul>
</details>
</div>
<div class="scr-nav-group" data-collapsible>
<details open>
<summary class="scr-nav__summary">
<span class="scr-nav__label">Community</span>
<span class="scr-nav__chevron">
<span
class="ds-icon"
data-size="small"
data-color="current"
aria-hidden="true"
>chevron_right</span>
</span>
</summary>
<ul class="scr-nav">
<li class="scr-nav__item">
<a class="scr-nav__link" href="#">
<span class="scr-nav__label">Contribution Guide</span>
</a>
</li>
</ul>
</details>
</div>
</div>
</nav>
<div class="scr-main">
<header class="scr-header" data-sticky>
<nav
class="ds-breadcrumb"
aria-label="Breadcrumb"
data-size="small"
>
<ol class="ds-breadcrumb__list" data-part="list">
<li class="ds-breadcrumb__item" data-part="item">
<a
class="ds-breadcrumb__link"
data-part="link"
href="#"
>Build Your Application</a>
<span
class="ds-breadcrumb__separator"
data-part="separator"
aria-hidden="true"
>chevron_right</span>
</li>
<li class="ds-breadcrumb__item" data-part="item">
<span
class="ds-breadcrumb__link"
data-part="link"
aria-current="page"
>Data Fetching</span>
</li>
</ol>
</nav>
</header>
<main class="scr-content">
<h1 class="scr-sr">Data Fetching</h1>
<div class="scr-stack" aria-hidden="true">
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
<div class="scr-tile" data-size="row"></div>
</div>
</main>
</div>
</div>
</div>
</div>