v2.0.1

What's Changed

🐛 Bug Fixes

• fix(select): select value(s) provided in @bind-Value(s) after async initialization by @desmondinho in #246

Full Changelog: v2.0.0...v2.0.1

v2.0.0

It's finally done — LumexUI v2.0 is here!

LumexUI v2.0 is a major milestone that introduces Tailwind CSS v4 support, a CSS-first theming system with dark mode, new powerful components, and a refreshed documentation experience.

🔧 Framework & Theming

• Tailwind CSS v4 support – LumexUI now fully supports Tailwind CSS v4 and drops v3 support.
• CSS-first theming system – replaced the old C#-based theme provider with a modern CSS variable–driven approach.
• Dark mode – added first-class dark mode support across all components and documentation, including theme toggling.
• Icons – dropped built-in support for Google Material Icons to let consumers decide what icon library to use.

🧩 New Components

• Alert. Alerts display concise feedback about an action or event for the user.
• Avatar & AvatarGroup. Avatars represent a user or entity using an image, initials, or a fallback icon.
• Badge. Badges are small indicators used to display status, counts, or contextual information attached to other UI elements.
• Chip. Chips are used to display information, tags, or actions in a concise form.
• Skeleton. Skeletons are used as loading placeholders, indicating content is being loaded.
• Spinner. Spinners indicate loading states with a visual cue.
• Tooltip. Tooltips display a brief, informative message that appears when a user interacts with an element.

🎨 Component Improvements

• Button – new IconOnly parameter, dark mode styling, improved cursor handling.
• Popover / Dropdown / Tooltip – refactored for better positioning, auto-update, and reduced flicker.
• DataGrid, Input, Checkbox, Select, Navbar, etc. – fixed and polished styles, accessibility tweaks, and dark mode support.

📖 Documentation

• New dark mode toggle and improved live previews.
• Showcases on the Home page to demonstrate LumexUI in action.
• New component pages for Avatar, Skeleton, Spinner, Chip, Badge, Tooltip, and Alert.
• Improved installation & customization guides (including Tailwind v4 and theming).

⚠️ Breaking Changes

• Tailwind CSS v3 support dropped – LumexUI v2 requires Tailwind CSS v4.
• Theming system migration – replaced C# theme config with CSS-first variables.
• Icons – Google Material Icons are removed; a consumer decides what icon library to use.

Start using LumexUI v2.0 today by installing it in a new project or follow the migration guide to update existing ones!

Full Changelog: v1.1.1...v2.0.0

v2.0.0-preview.4

What's Changed

✨ New Features

• feat(components): introduce Spinner component by @desmondinho in #207
• feat(components): introduce Chip component by @desmondinho in #211
• feat(components): add new Badge component by @desmondinho in #222
• feat(components): add Tooltip component by @desmondinho in #224
• feat(components): add Alert component by @desmondinho in #225
• feat(theme): introduce a mechanism to toggle light/dark modes by @desmondinho in #230
• feat(components): add dark mode support by @desmondinho in #234

🐛 Bug Fixes

• fix(theme): add tw custom CSS class-based dark mode variant by @desmondinho in #226

🛠 Refactor

• refactor(theme): replace C# theme config with a new CSS-first approach by @desmondinho in #229
• refactor(*): remove all bundled Google Material Icons and related code by @desmondinho in #232

📝 Docs

• docs: add dark mode support + theme toggle by @desmondinho in #235
• docs: add Home page with library usage examples by @desmondinho in #241

Chore

• build(deps): bump requests from 2.32.0 to 2.32.4 in /scripts by @dependabot[bot] in #219

💥 Breaking Changes

• Dropped Tailwind CSS v3 in favour of v4
• Dropped LumexTheme configuration in favour of a new CSS-first theming approach
• Dropped all bundled Google Material icons to let the consumer decide what icons they want to use

Full Changelog: v2.0.0-preview.3...v2.0.0-preview.4

v2.0.0-preview.3

What's Changed

✨ New Features

• feat(components): introduce Avatar and AvatarGroup components by @desmondinho in #201
• feat(components): introduce Skeleton component by @desmondinho in #202

🐛 Bug Fixes

• fix(navbar): add a check before toggling navbar menu on navigation by @desmondinho in #204

Full Changelog: v2.0.0-preview.2...v2.0.0-preview.3

v2.0.0-preview.2

What's Changed

• fix(theme): remove extra shade (950) from the color scales for a contrast consistency by @desmondinho in #200

Full Changelog: v2.0.0-preview.1...v2.0.0-preview.2

v2.0.0-preview.1

This is a pre-release version of v2.0.0, focusing on upgrading the library to Tailwind CSS v4.
Since this introduces breaking changes (dropping Tailwind v3 support), I am releasing this preview version to allow to test and provide feedback before the final release.

🔥 What's New?

• Upgraded to Tailwind CSS v4 by @desmondinho in #183

