Skip to content

Arc

Put Arc and Arc Pro items on Khaeli tokens.

Arc is a separate component library with its own registries and its own licence. Its items read Arc's custom properties: --accent, --surface, --text-sm, --radius-panel and the rest. Arc theme declares those names with Khaeli values, so an Arc item takes the Khaeli palette, the type roles, the 30px control and the radius ladder, and follows .dark.

Only the variable names come from Arc. No Arc or Arc Pro source is in the Khaeli Registry.

Install the theme

Install Foundation first, as Installation shows, then the theme:

npx shadcn@latest add @khaeli/arc-theme
  • Install it after foundation, and again whenever you add foundation again.
  • It stands in for Arc's own foundation. Arc's installation guide adds Arc's foundation item and imports its foundation.css at the root: skip both.

Add Arc items

Arc items come from Arc's own registries, under Arc's licence. Its installation guide gives the registry entry, which sits beside @khaeli:

components.json
{
  "registries": {
    "@khaeli": "https://ui.khaeli.com/r/{name}.json",
    "@uiarc": "https://uiarc.dev/r/{name}.json"
  }
}

Then install an item by name, as Arc documents:

npx shadcn@latest add @uiarc/button

Arc Pro items install from Arc's token-gated registry with a Pro token. Arc's documentation has the entry and the token setup; this site does not repeat them.

What to know

  • Dark mode. Arc switches on data-theme="dark"; Khaeli switches on the .dark class. Set the class on <html>, or both.
  • The accent. Arc's --accent is the ink of what is selected, which is Khaeli's primary, so the theme gives --accent to Arc. Tailwind's accent colours move to --secondary, the same fill, so bg-accent in Khaeli components keeps its look.
  • Keyboard focus. The theme draws a 2px outline in the Khaeli ring colour on an Arc item's :focus-visible. Text fields, menu rows and options keep their own focus state, and Khaeli components, which carry data-slot, draw their own ring.
  • Gradients. Arc's brand wash resolves to a flat neutral: Khaeli surfaces carry no decorative gradient.

Licence

  • Arc's free items are MIT. Arc Pro source is licensed and may not be redistributed, even modified, so none of it is in this Registry or on this site. See Arc's licence.
  • Motion tokens is the one Arc file here: an unchanged copy of Arc's free motion tokens, with its MIT notice in the file.

What the theme maps

Every variable the item declares, read from the item itself. Names that foundation already defines with the meaning Arc gives them are not here, because foundation supplies them: --background, --foreground, --border, --surface-raised, --info, --warning, --radius-control, --tone-violet, --tone-amber, the four durations and the three eases Arc shares with Khaeli.

Arc variableKhaeli value
Light and shared (:root)
--border-strongrgb(from var(--foreground) r g b / 0.16)
--accent-subtlergb(from var(--primary) r g b / 0.12)
--control-on-subtlergb(from var(--control-checked) r g b / 0.1)
--control-thumb#ffffff
--control-thumb-on#ffffff
--surfacevar(--card)
--surface-mutedvar(--secondary)
--text-secondaryvar(--muted-foreground)
--text-mutedvar(--subtle-foreground)
--border-subtlevar(--border)
--accentvar(--primary)
--accent-strongvar(--primary-hover)
--accent-foregroundvar(--primary-foreground)
--control-onvar(--control-checked)
--control-glyphvar(--control-checked-foreground)
--control-fillvar(--control-checked)
--control-trackvar(--input)
--control-track-hovervar(--meter-empty)
--control-thumb-shadow0 3px 8px rgb(0 0 0 / 0.15), 0 3px 1px rgb(0 0 0 / 0.06)
--control-height-sm30px
--control-height-md30px
--control-height-lg36px
--focus-ringtransparent
--focus-outlinevar(--ring)
--focus-outline-width2px
--focus-outline-offset2px
--successvar(--positive)
--dangervar(--destructive)
--tone-greenvar(--positive)
--tone-rosevar(--destructive)
--tone-skyvar(--info)
--tone-tealvar(--tint-mint-foreground)
--tone-orchidvar(--tint-pink-foreground)
--series-1var(--chart-1)
--series-2var(--chart-2)
--series-3var(--chart-3)
--series-4var(--chart-4)
--neutral-0var(--background)
--neutral-1var(--row-hover)
--neutral-2var(--muted)
--neutral-3var(--secondary)
--neutral-4var(--input)
--neutral-5var(--meter-empty)
--neutral-6var(--control-border)
--neutral-7var(--subtle-foreground)
--neutral-8var(--muted-foreground)
--neutral-9var(--muted-foreground)
--neutral-10var(--foreground)
--neutral-11var(--foreground)
--arc-gradientvar(--secondary)
--arc-gradient-softvar(--muted)
--arc-gradient-linevar(--border)
--arc-gradient-inkvar(--foreground)
--arc-gradient-fromvar(--secondary)
--arc-gradient-tovar(--secondary)
--arc-gradient-foregroundvar(--foreground)
--shadow-restingvar(--shadow-control)
--shadow-floatingvar(--shadow-modal)
--radius-panelvar(--radius-card)
--radius-surfacevar(--radius-tray)
--radius-pill9999px
--text-xsvar(--type-caption)
--text-smvar(--type-body)
--text-basevar(--type-title)
--text-lgvar(--type-title)
--text-xlvar(--type-heading)
--text-2xlvar(--type-display)
--text-3xlvar(--type-display)
--text-4xlvar(--type-display)
--text-5xlvar(--type-display)
--leading-bodyvar(--type-body-leading)
--leading-displayvar(--type-display-leading)
--tracking-body0
--tracking-displayvar(--type-display-tracking)
--space-1calc(var(--spacing) * 1)
--space-2calc(var(--spacing) * 2)
--space-3calc(var(--spacing) * 3)
--space-4calc(var(--spacing) * 4)
--space-5calc(var(--spacing) * 5)
--space-6calc(var(--spacing) * 6)
--space-8calc(var(--spacing) * 8)
--space-10calc(var(--spacing) * 10)
--space-12calc(var(--spacing) * 12)
--space-16calc(var(--spacing) * 16)
--space-20calc(var(--spacing) * 20)
--space-24calc(var(--spacing) * 24)
--duration-spring400ms
--ease-in-outvar(--ease-move)
--ease-springvar(--ease-out-strong)
Dark (.dark)
--control-thumb#f1f2f3
--accentvar(--primary)
--accent-foregroundvar(--primary-foreground)
--control-thumb-shadow0 3px 8px rgb(0 0 0 / 0.4), 0 3px 1px rgb(0 0 0 / 0.2)
Tailwind theme (@theme inline)
--color-accentvar(--secondary)
--color-accent-foregroundvar(--secondary-foreground)