Navigation

StickyTOC

Table of contents that sticks while scrolling and highlights the active section via IntersectionObserver.

Quick Preview

Scroll down through this page — the TOC on the left tracks the active section in real time.

Introduction

Installation

Basic Usage

Variants

Accessibility

Installation

// Copy from
src/components/navigation/StickyTOC.tsx

Usage

import StickyTOC from '@/components/navigation/StickyTOC'

const tocItems = [
  { id: 'intro', label: 'Introduction' },
  { id: 'usage', label: 'Basic Usage' },
  { id: 'props', label: 'Props' },
]

// Each section must have a matching id and scroll-mt to clear the navbar
export default function DocsPage() {
  return (
    <div className="flex gap-10">
      <StickyTOC items={tocItems} title="On this page" />
      <main>
        <section id="intro" className="scroll-mt-24">...</section>
        <section id="usage" className="scroll-mt-24">...</section>
        <section id="props" className="scroll-mt-24">...</section>
      </main>
    </div>
  )
}

Prompt Preview

Copy a prompt that recreates this UI

Paste this into your AI coding assistant to generate code that closely matches the reference, including color, size, shape, typography, spacing, and polish.

Copy-ready AI prompt

Starts from the current visual reference and project constraints.

Build a navigation component named StickyTOC in React/Next.js.
Goal: recreate the same overall UI and behavior as the StickyTOC reference from a component gallery.
What it needs to communicate: Table of contents that sticks while scrolling and highlights the active section via IntersectionObserver..

Project constraints:
- Use Next.js 16.2.6 with the App Router, React 19, TypeScript strict mode, and Tailwind CSS v4.
- Do not create a tailwind.config.js file. Use Tailwind v4 utilities and CSS variables where design tokens are needed.
- If you are implementing this inside the same project, use the Prompt font via next/font/google. If not, use the closest equivalent typeface.
- Return production-ready code with imports, responsive behavior, keyboard accessibility, and polished empty, hover, focus, active, and disabled states where relevant.
- Match the reference closely: color palette, spacing scale, border radius, shadows, icon scale, typography hierarchy, and motion timing.

Component-specific expectations:
- Handle hover, active, selected, keyboard, and mobile states with clear feedback.
- Keep structure tidy so it feels production-ready rather than demo-only.
- Avoid unnecessary dependencies unless the behavior truly requires them.
- No explicit color literals were found in the examples. Match the live reference and the project accent color when appropriate.

Props to support:
- items: TocItem[] — required — Array of {id, label, level?}
- title: string — default 'On This Page' — Heading above the list

Reference usage patterns:
- No examples were documented. Infer a sensible default presentation and one richer usage example.

Feature expectations:
- IntersectionObserver
- Smooth scroll
- Multi-level support
- Active highlight

Output requirements:
- Return complete code, not pseudocode.
- Include all necessary imports and helper types.
- Keep the implementation accessible, responsive, and visually finished.
- Match the reference for color, size, shape, typography, spacing, and interaction states as closely as possible.
- If multiple files are needed, organize them cleanly and explain the file structure briefly.

Tweak only product-specific copy or data after the first generation pass.

Props

Prop	Type	Default	Description
`items`*	`TocItem[]`	-	Array of {id, label, level?}
`title`	`string`	`'On This Page'`	Heading above the list