Skip to content

Spring dashed leaders on the docs sidebar #27

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
radiumcoders merged 2 commits into from
Sep 11, 2026
Merged

Spring dashed leaders on the docs sidebar #27

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
071e2cd
feat: spring dashed leaders along the docs sidebar
radiumcoders Sep 11, 2026
7ee0f72
fix: fill the Phosphor Score demo with the dark CRT ground
radiumcoders Sep 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
127 changes: 104 additions & 23 deletions components/docs-sidebar.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
import * as React from "react"
import Link from "next/link"
import { usePathname } from "next/navigation"
import { LayoutGroup, motion, useReducedMotion } from "motion/react"

import { DocsSidebarTrigger } from "@/components/docs-sidebar-trigger"
import { Logo } from "@/components/logo"
Expand Down Expand Up @@ -48,28 +49,78 @@ function isCurrent(pathname: string, url: string) {
return pathname === url
}

const headingClassName =
"mt-4 mb-0.5 h-auto px-3 py-1 truncate text-[11px] font-medium tracking-[0.16em] text-foreground/35 uppercase first:mt-0"

const markSpring = {
type: "spring" as const,
stiffness: 460,
damping: 34,
mass: 0.7,
}

function DashMark({
layoutId,
opacity,
}: {
layoutId: string
opacity: number
}) {
const reduce = useReducedMotion() ?? false

return (
<motion.span
layoutId={layoutId}
aria-hidden
className="pointer-events-none ml-2 h-px min-w-3 flex-1 bg-[repeating-linear-gradient(90deg,currentColor_0_5px,transparent_5px_8px)]"
initial={false}
animate={{ opacity }}
transition={reduce ? { duration: 0 } : markSpring}
/>
)
}

type TabHover = {
hoveredUrl: string | null
onHover: (url: string) => void
}

function PageItem({
node,
pathname,
indented = false,
hoveredUrl,
onHover,
}: {
node: PageNode
pathname: string
indented?: boolean
}) {
} & TabHover) {
const active = isCurrent(pathname, node.url)
const showHover = hoveredUrl === node.url && !active

return (
<SidebarMenuItem>
<SidebarMenuItem
onPointerEnter={() => onHover(node.url)}
onMouseEnter={() => onHover(node.url)}
>
<SidebarMenuButton
render={
<Link href={node.url} aria-label={String(node.name ?? "Page")} />
}
isActive={isCurrent(pathname, node.url)}
isActive={active}
className={cn(
"hover:bg-foreground/5 data-active:bg-foreground/10",
"h-8 gap-0 overflow-visible rounded-lg bg-transparent font-normal text-foreground/45 transition-colors duration-200 hover:bg-transparent hover:text-foreground/80 active:bg-transparent data-active:bg-transparent data-active:font-normal data-active:text-foreground data-active:hover:bg-transparent data-active:hover:text-foreground [&>span:last-child]:overflow-visible [&>span:last-child]:text-clip",
indented && "pl-6"
)}
>
<span className="truncate">{node.name}</span>
<span className="min-w-0 truncate">{node.name}</span>
{active ? (
<DashMark layoutId="docs-sidebar-selected-dashes" opacity={0.85} />
) : null}
{showHover ? (
<DashMark layoutId="docs-sidebar-hover-dashes" opacity={0.4} />
) : null}
</SidebarMenuButton>
</SidebarMenuItem>
)
Expand All @@ -81,9 +132,7 @@ function SeparatorItem({ node }: { node: SeparatorNode }) {
}

return (
<SidebarGroupLabel className="mt-3 truncate text-[11px] font-medium tracking-wide text-muted-foreground uppercase first:mt-0">
{node.name}
</SidebarGroupLabel>
<SidebarGroupLabel className={headingClassName}>{node.name}</SidebarGroupLabel>
)
}

Expand All @@ -95,28 +144,37 @@ function NavItems({
nodes,
pathname,
indented = false,
hoveredUrl,
onHover,
}: {
nodes: TreeNode[]
pathname: string
indented?: boolean
}) {
} & TabHover) {
let inSection = indented

return nodes.map((node, i) => {
if (isPage(node)) {
if (isSeparator(node)) {
if (node.name != null && node.name !== "") {
inSection = true
}
return (
<PageItem
key={node.url}
<SeparatorItem
key={`sep-${String(node.name ?? "")}-${i}`}
node={node}
pathname={pathname}
indented={indented}
/>
)
}

if (isSeparator(node)) {
if (isPage(node)) {
return (
<SeparatorItem
key={`sep-${String(node.name ?? "")}-${i}`}
<PageItem
key={node.url}
node={node}
pathname={pathname}
indented={inSection}
hoveredUrl={hoveredUrl}
onHover={onHover}
/>
)
}
Expand All @@ -127,14 +185,24 @@ function NavItems({
return (
<React.Fragment key={folderKey(node, i)}>
{node.index ? (
<PageItem node={node.index} pathname={pathname} />
<PageItem
node={node.index}
pathname={pathname}
indented={inSection}
hoveredUrl={hoveredUrl}
onHover={onHover}
/>
) : hasSectionedChildren ? null : (
<SidebarGroupLabel>{node.name}</SidebarGroupLabel>
<SidebarGroupLabel className={headingClassName}>
{node.name}
</SidebarGroupLabel>
)}
<NavItems
nodes={node.children}
pathname={pathname}
indented={Boolean(node.index) || !hasSectionedChildren}
indented={inSection || hasSectionedChildren || !node.index}
hoveredUrl={hoveredUrl}
onHover={onHover}
/>
</React.Fragment>
)
Expand All @@ -153,10 +221,23 @@ function NavList({
pathname: string
indented?: boolean
}) {
const [hoveredUrl, setHoveredUrl] = React.useState<string | null>(null)

return (
<SidebarMenu>
<NavItems nodes={nodes} pathname={pathname} indented={indented} />
</SidebarMenu>
<LayoutGroup id="docs-sidebar-tabs">
<SidebarMenu
onPointerLeave={() => setHoveredUrl(null)}
onMouseLeave={() => setHoveredUrl(null)}
>
<NavItems
nodes={nodes}
pathname={pathname}
indented={indented}
hoveredUrl={hoveredUrl}
onHover={(url) => setHoveredUrl(url)}
/>
</SidebarMenu>
</LayoutGroup>
)
}

Expand Down
8 changes: 6 additions & 2 deletions registry/phosphor-score/phosphor-score-demo.tsx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ import { ComponentPreview } from "@/components/component-preview"
import { useHydratedTheme } from "@/hooks/use-hydrated-theme"
import { usePreviewProps } from "@/hooks/use-preview-props"
import {
DARK_BG,
DARK_COLOR,
DEFAULT_DENSITY,
DEFAULT_GLOW,
Expand Down Expand Up @@ -60,9 +61,12 @@ export function PhosphorScoreDemo() {
<>
<ComponentPreview
title="Phosphor Score"
stageClassName="min-h-0 overflow-hidden bg-background p-0"
stageClassName="min-h-0 overflow-hidden p-0"
>
<div className="relative h-[56svh] w-full bg-background">
<div
className="relative h-[56svh] w-full overflow-hidden rounded-[inherit] bg-background"
style={theme === "dark" ? { backgroundColor: DARK_BG } : undefined}
>
<PhosphorScore
color={useAutoColor ? undefined : props.color}
glow={props.glow}
Expand Down
Loading