Changelog

All notable changes to Aura UI will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.13.0] - 2026-06-23

Added

• aura:add installs components from a remote registry URL (php artisan aura:add https://host/r/<name>.json) with HTTPS-only fetch, host allowlist + confirmation, schema validation and path sanitisation. aura-ui.com serves the installable shape at /r/{name}.json.

[3.12.0] - 2026-06-22

Added

• Free Blocks in the component registry (type field in aura-registry.json) — full-page sections installable via aura:add.

[3.11.0] - 2026-06-22

Added

• OKLCH PaletteGenerator (fromHex) powering Theme Studio, coherent with the Aura Filament palette.

[3.10.0] - 2026-06-22

Added

• aura:add / aura:init own-the-code CLI — copy a component's Blade source into your project (resolves dependencies, rewrites the namespace).

[3.9.2] - 2026-06-22

Fixed

• Hardened developer-controlled props interpolated into JS contexts (Js::from / casts) across components.

[3.9.1] - 2026-06-22

Fixed

• Hardened wire:model entangle (Js::from) and slider numeric props across components.

[3.9.0] - 2026-06-22

Added

• <x-aura::multiselect>, <x-aura::tags>, <x-aura::otp> and <x-aura::slider> (slider relocated from Pro to Free).
• <x-aura::button> prefixIcon / suffixIcon (preferred over the deprecated icon / iconRight aliases).

[3.8.0] - 2026-06-21

Added

• WCAG accessibility pass across components; wire:model works out of the box on the modal.

[3.7.0] - 2026-04-26

Added

• Laravel 13 compatibility (illuminate/* ^12 || ^13).

[3.6.0] - 2026-04-17

Added

• Floating Label Input component (Material Design animation).

[3.5.0] - 2026-04-16

Added

• Notification Center component with dropdown and badges.

[3.4.0] - 2026-03-16

Added

• Heroicon → Lucide icon name fallback mapping.

[3.3.2] - 2026-03-03

Added

• Component improvements: validation, accessibility, form handling.

[3.3.1] - 2026-03-03

Fixed

• Docs visual fixes: editor array toolbar, calendar i18n, swap grid overlay, toast events, animations.

[3.2.0] - 2026-02-25

Added

• Drawer component — slide-out panel from any edge with overlay, sizes, and footer slot
• Timeline component with item sub-component — vertical timeline with colored dots, icons, and dates
• Rating component — interactive star rating with hover, click, readonly mode, and color variants
• Kbd component — keyboard key display with mono font and sizes
• Collapsible component — show/hide content with trigger slot and Alpine.js transitions
• Radial Progress component — SVG circular progress with value, sizes, colors, and custom labels
• Indicator component — badge overlay for notification dots, counts, and ping animation
• List component with item sub-component — styled lists with divided, bordered, and icon support
• Countdown component — Alpine.js countdown timer with days/hours/min/sec display
• Diff component — side-by-side or stacked before/after comparison
• Swap component — Alpine.js toggle between two states with rotate/flip effects
• FAB component — floating action button with expandable actions menu

Changed

• Free component count: 30 → 44 (14 new components)
• Test count: 450 → 555+ (105 new tests)

[3.1.0] - 2026-02-25

Added

• Table component with composable sub-components (head, body, row, header, cell) — striped, hoverable, bordered, compact variants
• Container component — max-width centered wrapper with responsive padding (sm/md/lg/xl/full)
• Layout component — flex wrapper for main + aside arrangement
• Main component — semantic <main> content area
• Aside component — sidebar with configurable width (sm/md/lg) and sticky option
• Subheading component — secondary descriptive text with size and tag props
• Table CSS styles in residual.css (striped, hoverable, bordered, compact + dark mode)

Changed

• Free component count: 26 → 30 (4 new logical components + Table sub-components)
• Test count: 389 → 450 (42 new tests, 84 new assertions)

[2.1.1] - 2026-02-22

Added

• Publishable JS vendor assets (Alpine.js, Chart.js) via aura-ui-assets tag
• CDN fallback in playground when self-hosted JS files are unavailable

Fixed

• Playground now loads Alpine.js and Chart.js reliably with local-first + CDN fallback

[2.1.0] - 2026-02-17

Fixed

• Livewire 4 compatibility (support ^3.6 || ^4.0)
• Alpine.js 3 migration updates
• Internationalization: all strings now in English, locale prop available where needed
• Additional Tailwind CSS 4 refinements

[2.0.0] - 2026-02-16

Changed

• BREAKING: Tailwind CSS 4 is now required (uses @theme tokens and @custom-variant)
• Minimum Tailwind version bumped from v3 to v4

[1.1.1] - 2026-02-16

Fixed

• Added @custom-variant dark for class-based dark mode support in Tailwind CSS 4

[1.1.0] - 2026-02-16

Changed

• Migrated all 26 components and CSS to Tailwind CSS 4
• CSS now uses @theme tokens instead of legacy CSS custom properties
• Component styles updated for Tailwind 4 compatibility

[1.0.2] - 2026-02-16

Fixed

• Changed overflow from hidden to visible on card and avatar containers

[1.0.1] - 2026-02-15

Fixed

• Aligned modal CSS class names with Blade template
• Aligned checkbox and radio Blade templates with CSS class names

[1.0.0] - 2026-02-15

Changed

• Split into Free/Pro packages
• Free package now contains 26 components (primitives, feedback, layout, navigation, data display, form layout)
• Pro components moved to bluestarsystem/aura-ui-pro package

Removed

• DataTable system (moved to Pro)
• Livewire traits (moved to Pro)
• Advanced form components (moved to Pro)
• Navigation components: tabs, accordion, steps, sidebar (moved to Pro)
• Interactive components: command palette, confirmation dialog, toasts (moved to Pro)
• Visualization components: chart, calendar, kanban, tree (moved to Pro)

[0.1.2] - 2026-02-15

Added

• Avatar auto-initials and color variants generated from name

[0.1.1] - 2026-02-15

Fixed

• Resolved CSS variable naming inconsistencies
• Fixed pagination alignment issues
• Fixed button alignment issues

[0.1.0] - 2026-02-15

Added

• Initial release of Aura UI component library
• "Vibrant Depth" design system with CSS custom properties
• 54 Blade components across 4 phases
• Dark mode support via .dark class
• Glass morphism utilities
• Multi-layered shadow system with glow effects
• 14 keyframe animations with spring easing
• DataTable with 5 Livewire traits
• Column builder with fluent API
• 5 filter types (Select, Text, Boolean, DateRange, base)
• Interactive playground at /aura/playground
• php artisan aura:install command
• Publishable config and CSS assets
• 523 tests

Changelog

All notable changes to Aura UI Pro will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[2.11.0] - 2026-06-22

Added

• Pro blocks (dashboard-analytics, data-table-page, settings-form) + registry support for aura:add.

[2.10.0] - 2026-06-22

Added

• Ships aura-registry.json for aura:add CLI support (Pro components).

[2.9.0] - 2026-06-22

Added

• Scheduler month view, drag-between-days, and keyboard event activation.

[2.9.1] - 2026-06-22

Fixed

• Hardened sidebar width and Spotlight shortcut interpolation.

[2.8.2] - 2026-06-22

Fixed

• Hardened wire:model entangle (Js::from) and numeric props across Pro components.

[2.8.1] - 2026-06-22

Changed

• Slider moved to Aura UI (Free).

[2.8.0] - 2026-06-22

Added

• Multi-column sort on the Pro DataTable (shift+click priority).

[2.7.0] - 2026-06-21

Added

• Pro interactive Scheduler (week/day, drag move/resize/create).

[2.6.0] - 2026-06-21

Added

• Pro chart suite: sparkline, gauge, stat-chart, area-chart, bar-chart.

[2.5.0] - 2026-06-21

Added

• Rich Text Editor component.

Fixed

• Rich text editor active states for code/link, error border, min-height (2.5.1).

[2.4.0] - 2026-06-21

Added

• Date-range picker form component.

[2.3.0] - 2026-06-21

Added

• DataTable CSV export respecting search, filters, sort and visible columns.

[2.2.0] - 2026-04-16

Added

• Spotlight search component (fuzzy search, Livewire support).

[2.1.3] - 2026-05-31

Fixed

• Support illuminate/support ^13.0 for Laravel 13 compatibility.

[2.1.2] - 2026-03-03

Added

• Pro component improvements and trait updates.

[2.1.1] - 2026-03-03

Fixed

• Tree view indentation (nested children).

[2.1.0] - 2026-02-25

Added

• Carousel component — image/content slider with autoplay, loop, arrows, indicators, and multi-slide support
• Chat Bubble component — message bubbles with left/right positioning, avatar, name, time, and delivery status
• Hover Card component — rich tooltip content on hover with delay, positioning, and width options
• Dock component with item sub-component — macOS-style dock bar with labels, active states, and glassmorphism
• Resizable component — drag-resizable panels with horizontal/vertical direction and min/max constraints

Changed

• Pro component count: 13 → 19 (6 new components including sub-components)
• Test count: 241 → 276+ (35 new tests)

[1.1.1] - 2026-02-22

Fixed

• Chart component auto-loads Chart.js with self-hosted path + CDN fallback

[1.1.0] - 2026-02-17

Fixed

• Livewire 4 compatibility (support ^3.6 || ^4.0)
• Security hardening on inline edit trait
• Alpine.js 3 migration updates
• Internationalization: all strings now in English, locale prop available where needed

[1.0.0] - 2026-02-16

Changed

• BREAKING: Tailwind CSS 4 is now required (uses @theme tokens and @custom-variant)
• Minimum Tailwind version bumped from v3 to v4

[0.2.0] - 2026-02-16

Changed

• Migrated all 19 components and CSS to Tailwind CSS 4
• CSS now uses @theme tokens instead of legacy CSS custom properties
• Component styles updated for Tailwind 4 compatibility

Fixed

• Made @entangle conditional for non-Livewire contexts

[0.1.0] - 2026-02-15

Added

• Initial release
• 19 Pro components (advanced forms, navigation, interactive, visualization)
• DataTable system with Column builder, BulkAction builder, 5 Filter classes
• 5 Livewire traits (WithAuraDataTable, WithAuraFilters, WithAuraBulkActions, WithAuraInlineEdit, WithAuraForm)
• 21 component CSS files
• Pro playground sections

Changelog

All notable changes to Aura Filament will be documented in this file.

[2.15.2] - 2026-06-24

Fixed

• Theme configurator modal layout: the Export & share section now sits inside the scrollable body (aligned), as a compact collapsible disclosure, so the core controls fit without a scrollbar.

[2.15.1] - 2026-06-24

Fixed

• Theme export snippet wraps instead of overflowing the modal.

[2.15.0] - 2026-06-23

Added

• aura-filament:install --demo scaffolds ready-made demo pages; the installer also publishes the Aura user-preference migrations and wires the traits into your User model.

[2.14.0] - 2026-06-23

Added

• Theme configurator export & share: copy a ready-to-paste AuraFilamentPlugin config snippet and a shareable preset token (with paste-to-import).

[2.13.0] - 2026-06-23

Added

• aura-filament:scaffold command — generate Aura-styled Filament pages (settings, profile, billing, analytics-dashboard) into your app (own-the-code).

Fixed

• Scaffolded pages use a parent-compatible navigationGroup type (2.13.1).

[2.12.0] - 2026-06-23

Added

• Aura-themed table columns (rating, progress, color, sparkline, badge, trend) and form fields (rating input, icon picker, key-value).

[2.11.1] - 2026-06-22

Fixed

• Hardened color-picker statePath entangle interpolation (@js).

[2.11.0] - 2026-06-21

Added

• Branded auth pages (authBranding() — title, subtitle, logo).

[2.10.0] - 2026-06-21

Added

• Branded Aura markdown mail theme.

[2.9.0] - 2026-04-18

Added

• 4 new presets (Aurora, Neon, Minimal, Nature); hide Filament's native theme switcher when the configurator is on.

Fixed

• Sync the native switcher to the DB instead of hiding it (2.9.1); command-palette enum navigation groups (2.9.2); dropdown panels hidden by the topbar glass (2.9.3); sidebar-first mobile drawer never opening (2.9.4).

[2.8.0] - 2026-04-17

Added

• Sprint 7 CSS: resource-hero, drawer, bulk actions, infolist tabs.

[2.7.1] - 2026-04-16

Fixed

• Calendar widget made self-contained (removed the aura-ui dependency).

Sprint 5 — Dashboard customizer

Per-user dashboard layout persistence: drag-reorder widgets, toggle visibility, pick column spans (1 / 2 / full) — all saved in a JSON column on the User model.

Added

• AuraDashboard (abstract page extending Filament\Pages\Dashboard) — overrides getWidgets() and getWidgetsContentComponent() to apply the user's saved layout (order, visibility, column span). New widgets added to the panel after a layout was saved appear at the end as visible.
• HasAuraDashboardLayout trait on the User model — manages the aura_dashboard_layout JSON column with getAuraDashboardLayout(), setAuraDashboardLayout(), clearAuraDashboardLayout().
• DashboardCustomizer Livewire component — floating glass panel (FAB bottom-left, z-index 9999 to clear sidebars) with drag-reorder via SortableJS (CDN-loaded), checkbox visibility toggles, and a span selector per widget. Save persists to the JSON column and reloads; Reset clears the column and falls back to the developer's defaults.
• ->dashboardCustomizer() plugin method — registers the FAB and the Livewire component via a BODY_END render hook.
• Publishable migration stub for the aura_dashboard_layout column.

Fixed

• Dashboard customizer FAB hidden behind sidebar — z-index bumped from 40 to 9999, backdrop z-index to 99999 so the FAB sits above the sidebar but the dialog still covers the FAB.
• Column span changes had no effect — liberatedFromContainerGrid() on the Livewire schema wrapper was telling the Grid to skip its column-span wrapper, so ->columnSpan() was silently ignored. Removed the flag; the Grid now applies the span via its own toSchemaHtml() renderer.
• Span values from <select> stored as strings — added is_numeric() cast so "1" → 1 before Filament's grid helper processes it.

[2.5.1] - 2026-04-15 — Sprint 4: onboarding & empty states

A full onboarding toolkit — illustrated empty states, a progress-ring welcome widget, a guided tour overlay, and a multi-step wizard page scaffold. Every piece is primary-themed, theme-configurator-aware, and ships with zero new JS dependencies.

Note on versioning: an orphan v2.5.0 tag (identical code to v2.4.0) was created in an earlier session. This release tags the real Sprint 4 work as v2.5.1 to keep the history clean without destructive tag edits on the remote. composer require "bluestarsystem/aura-filament:^2.5" resolves here.

Added

• <x-aura-filament::empty-state> — 8 illustrated SVG variants (no-data, no-results, no-users, no-orders, no-messages, no-files, no-notifications, error) driven by the new EmptyStateVariant enum. Each illustration uses three color hooks (.fi-aes-base, .fi-aes-accent, .fi-aes-spark) so it re-tints with the theme configurator and plays a gentle float + pulse + twinkle animation (gated behind prefers-reduced-motion). Developer-overridable title, description, size (sm/md/lg), and an actions slot.
• AuraWelcomeWidget (abstract Filament widget) + OnboardingStep DTO — a dashboard checklist with an SVG progress ring. Steps are declared with completion closures so state derives from live data (no new DB column). Optional $hideWhenComplete makes the widget disappear once every step is done. Primary-themed ring with a soft drop-shadow glow.
• <x-aura-filament::tour> + TourStep DTO — zero-dependency guided tour. Spotlight backdrop (box-shadow trick), floating tooltip with viewport clamping and automatic placement flipping, Prev/Next/Skip/Finish buttons, localStorage persistence, external triggers via window.dispatchEvent(new CustomEvent('aura-tour:start', {detail:{id}})), reset via aura-tour:reset. Optional auto-start.
• AuraWizardPage (abstract Filament page) + WizardStep DTO + <x-aura-filament::wizard> Blade component — multi-step setup scaffold. URL-synced currentStep (?step=2), shared $data array across steps, per-step ->validate() closure that gates advancement, ->optional() steps with a Skip button, previousStep / nextStep / goToStep / skipStep / finishWizard navigation methods, primary-lit step indicator with connector lines, glowing progress bar.

Fixed

• Critical — invalid rgb(var(--primary-*)) pattern. Filament emits --primary-500 (and siblings) as oklch(...) strings. Wrapping them in rgb(var(--primary-500)) produced rgb(oklch(...)) — invalid syntax — which browsers silently discard. The tour's primary button was the most visible casualty (invisible text against its own "transparent" bg). Replaced the wrapper with var(--primary-500) directly for solids and color-mix(in oklab, var(--primary-500) N%, transparent) for alpha tints, matching Filament's own internal pattern. Applied across the new Sprint 4 components; a follow-up pass on the earlier Sprint 2–3 files is tracked as technical debt.

Tests

47 new unit tests across EmptyStateVariant, OnboardingStep, AuraWelcomeWidget, TourStep, WizardStep, and AuraWizardPage. Suite total: 138 tests / 334 assertions, up from 97.

[2.4.0] - 2026-04-15 — Sprint 3: form & input library

Four new Filament form components plus a fix for the theme configurator's primary-color live update path. Every new field keeps full compatibility with its Filament parent — no Blade view overrides, no extra JS dependencies.

Added

• AuraColorPicker (extends Filament\Forms\Components\ColorPicker) — adds ->showPalette() which renders an 11-shade OKLCH strip below the input generated by PaletteGenerator whenever a valid hex is present. Static helper AuraColorPicker::paletteFromValue() is the pure, testable core.
• AuraFileUpload (extends Filament\Forms\Components\FileUpload) — glass drop zone, primary-tinted hover & drag-over glow, rounded file tiles, circle variant for ->avatar(). Styling is 100% CSS; the component just guarantees the fi-aura-fo-file-upload marker class is always present.
• AuraRichEditor (extends Filament\Forms\Components\RichEditor) — Notion/Linear-style sticky glass toolbar, primary hover/active tints on toolbar buttons, blockquote with primary left bar (no italics), inline code pills, styled code blocks, floating bubble toolbar on selection.
• AuraCodeEditor (extends Filament\Forms\Components\Textarea) — dark glass surface, monospace, primary focus ring, language badge via ->language('php'), tab-to-spaces via ->tabSize(4) driven by a tiny inline Alpine handler. Shift+Tab outdents the current line. No CodeMirror/Monaco dependency — keeps install size small.

Fixed

• Theme configurator — primary color override. The BODY_START hook used to read only preset and dark from the user's saved preferences, so choosing a new primary in the configurator was persisted to the DB but never applied on reload. The hook now resolves the user's preference (custom hex via PaletteGenerator, or a Filament named color) and emits a <style data-aura-primary-override>:root{--primary-50:…;…}</style> block in the body that wins the cascade over Filament's <head> emission. Paired change in the configurator view: the client now injects/updates the same <style> element live on save, so primary changes apply without a page reload. Reset still reloads (intentional: we can't know the developer-configured default client-side).

Tests

34 new unit tests covering the four new components and the primary-override resolver (resolvePrimaryPaletteFromPrefs). Suite total: 97 tests / 203 assertions, up from 63.

[2.3.0] - 2026-04-15 — Sprint 2: layout, theme configurator, charts, activity feed, palette generator

Six new features built on top of v2.2.x. All validated visually in aura-test-sandbox and again in the new aura-demo showroom before tagging.

Added

• LayoutMode::SidebarFirst — Notion/Linear-style full-height sidebar that spans the entire viewport with the topbar sitting to its right. Activated via ->layout(LayoutMode::SidebarFirst) on the plugin. Default remains Default (Filament's stock topbar-first layout). Forces white logo text and overrides primary-200 sidebar nav text to white so amber/yellow primaries stay legible.
• In-panel theme configurator (->themeConfigurator()) — floating action button bottom-right opens a Livewire modal where end-users can switch preset (Glass, Aurora, Midnight, etc.), toggle dark mode, and pick a primary color. Preferences persist per-user via the aura_theme_preferences JSON column on users (publishable migration). Add the HasAuraThemePreferences trait to your User model. Reads happen at render time inside the body-start hook so auth()->user() is available.
• PaletteGenerator + aura-filament:palette {color} command — turns a single hex color into a full 11-shade OKLCH palette (50–950) ready to drop into Color::* arrays. Output formats: --format=php|json|css. Lightness curve and chroma scaling tuned for accessibility on both light and dark backgrounds.
• Chart widget library — AuraChartWidget base + AuraLineChart, AuraBarChart, AuraPieChart, AuraDoughnutChart. Glass tooltip, soft grid, smooth lines (tension 0.35), rounded bars (radius 6), legend hidden by default for line/bar (set $showLegend = true to enable). ChartPalette::rainbow(), line(), bar(), pie() helpers build dataset color arrays in the Aura visual language. CSS height cap at 320px stops Chart.js from growing unbounded.
• Activity feed widget — AuraActivityFeed base + ActivityItem DTO. Subclasses return arrays of items from getActivities(); the view renders a vertical timeline with marker column (avatar / icon / colored dot connected by a soft line) and body column (title, relative time, description, actor). Color variants: primary | success | warning | danger | info | neutral. Rendered eagerly ($isLazy = false) — activity feeds are above the fold and queries are typically cheap.

Fixed

• Critical — chart widgets without an explicit height cap could grow to 700+ pixels because Filament wraps the canvas in an unstyled div. CSS now caps both the wrapper div and the canvas at 320px.
• Critical — Filament v4 dashboard widgets default to $isLazy = true. The activity feed widget was rendering an empty wire:snapshot wrapper because the lazy load wasn't being triggered. Set $isLazy = false on the base class.
• Theme configurator dark-mode override was getting overwritten on next page load because Filament reads localStorage['theme'] at boot. Now writes both localStorage and the .dark class on <html> synchronously.
• Color swatches in the theme configurator modal were showing as gray dots because they used Filament CSS variables that don't exist as named tokens. Replaced with hardcoded HEX colors.
• 51 tests were failing in CI after the Livewire component registration was added because Testbench doesn't bind livewire. Guarded the registration with $this->app->bound('livewire').

Migration guide

If you're upgrading from v2.2.x:

1. Publish and run the new theme preferences migration (only needed if you'll use the theme configurator):

   php artisan vendor:publish --tag=aura-filament-migrations
   php artisan migrate
   

2. Add the trait to your User model:

   use BlueStarSystem\AuraFilament\Concerns\HasAuraThemePreferences;
   class User extends Authenticatable {
       use HasAuraThemePreferences;
   }
   

3. Opt in to features on the plugin (all are off by default):

   AuraFilamentPlugin::make()
       ->layout(LayoutMode::SidebarFirst)   // optional
       ->themeConfigurator()                 // optional
   

No breaking changes — projects already on v2.2.x will keep working without any code changes.

[2.2.1] - 2026-04-14 — Sandbox-driven hotfixes

Nine issues discovered via the new E2E sandbox environment (aura-test-sandbox) before they reached any customer.

Added

• AuraAvatarProvider — generates inline SVG data URLs with user initials on transparent background so the CSS gradient shows through. Auto-registered by the plugin, replaces Filament's default UiAvatarsProvider which returned solid dark PNGs that covered the gradient.
• avatar.css — branded gradient fallback (primary-400 → primary-600) with white initials and soft glow. Lighter shades in dark mode for luminance.

Fixed

• Critical — render hooks registered via $panel->renderHook() in the plugin's boot() method were never propagated to FilamentView. Filament v4 processes panel hooks before calling plugin->boot(). Switched to FilamentView::registerRenderHook() directly (no scope) so hooks fire on every page. Added RenderHooksRegistrationTest as regression guard.
• Critical — installer only wrote the Aura import to resources/css/app.css, but Filament v4 compiles its panel styles from resources/css/filament/{panel}/theme.css (set via viteTheme()). CSS was never loading on the panel. Installer now writes to the Filament theme file and prints clear instructions if it doesn't exist yet.
• New Sprint 1 components referenced CSS variables that don't exist in the preset definitions (--aura-surface-light, --aura-shadow-sm, etc.). Replaced with actual preset names (--aura-card-bg, --aura-card-shadow).
• Sidebar active item used var(--primary-200) which with an Amber primary rendered as near-white-yellow illegible on the dark sidebar. Forced rgb(255, 255, 255) regardless of the primary palette.
• Filament's default ->colors(['primary' => Color::Amber]) in a fresh AdminPanelProvider overrode the ->primaryColor() chosen in the installer. The installer now syncs the native ->colors([...]) call with the chosen color, so both agree.
• Sidebar button targeting: Filament v4 applies backgrounds to .fi-sidebar-item-btn (inner button), not .fi-sidebar-item (outer <li>). Our outer-only overrides were covered by the default white background. Now targets the inner button with !important.
• Avatar overrides — !important on background-image, color, and box-shadow because Filament applies Tailwind utility classes directly on the element (equal specificity).

Changed

• Sidebar CSS: separate hover states for active vs. inactive items, improved contrast, accent bar retained.
• Avatar gradient stops lightened to primary-400 → primary-600 (was primary-500 → primary-700) because the darker range rendered near-black on small avatars especially when compressed to JPEG.

Notes

• Requires bluestarsystem/bss-billing ^1.4 for FIC_BASE_URL support when used with aura-ui. Older versions will silently hit FIC production.
• 40 Pest tests passing, including new regression tests.

[2.2.0] - 2026-04-14 — Sprint 1

Added

• Interactive installer php artisan aura-filament:install with Laravel Prompts
  • Prompts for preset, primary color, icon set, font
  • Auto-detects panel providers and registers the plugin
  • Appends CSS import to resources/css/app.css
  • Idempotent — safe to run multiple times
• Auth page restyle (login, register, password reset)
  • Animated background orbs per preset (Corporate keeps clean)
  • Gradient heading text
  • Glass card with enhanced shadows
  • Decorative hero badge via authHero() plugin method
• Stats Card component <x-aura-filament::stats-card>
  • Label, value, trend indicator, SVG sparkline, icon, description
  • Sparkline generator in PHP (zero JS deps) via Sparkline helper
  • Color variants: primary, success, warning, danger, info, neutral
• Command Palette (Cmd+K / Ctrl+K)
  • Alpine-powered modal, client-side fuzzy search
  • Auto-populates from panel resources + pages
  • Extensible via CommandPalette::addSource() facade
  • Keyboard navigation; can be disabled with ->commandPalette(false)
• Toast notifications upgrade
  • Slide-in spring animation
  • Colored accent bar per variant
  • Shine effect on hover (glass/midnight presets)
• Shield UI wrapper (bezhanSalleh/filament-shield)
  • Hero header, restyled tabs, checkbox grid, role badge pills
  • Pure CSS overrides, zero fork

Changed

• Service provider registers views, anonymous Blade components, CommandPalette singleton
• Added laravel/prompts dependency for install command
• Added dev dependencies: Pest 3.x, Orchestra Testbench 10.x

[2.0.0] - 2026-03-04

Added

• 4 Design Presets: Glass (default), Corporate, Warm, Midnight
• Preset system: 40+ CSS custom properties per preset, switched via data-aura-preset attribute
• Icon Packs: Phosphor, Iconoir, Lucide support via ->icons() method
• IconMapper: Maps ~30 Filament icon aliases to each icon set
• Preset enum: BlueStarSystem\AuraFilament\Enums\Preset
• IconSet enum: BlueStarSystem\AuraFilament\Enums\IconSet
• presets.css: Central design token file for all presets
• preset config key in aura-filament.php
• suggest section in composer.json for icon pack dependencies

Changed

• All 12 component CSS files refactored to use var(--aura-*) custom properties
• glass.css refactored to use preset variables (blur, backgrounds, borders)
• variables.css simplified to timing/easing only (surfaces moved to presets.css)
• AuraFilamentPlugin now supports ->preset() and ->icons() fluent methods
• boot() method injects data-aura-preset attribute via render hook
• License changed from MIT to proprietary
• Homepage URL updated to https://aura-ui.com/filament

Migration from v1

• Zero breaking changes for Glass preset users — Glass is the default and produces identical output to v1
• To use other presets: AuraFilamentPlugin::make()->preset(Preset::Corporate)
• Rebuild your theme CSS after updating: npm run build

[1.0.0] - 2026-02-15

Added

• Initial release with Vibrant Depth theme
• Glass morphism, gradients, glow effects, micro-animations
• 12 component CSS files
• Dark mode support
• Color-agnostic design using Filament's --c-{shade} properties
• Configurable font, glass, glow, and animation toggles