Nav List Card

Overview

A compact navigation card that lists links with icons, with a spring slide on hover.

This navigation component is intended for interfaces that need a compact navigation card that lists links with icons, with a spring slide on hover, application shells, and dashboards. Its implementation is provided as editable source so the final behavior and styling stay inside your project.

Technologies

React
TypeScript
Tailwind CSS
Motion

Detected package dependencies: motion, lucide-react.

@spectrumui/nav-list-card

Planning

Support

Installation

Login to view commandCreate a free account to access the install command

Usage

import { NavListCard } from "@/components/spectrumui/nav-list-card"
import { BookOpen, CircleHelp } from "lucide-react"
<NavListCard
  title="Support"
  items={[
    { icon: <CircleHelp />, label: "Help Center", href: "/help" },
    { icon: <BookOpen />, label: "Docs", href: "/docs" },
  ]}
/>

API Reference

NavListCard

Renders a small titled card with one pill row per item. Items with an href render as links, the rest as buttons. Two item sets ship with the component: PLANNING_NAV_ITEMS (the default) and SUPPORT_NAV_ITEMS.

PropTypeDefaultDescription
items{ icon?: ReactNode; label: string; href?: string }[]-Rows to render; defaults to PLANNING_NAV_ITEMS
titlestring"Planning"Small caption above the list
classNamestring-Additional classes merged with the root styles

Use cases

  • interfaces that need a compact navigation card that lists links with icons, with a spring slide on hover
  • application shells
  • dashboards

Features

  • Copy-paste source that remains in your repository
  • TypeScript source included with the component
  • Tailwind CSS classes editable in the component source
  • Animation implemented with Motion

Accessibility

  • No reduced-motion marker was detected; add or verify a reduced-motion path before production use.
  • Test focus order, keyboard operation, labels, contrast, and screen-reader output in the final application context.

Customization

  • Edit the Tailwind utility classes in the copied source to match your spacing, color, and typography tokens.
  • Use the documented className surface for local layout adjustments, then edit the source for structural changes.
  • Adjust Motion transitions in the source and keep the reduced-motion behavior aligned with the final interaction.

Related components

Tree Nav
A nav list with a tree rail and a spring marker that follows hover and settles on the active link.
Accordion
A vertically stacked set of interactive headings that each reveal a section of content.
Animated Drawer
A drawer panel that slides in smoothly for menus, settings, and sidebars.
FAQ Tabs Card
A tabbed FAQ card with animated accordion answers and a support footer.

Nav List Card FAQ

Is Nav List Card free to use in commercial projects?

Yes. The public Nav List Card source is available under the Apache License 2.0, including for commercial use, subject to the LICENSE terms.

How do I install Nav List Card?

Run npx shadcn@latest add @spectrumui/nav-list-card. The page also exposes the source for manual installation.

Does Nav List Card require Motion?

Yes. Motion usage was detected in the documented source or registry dependencies for Nav List Card.

Does Nav List Card use shadcn/ui or Radix UI?

No shadcn/ui or Radix UI dependency was detected in the documented Nav List Card source.

Can I use Nav List Card in Next.js?

The documented React source is used in this Next.js application. Keep its use client directive when copying it into the App Router. Install the detected dependencies and verify any application-specific data or image configuration.

What accessibility checks should I run for Nav List Card?

No component-specific accessibility mechanism was detected automatically. Test keyboard operation, focus, labels, contrast, and screen-reader output before shipping.

Work with me