PureBlazor.Components
0.9.0
Prefix Reserved
See the version list below for details.
dotnet add package PureBlazor.Components --version 0.9.0
NuGet\Install-Package PureBlazor.Components -Version 0.9.0
<PackageReference Include="PureBlazor.Components" Version="0.9.0" />
paket add PureBlazor.Components --version 0.9.0
#r "nuget: PureBlazor.Components, 0.9.0"
// Install PureBlazor.Components as a Cake Addin #addin nuget:?package=PureBlazor.Components&version=0.9.0 // Install PureBlazor.Components as a Cake Tool #tool nuget:?package=PureBlazor.Components&version=0.9.0
){kind=icon}
PureBlazor Components
[!NOTE] This component library is pre-release software.
Native Blazor UI components. Free to use for any Blazor project.
Works seamlessly with PureBlazor CMS.
Features
- Native Blazor - We want components built for Blazor, not a wrapper around a JavaScript library.
- Blazing Fast - We want components that are fast on every platform.
- Headless Mode - We want components that are easy to customize.
- Tailwind Compatible - Automatically merge your Tailwind classes with built-in styles.
[!NOTE] This documentation is incomplete. Not all components are documented yet.
Please feel free to ask questions in the Discord, open an issue, or create a pull request.
Getting started
Installation
Install the PureBlazor.Components NuGet package.
dotnet add package PureBlazor.Components
Register the components and services to your Program.cs file.
builder.Services.AddPureBlazorComponents();
Theming
PureBlazor components use Tailwind CSS and are designed to be customizable with pure CSS or with more Tailwind styles.
Additionally, there are more extensibility points for customizing the components with C#. Documentation will come as this is further solidified.
Headless Mode
You can wrap individual components, or your entire app using a CascadingValue for the Theme property.
<CascadingValue Value="Theme.Off">
<PureButton>Unstyled button</PureButton>
</CascadingValue>
Use the default styles
Include pureblazor.css in your App.Razor file, in the <head> tag.
<script src="_content/PureBlazor.Components/pureblazor.css"></script>
Use dotnet-tailwind or the Tailwind CLI
PureBlazor components are compatible with Tailwind CSS. You can use the dotnet-tailwind tool to compile your Tailwind,
or use the Tailwind CLI.
Use the Tailwind CDN
Include the following scripts in your App.razor file. Change your brand colors to match your desired primary color.
<script src="https://cdn.tailwindcss.com"></script>
<script>
tailwind.config = {
darkMode: 'class',
theme: {
extend: {
fontFamily: {
sans: ['Inter var', 'ui-sans-serif', 'system-ui', '-apple-system', 'BlinkMacSystemFont', "Segoe UI", 'Roboto', "Helvetica Neue", 'Arial', "Noto Sans", 'sans-serif', "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"],
},
borderRadius: {
'xs': '0.0625rem',
},
colors: {
brand: {
'50': '#eff9ff',
'100': '#dff1ff',
'200': '#b7e5ff',
'300': '#77d1ff',
'400': '#2fbbff',
'500': '#04a3f3',
'600': '#0081d0',
'700': '#0067a8',
'800': '#015486',
'900': '#074873',
'950': '#052e4c',
},
}
}
},
}
</script>
FAQ
Why not use xx library?
Our features section is a good place to start to understand our goals.
In addition, our components are built to work seamlessly with the PureBlazor CMS.
Is this library free to use?
- Yes! This library is free to use for any Blazor project.
Can I use this library with .NET MAUI Blazor projects?
- This library should work with .NET MAUI, but we have not tested it yet. Please let us know if you have any issues.
Can I use this library with Blazor WebAssembly / Blazor Server / InteractiveAuto?
- Yes. This library supports all Blazor hosting models.
Is this library production-ready?
- No. This library is still in development.
Do you accept contributions?
- Yes! We accept contributions. Please see the CONTRIBUTING.md file for more information.
How do I report a bug?
- Please open an issue on the GitHub repository.
- Please include as much information as possible, including the version of the library you are using, the browser you are using, and any steps to reproduce the issue.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- Microsoft.AspNetCore.Components.Web (>= 8.0.1)
- Microsoft.AspNetCore.Components.WebAssembly (>= 8.0.0)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on PureBlazor.Components:
| Package | Downloads |
|---|---|
|
PureBlazor.Components.AspNetCore
ASP.NET Core integration package for PureBlazor UI components. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last updated |
|---|---|---|
| 0.40.0-rc2 | 0 | 11/2/2024 |
| 0.32.8 | 88 | 9/20/2024 |
| 0.32.0 | 115 | 9/18/2024 |
| 0.31.0 | 155 | 5/30/2024 |
| 0.30.0 | 117 | 5/25/2024 |
| 0.27.0 | 126 | 5/6/2024 |
| 0.26.0 | 119 | 5/5/2024 |
| 0.25.0 | 167 | 5/5/2024 |
| 0.24.0 | 109 | 5/5/2024 |
| 0.23.0 | 107 | 5/4/2024 |
| 0.22.0 | 99 | 5/3/2024 |
| 0.19.0 | 119 | 4/29/2024 |
| 0.18.0 | 201 | 4/26/2024 |
| 0.17.0 | 108 | 4/26/2024 |
| 0.16.0 | 113 | 4/26/2024 |
| 0.15.0 | 119 | 4/26/2024 |
| 0.14.0 | 120 | 4/26/2024 |
| 0.13.0 | 127 | 4/26/2024 |
| 0.12.0 | 119 | 4/26/2024 |
| 0.11.0 | 114 | 4/26/2024 |
| 0.10.0-preview1 | 95 | 4/9/2024 |
| 0.9.2 | 113 | 4/4/2024 |
| 0.9.1 | 104 | 4/4/2024 |
| 0.9.0 | 104 | 4/4/2024 |
| 0.8.0 | 108 | 4/4/2024 |
| 0.7.0 | 128 | 4/4/2024 |
| 0.6.0 | 116 | 4/3/2024 |
| 0.5.0 | 133 | 4/2/2024 |
| 0.4.0 | 105 | 4/2/2024 |
| 0.3.0 | 126 | 4/2/2024 |
| 0.2.0 | 127 | 4/1/2024 |
| 0.2.0-preview | 92 | 4/26/2024 |
| 0.1.0 | 118 | 3/21/2024 |
| 0.1.0-alpha.1 | 98 | 2/2/2024 |
| 0.0.9 | 117 | 3/21/2024 |
Add pureblazor.css