⚠️ Breaking Changes

• Dropped Tailwind CSS v3 support.

• Custom CSS variables --lumex-box-shadow-* changed to --lumex-shadow-* to be more like new Tailwind CSS variable --shadow-*.

• Custom CSS variables --lumex-*-opacity change to --lumex-opacity-* to better match the rest of custom CSS variables.

• The font size of the LumexButton decreases by one step for each size variant:

  Before:

  <LumexButton Size="@Size.Small">...</LumexButton> @* `text-small` CSS class *@
  <LumexButton Size="@Size.Medium">...</LumexButton> @* `text-medium` CSS class *@
  <LumexButton Size="@Size.Large">...</LumexButton> @* `text-large` CSS class *@

  Now:

  <LumexButton Size="@Size.Small">...</LumexButton> @* `text-tiny` CSS class *@
  <LumexButton Size="@Size.Medium">...</LumexButton> @* `text-small` CSS class *@
  <LumexButton Size="@Size.Large">...</LumexButton> @* `text-medium` CSS class *@

🚀 How to Upgrade

👉 Refer to the Tailwind CSS v4 Upgrade Guide for details.
👉 Refer to the new LumexUI installation guide (preview) for details.

I have improved the installation process by including a custom .targets file in the package.

This file contains an MSBuild script that runs automatically after the build, copying all files from the package's theme folder to your project's bin directory, creating a new lumexui folder.

I chose the bin directory because it is ignored by .gitignore by default. However, you can customize this path by manually overriding the LumexUIDir property in your YourProject.csproj file:

<PropertyGroup>
    <LumexUIDir>your/desired/path</LumexUIDir>
</PropertyGroup>

📣 How to Provide Feedback

Since this is a preview release, I encourage testing and feedback.

🔹 Report issues in GitHub.
🔹 Discuss migration challenges in Discussion.

Your feedback will help ensure a smooth final release of v2!

Full Changelog: v1.1.1...v2.0.0-preview.1

v1.1.1

What's Changed

🐛 Bug Fixes

• fix(switch): ensure secondary color styles apply properly by @desmondinho in #182

Full Changelog: v1.1.0...v1.1.1

v1.1.0 🎉

It’s been almost two months since v1.0.0, and honestly, this update isn’t as big as I wanted it to be. Life happens, other projects took some time, but I’m still here, and I still want to keep improving LumexUI.

Looking ahead, I have some cool things planned:

• New components like Avatar, Badge, Chip, Tooltip, and more.
• Better showcases—examples of LumexUI in actual dashboards, forms, and other complex UIs, so it’s easier to see it in action.
• Documentation needs a dark mode. :)

Thanks for sticking around! More updates are coming 🚀

What's Changed

✨ New Features

• feat(components): apply data-slot attribute to all component parts by @desmondinho in #127
• feat(components): introduce Tabs component by @desmondinho in #159
• feat(components): add XML summaries to all publicly visible members by @desmondinho in #162
• feat(components): introduce Dropdown component by @desmondinho in #168

📝 Docs

• fix(docs): correct typo in the 'Configure startup file' section of installation guide by @DavidH102 in #147
• docs: remove prerelease flag from the installation step by @mariuskrass in #150
• feat(docs): Add warning about using Tailwind CSS v4.0 by @aurepereira in #160

🛠️ Chore

• build(deps): add compatibility for .NET 9 by @desmondinho in #161
• build(deps): bump Markdig from 0.38.0 to 0.40.0 by @dependabot in #153
• build(deps): bump xunit.runner.visualstudio from 2.8.2 to 3.0.1 by @dependabot in #152
• build(deps): bump bunit from 1.36.0 to 1.38.5 by @dependabot in #151
• build(deps): bump FluentAssertions from 6.12.2 to 8.0.1 by @dependabot in #158

New Contributors

• @DavidH102 made their first contribution in #147
• @mariuskrass made their first contribution in #150
• @aurepereira made their first contribution in #160

Full Changelog: v1.0.0...v1.1.0

v1.0.0 🎉

After 2 months of refining and perfecting the pre-release, I am happy to announce the launch of LumexUI v1.0.0! This marks a significant milestone for the library and for me personally, and just in time as we welcome a brand-new year full of opportunities and innovations.

🚀 What's New in v1.0.0

Components

• Listbox displays a list of options and allow users to select one or more of them
• Radio Group allows users to select one option from a set
• Select displays a collapsible list of options and allow users to select them

🙏 Acknowledgements

A heartfelt thank you to everyone who contributed to the development and testing of LumexUI. Your support and feedback have been invaluable in bringing this library to life.

New Contributors

• @creanium made their first contribution in #113

Full Changelog: v0.1.9...v1.0.0

v1.0.0-preview.4

What's Changed

✨ New Features

• feat: add the DataGrid component and demo page [preview] by @desmondinho in #105

Full Changelog: v1.0.0-preview.3...v1.0.0-preview.4