Buttons

Button

Server Component

Clickable action with variants, sizes and asChild.

Import

tsx

import { Button } from "@cronus-ui/ui";

bash

npx cronus-ui add button

Examples

Variants

Six visual styles, from the primary call-to-action down to a subtle link.

tsx

<div className="flex flex-wrap items-center gap-3">
  <Button variant="primary">Primary</Button>
  <Button variant="secondary">Secondary</Button>
  <Button variant="outline">Outline</Button>
  <Button variant="ghost">Ghost</Button>
  <Button variant="destructive">Destructive</Button>
  <Button variant="link">Link</Button>
</div>

Sizes

Three text sizes plus square icon sizes for toolbar-style actions.

tsx

<div className="flex flex-wrap items-center gap-3">
  <Button size="sm">Small</Button>
  <Button size="md">Medium</Button>
  <Button size="lg">Large</Button>
  <Button size="icon" aria-label="Settings">
    <Settings />
  </Button>
  <Button size="icon-sm" aria-label="Settings">
    <Settings />
  </Button>
</div>

With icons

Icons sit inline with the label. Use a Spinner for loading state and disable to block input.

tsx

<div className="flex flex-wrap items-center gap-3">
  <Button>
    <Download />
    Download
  </Button>
  <Button variant="secondary">
    Continue
    <ArrowRight />
  </Button>
  <Button variant="outline">
    <Heart />
    Like
  </Button>
  <Button disabled>
    <Heart />
    Disabled
  </Button>
  <Button disabled>
    <Spinner size="sm" aria-hidden="true" />
    Saving
  </Button>
</div>

As link

Use `asChild` to render the button styles on another element, such as an anchor.

Read the docs

tsx

<Button asChild>
  <a href="/docs">
    Read the docs
    <ArrowRight />
  </a>
</Button>

.cronus

The same component declared in Cronus. Emitted at build time from the audit fixtures — the kernel renders it as HTML with no React.

PortedParity: MatchGeometry 3/3Pixel diff 0 pxLogic 6/6Parity scoreboard

as-link.cronus

app "audit-fixtures" {
  port 5176
}

style {
  preset aurora
  theme dark
}

component ButtonAsLink layout:inline style:button+link+md {
  label "Docs" -> "/docs"
}

page "/audit/button/as-link" type:custom {
  use ButtonAsLink
}

disabled.cronus

app "audit-fixtures" {
  port 5176
}

style {
  preset aurora
  theme dark
}

component ButtonDisabled layout:inline style:button+primary+md {
  disabled:true
  label "Save profile"
}

page "/audit/button/disabled" type:custom {
  use ButtonDisabled
}

primary-md.cronus

app "audit-fixtures" {
  port 5176
}

style {
  preset aurora
  theme dark
}

component ButtonPrimaryMd layout:inline style:button+primary+md {
  label "Save profile"
}

page "/audit/button/primary-md" type:custom {
  use ButtonPrimaryMd
}

API Reference

Generated from the component's exported types.

ButtonProps

Extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants>

Prop	Type	Default	Description
`asChild`	`boolean`	`false`	Render as the child element via Slot.
`variant`	`"primary" \| "secondary" \| "outline" \| "ghost" \| "destructive" \| "link"`	`"primary"`	One of "primary" \| "secondary" \| "outline" \| "ghost" \| "destructive" \| "link".
`size`	`"sm" \| "md" \| "lg" \| "icon" \| "icon-sm"`	`"md"`	One of "sm" \| "md" \| "lg" \| "icon" \| "icon-sm".
`children`	`ReactNode`	—	Contents of the component.
`className`	`string`	—	Additional class names merged onto the root.
`type`	`string`	—	Native type of the underlying element.
`disabled`	`boolean`	—	Disables pointer and keyboard interaction.
`onClick`	`(event: MouseEvent) => void`	—	Click handler.