Version 1.0.0Light + Dark

Aura Design System V1

A complete, token-driven design system for calm, premium product interfaces — foundations, 128 tokens, 20 components, patterns and accessibility guidance, ready for design and code.

Tokens
128
Components
20
Colors
73

Foundations

Color, type, spacing, radius, elevation and motion — one visual language everywhere.

Tokens first

Primitive → semantic → component. Change a token, update every surface.

Accessible by default

WCAG 2.2 AA targets, measured contrast pairs and visible focus on every component.

01 · Foundations

Foundations

The raw materials of Aura. Every color below is a live token — click any swatch to copy its hex.

Brand colors

Status colors

Color scales

Slate — neutrals

50100200300400500600700800900950

Blue — primary

50100200300400500600700800900950

Violet — secondary

50100200300400500600700800900950

Cyan — progress

50100200300400500600700800900950

Typography — Plus Jakarta Sans

Display

48px · 800 · 1.1

Design once

Heading 1

36px · 800 · 1.15

Build consistent products

Heading 2

30px · 700 · 1.2

Foundations first

Heading 3

24px · 700 · 1.25

Components that compose

Heading 4

20px · 700 · 1.3

Patterns for real work

Body large

18px · 400 · 1.6

Lead paragraphs and introductions use body large for comfortable reading.

Body

16px · 400 · 1.6

Default interface and article copy. Clear, calm and easy to scan at any length.

Body small

14px · 400 · 1.55

Dense UI copy, table cells, helper text and secondary information.

Caption

12px · 600 · 1.4

Timestamps, labels and metadata

Spacing — 4pt system

space.00px
space.14px
space.28px
space.312px
space.416px
space.520px
space.624px
space.832px
space.1040px
space.1248px
space.1664px
space.2080px
space.2496px

Radius

0px

none

4px

sm

8px

md

12px

lg

16px

xl

24px

2xl

9999px

full

Elevation / shadow

shadow.sm
shadow.md
shadow.lg
shadow.xl

Motion

TokenValueUse
duration.fast100msHovers, fades
duration.base200msDefault transitions
duration.slow300msPanels, progress
duration.slower500msPage-level reveals
easing.standardcubic-bezier(0.2, 0, 0, 1)Enter & exit
easing.outcubic-bezier(0, 0, 0.2, 1)Entering elements
easing.incubic-bezier(0.4, 0, 1, 1)Leaving elements

Motion is subtle and functional — this site disables non-essential animation when prefers-reduced-motion is set.

Iconography — Lucide

  • Lucide icons only — one library, consistent stroke.
  • Drawn on a 24px grid, 2px stroke, round caps.
  • UI sizes: 16px inline, 20px in buttons, 24px standalone.
  • Icons support text — they never replace a label for actions.

02 · Design Tokens

Design tokens

Three layers keep the system flexible: primitives hold raw values, semantics assign meaning, components consume semantics. Themes change at the semantic layer — never edit primitives to make a dark mode.

Primitive

70 tokens

Raw scales: colors, spacing, radius. Named by what they are (blue.500).

Semantic

23 tokens

Named by role (text.primary, bg.surface). This is where light/dark values split.

Component

5 tokens

Component-level aliases (card.radius) so components never reach past the semantic layer.

128 tokens shown

