Northwestern Filament Theme Laravel Package

Changed

• Removed Tailwind text-size token overrides and restored Northwestern typography tokens to direct compact values, closely matching the pre-3.0.0 scale

Changed

• Restored compact typography token values while keeping Tailwind text-size variables as the source for overlapping --nu-text-* tokens

This is a breaking release. The theme now raises the default typography floor to 16px by overriding Tailwind text-size tokens used by Filament and by this package's own CSS.

Changed

• --text-xs, --text-sm, and --text-base now resolve to 1rem
• --nu-text-* variables now delegate to Tailwind's --text-* variables instead of maintaining a separate parallel scale

Fixed

• Table loading spinner barely visible in dark mode on column headers and search input

Added

• 3px left border accent on active sidebar items
• Status-tinted backgrounds on notifications (success, danger, warning, info)
• Color-aware borders on badges that reflect each badge's color
• Heading color hierarchy: page and section headings in purple, descriptions in neutral black
• Purple surface background on table group header row cells

Changed

• Notifications use a 4px left accent border per status instead of the default ring
• Callouts use a 3px left accent border with tinted background instead of an all-around border
• Callout headings use small uppercase text with tight letter-spacing
• Badges use font-weight: 600 and letter-spacing: 0.02em
• Modal header/footer borders hidden when the modal has no body content (e.g. confirmation dialogs)
• --nu-purple-surface shifted from #f3f0f7 to #f9f6ff

Added

• Percy visual regression testing with a minimal demo Laravel app and Playwright (30 snapshots across light/dark mode)
• CSS watch mode via pnpm build:css:watch for live-reloading during development
• rel="noopener" on external footer links and aria-label on social icon links

Changed

• CSS architecture modularized into focused files (badges, dropdowns, modals, notifications, pagination, sections, widgets) with shared variables.css design tokens
• NorthwesternTheme internals extracted into HasFooter, HasEnvironmentIndicator, and HasImpersonationBanner traits
• Double-load detection warning now includes an actionable code example

Added

• Prettier with Blade, XML, and package.json plugins for consistent formatting across all file types
• Stylelint property ordering via stylelint-config-recess-order
• CSS minification in dist build using LightningCSS
• composer check (read-only) and composer fix (auto-fix) commands covering PHP and frontend tooling
• Prettier check step in CI workflow

Changed

• CI workflows now use pnpm/action-setup@v4 with built-in store caching instead of corepack
• Filament compatibility workflow uses single composer require instead of --no-update + update

Fixed

• Default avatar now has a nu-purple-10 background for better contrast against the topbar
• Redundant placeholder icon hidden in user menu dropdown header
• Table record collapse button aligned to top of row instead of center

Added

• Laravel 13 support

Changed

• Minimum PHP version raised from 8.2 to 8.3
• Dropped Laravel 11 support

Fixed

• Install command now detects custom viteTheme() paths instead of only looking in resources/css/filament/{panel}/theme.css
• Table header selection cell (bulk-select checkbox) now receives the purple header background and border
• Filter badge no longer overlaps the table container border on tables without search enabled

Added

• Built-in environment indicator with gold badge and top-border (replaces pxlrbt/filament-environment-indicator)
• environmentIndicator() and withoutEnvironmentIndicator() fluent methods with optional custom label and visibility
• Built-in impersonation banner with auto-detection of lab404/laravel-impersonate
• impersonationBanner() and withoutImpersonationBanner() fluent methods with optional custom visibility, label, and leave URL
• Deprecation warning when a legacy custom impersonation banner view is detected alongside the built-in banner

Fixed

• Improved color contrast for danger and gray color scales to meet WCAG accessibility standards
• Purple 400 shade adjusted to increase contrast in UI elements
• Warning button text in dark mode now uses a darker shade for better readability

v2.0 adds optional Vite theme integration as an alternative to the default asset registration approach. Theme CSS is now bundled into a single dist/theme.css file, and a new northwestern-theme:install command handles setup. Tailwind v4 design tokens are available for projects that want Northwestern brand utilities in their own styles.

This is a breaking release. See the Upgrading Guide for migration steps.

Added

• Vite theme integration via northwestern-theme:install artisan command
• withoutAssetRegistration() to prevent double-loading when using Vite integration
• Tailwind v4 design tokens (bg-nu-purple-100, text-nu-gold, etc.)

Changed

• Theme CSS is now compiled into dist/theme.css instead of registered as individual files

Changed

• Avatars are now square with a border outline
• Notification titles use body font (Akkurat Pro) instead of heading font, with medium weight
• Dark mode table headers use a subtle purple tint instead of near-invisible surface color

Fixed

• Global search placeholder text invisible in light mode
• Global search input focus ring not visible on purple topbar in light mode
• Global search input background too purple in dark mode
• Avatar border not visible in dark mode
• Badge border too faint in light mode

Fixed

• Footer render hook now scoped to the registering panel, preventing it from rendering on unrelated panels in multi-panel applications

• Initial public release
• Northwestern brand colors, typography (Akkurat Pro & Poppins), and layout overrides for Filament panels
• Optional footer with configurable office contact information
• Default favicon and brand logo with automatic fallback