nextui.dev
Home
Docs
Saved
Pricing
Components37
  • Forms & inputs7
  • Cards13
  • Buttons, badges & avatars8
  • Feedback & display6
  • Effects3
Agents17
  • Chat inputNew
  • Task checklistNew
  • ReasoningNew
  • Tool callNew
  • Tool approvalNew
  • SourcesNew
  • Agent timelineNew
  • Artifact panelNew
  • Streaming messageNew
  • Conversation shellNew
  • Voice agentNew
  • Voice orbNew
  • Thinking ring
  • Thinking waveNew
  • Thinking sparkle
  • Thinking bot
  • Prompt deckNew
Blocks20
  • Agent chatNew
  • Pill heroNew
  • Grid hero
  • Moodboard generatorNew
  • Waitlist heroNew
  • Intro bannerNew
  • Creative home heroNew
  • Chat heroNew
  • App shelfNew
  • Usage card
  • Design resultsNew
  • Pricing tiers
  • Dashboard home
  • The shiftNew
  • Launch perksNew
  • Testimonials
  • Quote
  • Team
  • Leads tableNew
  • Sign in
Pages10
  • ASCII workspace$49
  • CRM overviewNew
  • Marketing dashboardNew
  • Developer portfolio$49
  • Particle landing$49
  • Particle story$49
  • Statement converter$49
  • AI photo studio$49
  • Group card launch$49
  • Month-end storyNew
Themes9
  • Default
  • Ember
  • Ocean
  • Forest
  • Grape
  • Rose
  • Amber
  • Clay
  • Brutal
Upgrade
nextui.dev

nextui components, blocks and themes you install with one command.

Product

  • Components
  • Blocks
  • Themes
  • Pricing

Resources

  • Docs
  • Roadmap
  • GitHub

Legal

  • License
  • Privacy
  • Terms
  • Refunds

nextUI

[ 200 OK ] · nextUI

© 2026 NEXTUI • All rights reserved.

Upgrade
ComponentsButtons, badges & avatarsIcon buttons
Copy promptCopy prompt

Icon buttons

Secondary, outline and destructive buttons with soft status buttons and animated icons, popping in as one group.

Installation

Set your access key from API keys as NEXTUI_TOKEN in .env.local and add the @nextui namespace below to components.json once. Then every item installs by name. Each install counts as a copy on a free account.

$pnpm dlx shadcn@latest add @nextui/icon-buttons
1{
2 "registries": {
3 "@nextui": {
4 "url": "https://nextui.dev/r/{name}.json",
5 "headers": { "Authorization": "Bearer ${NEXTUI_TOKEN}" }
6 }
7 }
8}

Usage

1"use client";
2
3import { Plus, Send, Rocket } from "lucide-react";
4import { IconButtons } from "@/components/nextui/icon-buttons";
5
6export function Toolbar() {
7 return (
8 <IconButtons
9 actions={[
10 { label: "New task", icon: Plus, variant: "secondary", onClick: () => console.log("new") },
11 { label: "Send", icon: Send, iconPosition: "end", variant: "outline" },
12 ]}
13 statuses={[
14 { label: "Queued", icon: "clock", tone: "bg-violet-500/10 text-violet-600 hover:bg-violet-500/15 dark:text-violet-400" },
15 { label: "Shipping", icon: Rocket, tone: "bg-emerald-500/10 text-emerald-600 hover:bg-emerald-500/15 dark:text-emerald-400" },
16 ]}
17 onStatusClick={(status) => console.log(status.label)}
18 />
19 );
20}

API reference

PropTypeDefaultDescription
actionsActionButtonItem[]Export, Continue, DeletePlain buttons shown first: label, icon, iconPosition, variant, onClick
statusesStatusButtonItem[]8 sample statusesTinted buttons: label, tone classes and a Lucide icon or "clock" | "progress" | "timer"
onStatusClick(status: StatusButtonItem) => void–Called with the status button that was clicked
classNamestring–Extra classes on the wrapper

Related

All components

QR badge

Avatar group

Price badge

Sign in to see the code

Preview it freely. A free account copies code and prompts a few times a day.

Sign in