TokenValueCategoryPreview
color.primitive.slate.50#F8FAFCPrimitive color
color.primitive.slate.100#F1F5F9Primitive color
color.primitive.slate.200#E2E8F0Primitive color
color.primitive.slate.300#CBD5E1Primitive color
color.primitive.slate.400#94A3B8Primitive color
color.primitive.slate.500#64748BPrimitive color
color.primitive.slate.600#475569Primitive color
color.primitive.slate.700#334155Primitive color
color.primitive.slate.800#1E293BPrimitive color
color.primitive.slate.900#0F172APrimitive color
color.primitive.slate.950#020617Primitive color
color.primitive.blue.50#EFF6FFPrimitive color
color.primitive.blue.100#DBEAFEPrimitive color
color.primitive.blue.200#BFDBFEPrimitive color
color.primitive.blue.300#93C5FDPrimitive color
color.primitive.blue.400#60A5FAPrimitive color
color.primitive.blue.500#3B82F6Primitive color
color.primitive.blue.600#2563EBPrimitive color
color.primitive.blue.700#1D4ED8Primitive color
color.primitive.blue.800#1E40AFPrimitive color
color.primitive.blue.900#1E3A8APrimitive color
color.primitive.blue.950#172554Primitive color
color.primitive.violet.50#F5F3FFPrimitive color
color.primitive.violet.100#EDE9FEPrimitive color
color.primitive.violet.200#DDD6FEPrimitive color
color.primitive.violet.300#C4B5FDPrimitive color
color.primitive.violet.400#A78BFAPrimitive color
color.primitive.violet.500#8B5CF6Primitive color
color.primitive.violet.600#7C3AEDPrimitive color
color.primitive.violet.700#6D28D9Primitive color
color.primitive.violet.800#5B21B6Primitive color
color.primitive.violet.900#4C1D95Primitive color
color.primitive.violet.950#2E1065Primitive color
color.primitive.cyan.50#ECFEFFPrimitive color
color.primitive.cyan.100#CFFAFEPrimitive color
color.primitive.cyan.200#A5F3FCPrimitive color
color.primitive.cyan.300#67E8F9Primitive color
color.primitive.cyan.400#22D3EEPrimitive color
color.primitive.cyan.500#06B6D4Primitive color
color.primitive.cyan.600#0891B2Primitive color
color.primitive.cyan.700#0E7490Primitive color
color.primitive.cyan.800#155E75Primitive color
color.primitive.cyan.900#164E63Primitive color
color.primitive.cyan.950#083344Primitive color
color.primitive.base.white#FFFFFFPrimitive color
color.primitive.base.black#000000Primitive color
color.primitive.base.green600#16A34APrimitive color
color.primitive.base.amber500#F59E0BPrimitive color
color.primitive.base.red600#DC2626Primitive color
color.primitive.base.sky600#0284C7Primitive color
color.semantic.bg.canvas{color.primitive.slate.50} → #F8FAFCSemantic color
color.semantic.bg.surface{color.primitive.base.white} → #FFFFFFSemantic color
color.semantic.bg.subtle{color.primitive.slate.100} → #F1F5F9Semantic color
color.semantic.bg.inverse{color.primitive.slate.900} → #0F172ASemantic color
color.semantic.text.primary{color.primitive.slate.900} → #0F172ASemantic color
color.semantic.text.secondary{color.primitive.slate.500} → #64748BSemantic color
color.semantic.text.inverse{color.primitive.base.white} → #FFFFFFSemantic color
color.semantic.text.link{color.primitive.blue.600} → #2563EBSemantic color
color.semantic.border.default{color.primitive.slate.200} → #E2E8F0Semantic color
color.semantic.border.strong{color.primitive.slate.300} → #CBD5E1Semantic color
color.semantic.action.primary{color.primitive.blue.500} → #3B82F6Semantic color
color.semantic.action.primary-hover{color.primitive.blue.600} → #2563EBSemantic color
color.semantic.action.primary-text{color.primitive.base.white} → #FFFFFFSemantic color
color.semantic.action.secondary{color.primitive.violet.600} → #7C3AEDSemantic color
color.semantic.focus.ring{color.primitive.blue.500} → #3B82F6Semantic color
color.semantic.status.success{color.primitive.base.green600} → #16A34ASemantic color
color.semantic.status.success-bg#F0FDF4Semantic color
color.semantic.status.warning{color.primitive.base.amber500} → #F59E0BSemantic color
color.semantic.status.warning-bg#FFFBEBSemantic color
color.semantic.status.danger{color.primitive.base.red600} → #DC2626Semantic color
color.semantic.status.danger-bg#FEF2F2Semantic color
color.semantic.status.info{color.primitive.base.sky600} → #0284C7Semantic color
color.semantic.status.info-bg#F0F9FFSemantic color
color.component.button.radius{radius.md} → 8pxComponent—
color.component.input.radius{radius.md} → 8pxComponent—
color.component.card.radius{radius.lg} → 12pxComponent—
color.component.card.shadow{shadow.md} → 0 4px 6px -1px rgb(15 23 42 / 0.1), 0 2px 4px -2px rgb(15 23 42 / 0.1)Component—
color.component.badge.radius{radius.full} → 9999pxComponent—
spacing.00pxSpacing
spacing.14pxSpacing
spacing.28pxSpacing
spacing.312pxSpacing
spacing.416pxSpacing
spacing.520pxSpacing
spacing.624pxSpacing
spacing.832pxSpacing
spacing.1040pxSpacing
spacing.1248pxSpacing
spacing.1664pxSpacing
spacing.2080pxSpacing
spacing.2496pxSpacing
radius.none0pxRadius
radius.sm4pxRadius
radius.md8pxRadius
radius.lg12pxRadius
radius.xl16pxRadius
radius.2xl24pxRadius
radius.full9999pxRadius
fontSize.display48pxFont size—
fontSize.h136pxFont size—
fontSize.h230pxFont size—
fontSize.h324pxFont size—
fontSize.h420pxFont size—
fontSize.body-lg18pxFont size—
fontSize.body16pxFont size—
fontSize.body-sm14pxFont size—
fontSize.caption12pxFont size—
fontWeight.regular400Font weight—
fontWeight.medium500Font weight—
fontWeight.semibold600Font weight—
fontWeight.bold700Font weight—
fontWeight.extrabold800Font weight—
lineHeight.none1Line height—
lineHeight.tight1.25Line height—
lineHeight.normal1.5Line height—
lineHeight.relaxed1.75Line height—
fontFamily.sansPlus Jakarta Sans, ui-sans-serif, system-ui, sans-serifFont family—
shadow.sm0 1px 2px 0 rgb(15 23 42 / 0.05)Shadow—
shadow.md0 4px 6px -1px rgb(15 23 42 / 0.1), 0 2px 4px -2px rgb(15 23 42 / 0.1)Shadow—
shadow.lg0 10px 15px -3px rgb(15 23 42 / 0.1), 0 4px 6px -4px rgb(15 23 42 / 0.1)Shadow—
shadow.xl0 20px 25px -5px rgb(15 23 42 / 0.1), 0 8px 10px -6px rgb(15 23 42 / 0.1)Shadow—
motion.duration.fast100msMotion—
motion.duration.base200msMotion—
motion.duration.slow300msMotion—
motion.duration.slower500msMotion—
motion.easing.standardcubic-bezier(0.2, 0, 0, 1)Motion—
motion.easing.incubic-bezier(0.4, 0, 1, 1)Motion—
motion.easing.outcubic-bezier(0, 0, 0.2, 1)Motion—

