Tabs
Freev1.0.0Tabs with a sliding underline, error marks per tab and panels that keep their edits.
Build for your project
Code/install build
Usage
Import it and pass your content. The props that matter most are listed next.
Example
import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/notchset/tabs";
export function Settings({ errors }: { errors: number }) {
return (
<Tabs defaultValue="general">
<TabsList aria-label="Project settings">
<TabsTrigger value="general" errors={errors}>General</TabsTrigger>
<TabsTrigger value="members">Members</TabsTrigger>
</TabsList>
<TabsContent value="general" keepMounted>General settings</TabsContent>
<TabsContent value="members">Members</TabsContent>
</Tabs>
);
}Props
activation–'automatic' | 'manual'Automatic: arrow keys select. Manual: arrows move focus; Enter or Space selects.
errors (TabsTrigger)–numberMarks the tab with a signal dot and count, read out as errors.
keepMounted (TabsContent)–booleanKeep the panel mounted so unsaved edits survive switching.
Anatomy
- Same parts as shadcn's Tabs, so existing markup works.
- The underline follows a selection made from code too.
- Error counts come from your form; the tab only shows them.
Tabsdata-slot="tabs"Root; holds the value and activation mode.
TabsListdata-slot="tabs-list"The bar and its underline.
TabsTriggerdata-slot="tabs-trigger"A tab, with an optional error count.
TabsContentdata-slot="tabs-content"A panel.
Source
components/ui/notchset/tabs.tsx
Loading the code
Build for your project
Code/install build
Installation
Base UI
pnpm dlx shadcn@latest add https://notchset.dev/r/tabs.jsonRadix
pnpm dlx shadcn@latest add https://notchset.dev/r/radix-nova/tabs.jsonFree, no account or key. Use the command for your project's primitives: a radix-*, new-york or default style in components.json is Radix, a base-* style is Base UI. With the @notchset registry added, @notchset/<name> picks for you.
Install by hand
- 1. Add the packages
pnpm add @base-ui/react@^1 - 2. Copy the files to these paths (the source, or save them all as a .zip)
- components/ui/notchset/tabs.tsx
- lib/beautiful-ui/notchset/tabs.tsx
- lib/beautiful-ui/notchset/instrument.tsx
- lib/beautiful-ui/notchset/root.ts
- 3. No stylesheet needed.
- 4. Install what it builds on first: shadcn's cn helper (lib/utils.ts, from npx shadcn init), the theme foundation (its tokens and base styles)
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Use it for
- Settings that split into sections
- Views of one object that users switch between
Use something else when
- Two or three options that change a value: use Segmented Control
- Steps in order: use Stepper
Mistakes to avoid
- Name the TabsList (aria-label) when the page has more than one
- Use keepMounted for forms, not for heavy panels
Agents find it by
- tabs, tab bar, settings sections, segmented panels, tablist, Notchset
Where agents read it
- Guide for this component: https://notchset.dev/md/tabs.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Behaviour
Keyboard
- ← →
- Move between tabs (and select, in automatic mode)
- Home / End
- First / last tab
- Enter / Space
- Select (manual mode)
Accessibility
- The primitive's tablist, tab and tabpanel roles, with roving focus
- Error counts are read with the tab name ('General 1 error')
- Disabled tabs are skipped by the arrow keys
Motion
- Select
- The underline slides; the edge leaving the old tab goes first (340ms glide, 80ms lead)
Responsive
- The bar scrolls sideways when tabs don't fit and keeps the active one in view.
Performance
- The underline measures one element on change; nothing runs while idle.
Changelog
v1.0.0 · 2026-10-04
First release