Downloads

A native .fig file can't be generated from a website — it's Figma's proprietary format, produced only inside Figma. Import figma-tokens.json with the Tokens Studio plugin to create native Figma variables and styles, then save the file as your own .fig.

03 · Components

Components

20 components with live previews, variant matrices and usage notes. Everything below is interactive — try the states.

Button

Triggers an action. One primary action per view; everything else steps down a level.

Variants · md

Sizes · primary

States

When to use
Form submits, confirmations, key CTAs. Use a link instead when the action only navigates.
Specs
Radius 8px (radius.md) · heights sm 32 / md 40 / lg 48px · semibold label · loading swaps in a spinner and sets aria-busy.

Input

Single-line text entry with label, helper text and inline error states.

We never share your email.

When to use
Short free-form values: names, emails, search. Use Textarea for anything longer than a sentence.
Specs
Height 40px · radius 8px · 14px text · error uses danger border + role=alert message, never color alone.

Textarea

Multi-line text entry for descriptions, notes and feedback.

Shown on the project card.

When to use
Content expected to exceed one line. Set rows to the expected answer length.
Specs
Radius 8px · 14px text · resizable vertically · same error pattern as Input.

Select

Native select for choosing one option from a list — accessible by default on every platform.

When to use
5–12 options where a native control is acceptable. Use Radio for ≤5 visible options, Dropdown menu for actions.
Specs
Height 40px · radius 8px · native <select> semantics with custom chevron.

Checkbox

Toggles one independent option, or several from a group. Part of the selection-controls demo below.

Checkbox
Radio

Switch

When to use
Multiple selections, or a single opt-in that is submitted with a form.
Specs
18px box · 44px row touch target · accent uses Electric Blue.

Radio

Exactly one choice from a visible set — see the demo above.

Live radio group is in the Checkbox demo above (plan selector). Radios always show all options; never hide them in a dropdown when there are five or fewer.

When to use
2–5 mutually exclusive options that benefit from being seen together.
Specs
18px circle · grouped with <fieldset> + <legend> · 44px rows.

Switch

An immediate on/off setting — see the demo above. Changes apply instantly, no submit needed.

Live switches are in the Checkbox demo above, including a disabled state.

When to use
Binary settings that take effect at once (notifications, dark mode). Use Checkbox when the change is submitted later.
Specs
44×24px track · knob 20px · role=switch with aria-checked · 200ms transition.

Badge

A compact status or category label. Always paired with text — never color alone.

NeutralBlueVioletActiveInvitedSuspended
When to use
Status (Active, Invited), counts, categories. Keep to 1–2 words.
Specs
Radius full · 12px semibold · tinted bg at 100-step, text at 800-step for AA-safe contrast.

Avatar

Represents a person or team. Initials fallback in brand colors when there is no photo.

ARTHNJARTH+4
When to use
Members, authors, assignees. Always include an accessible name (aria-label or adjacent text).
Specs
Circle · sm 32 / md 40 / lg 48px · initials extrabold on a brand fill.

Card

A bordered surface grouping related content and actions.

Monthly active users

+12.4%

24,512

Demo content for layout purposes.

When to use
Collections of comparable items, dashboard widgets, settings groups.
Specs
Radius 12px (radius.lg) · shadow.md · 1px border · padding 20–24px.

Alert

Inline, persistent feedback tied to a place on the page. Four tones, always with an icon and text.

When to use
Form summaries, page-level warnings, confirmations that must stay visible. Use Toast for transient feedback.
Specs
Radius 12px · icon 20px · title bold + supporting text · role=alert for danger/warning.

Tabs

Switches between sibling views without leaving the page.

Overview panel — summary metrics and recent work live here.
When to use
3–5 peer sections of one object (a profile, a project). Use navigation for unrelated destinations.
Specs
Underline indicator in Electric · role=tablist/tab/tabpanel · arrow-key navigation in production.

Table

Structured rows for scanning and comparing records.

NameRoleStatus
Ayesha RahmanProduct DesignerActive
Tanvir HasanUX ResearcherActive
Nusrat JahanDesign EngineerInvited
Rahim UddinVisual DesignerSuspended
When to use
Data with consistent attributes across many items. On mobile, allow horizontal scroll or collapse to cards.
Specs
Header on subtle bg · 14px rows · status via Badge · min hit area 44px on interactive rows.

Pagination

Steps through paged lists with a clear current position.

When to use
Long tables/lists split server-side. Show total pages when known.
Specs
40px targets · current page filled Electric · aria-current=page · prev/next always labeled.

Progress

Shows completion of a known-length task or quota.

Profile complete — 72%

Storage used — 38%

Review queue — 90%

When to use
Uploads, onboarding steps, quotas. Use Skeleton — not a spinner bar — when duration is unknown.
Specs
Height 8px · radius full · role=progressbar with aria-valuenow · tones map to status tokens.

Skeleton

Low-fidelity placeholders that mirror the final layout while content loads.

When to use
Content expected in under ~2s where layout is known. Pair with aria-busy on the region.
Specs
Subtle fill + pulse · same geometry as the real content · respects prefers-reduced-motion.

Toast

Transient confirmation that an action finished. Auto-dismisses, pausable, dismissible.

When to use
Save/complete confirmations that need no follow-up. Never put errors that block work in a toast — use Alert.
Specs
Bottom-right · Midnight surface · auto-dismiss ~4s · role=status · entrance 200ms ease-out.

Tooltip

A tiny label clarifying an icon or truncated text.

Tooltip · 200ms ease-out

Tooltips appear on hover and keyboard focus — never hold essential content.

When to use
Icon-only buttons and unfamiliar terms. Never hide essential information or interactive content inside.
Specs
Midnight bg · 12px semibold · shows on hover and focus · 200ms delay in production.

04 · Patterns

Patterns

Components composed into the shapes products actually ship: forms, dashboards and state handling.

Form pattern

Labels above fields, helper text before errors, one primary action right-aligned. Try submitting with an invalid email to see inline validation.

You can rename this later.

Dashboard pattern

Header bar, stat cards, progress lists and avatars composed entirely from Aura components.

Mini dashboard

Active users

+12.4%

24,512

Open reviews

8 urgent

38

Exports

+3.1%

1,204

Onboarding completion

Designers — 84%

Researchers — 63%

Engineers — 47%

AR

Next review

Token audit with the design team.

Demo data shown for layout purposes only.

Empty · loading · error states

Every data view ships all three: an invitation when empty, a skeleton while loading, and a plain-language error with a way forward.

No projects yet

Create your first project to get started.

Loading state

Couldn't load projects

Check your connection and try again.

05 · Accessibility

Accessibility

Aura targets WCAG 2.2 AA. Contrast ratios below are measured values for the exact pairs listed — including the pairs that only pass for large text, and the ones that fail and must not be used.

PairColorsRatioVerdict
Midnight text#0F172A on #F8FAFC17.06 : 1AAA
Midnight text#0F172A on #FFFFFF17.85 : 1AAA
Slate 600 text#475569 on #FFFFFF7.58 : 1AAA
Secondary text#64748B on #FFFFFF4.76 : 1AA
Link (Blue 600)#2563EB on #FFFFFF5.17 : 1AA
Inverse on Violet#FFFFFF on #7C3AED5.70 : 1AA
Inverse on Danger#FFFFFF on #DC26264.83 : 1AA
Inverse on Electric#FFFFFF on #3B82F63.68 : 1AA — large text & UI only
Inverse on Info#FFFFFF on #0284C74.10 : 1AA — large text & UI only
Success text#16A34A on #FFFFFF3.30 : 1AA — large text & UI only
Warning text#F59E0B on #FFFFFF2.15 : 1Fails — never use amber as text on light
Inverse on Cyan#FFFFFF on #06B6D42.43 : 1Fails — cyan is a fill; pair with Midnight text (7.35 : 1)

Focus is visible

Every interactive element shows a 2px Electric outline with 2px offset on focus-visible. Tab through this card's button to see it:

Keyboard rules

  • All actions reachable and operable by keyboard alone.
  • Esc closes dialogs, menus and toasts.
  • Dialogs move focus inside on open; tabs use arrow keys.
  • Never remove an outline without a visible replacement.

Touch & motion

  • Minimum target 44×44px (WCAG 2.2 AA: at least 24px, Aura uses 44).
  • Status is never carried by color alone — icon + text.
  • Reduced-motion preferences disable non-essential animation.

06 · Guidelines

Guidelines

The rules that keep many hands building one product.

Do — one primary action

Save changesCancel

The primary button marks the single most likely next step; everything else is quieter.

Don't — competing primaries

Save changesDelete forever

Two equal-weight actions force a guess — and a destructive action should never wear the primary style.

Do — status with words

ActiveInvitedSuspended

Text labels survive color blindness, grayscale printing and translation.

Don't — hardcode values

color: #3B82F6; ← raw hex in a component

color: var(--aura-action-primary); ← semantic token

Hardcoded hex breaks theming and dark mode. Components consume semantic tokens only.

Voice & tone

Say thisNot thisWhy
Changes savedSuccess!!! Your changes have been saved successfully.Calm and brief; no shouting.
Enter a valid email address.Error 422: invalid input.Plain language, tells you the fix.
Delete project? This can't be undone.Are you sure you want to proceed?Names the action and the consequence.
No projects yet — create your first.Nothing here. ¯\_(ツ)_/¯Helpful first, personality second.

Aura's voice is clear over clever, warm without being cute, and honest about errors — say what happened and what to do next, in the fewest words that stay kind.