Package icon

Noundry.UI 1.52.0

by Noundry UI Contributors

Noundry UI

A modern C# ASP.NET TagHelper library that provides server-side components with Alpine.js and Tailwind CSS integration for building beautiful, interactive web applications.

Features

  • 71 UI TagHelpers - Complete set of interactive components
  • Full Model Binding - Seamless ASP.NET model binding support
  • Accessibility Ready - ARIA attributes and keyboard navigation
  • Tailwind CSS Integration - Beautiful, consistent styling
  • Alpine.js Powered - Lightweight client-side interactivity
  • Tailbreeze Compatible - Automatic CSS compilation integration

Quick Start

Installation

dotnet add package Noundry.UI
dotnet add package Noundry.Tailbreeze

Program.cs:

using Noundry.UI.Extensions;
using Tailbreeze.Extensions;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages();
builder.Services.AddNoundryUI();
builder.Services.AddTailbreeze();  // Handles all Tailwind CSS compilation

var app = builder.Build();

app.UseStaticFiles();
app.UseTailbreeze();
app.MapRazorPages();

app.Run();

_ViewImports.cshtml:

@addTagHelper *, Noundry.UI
@addTagHelper *, Tailbreeze

_Layout.cshtml:

<!DOCTYPE html>
<html>
<head>
    <tailwind-link />
    
    <!-- Alpine.js (required) -->
    <script defer src="https://unpkg.com/@alpinejs/collapse@3.x.x/dist/cdn.min.js"></script>
    <script defer src="https://unpkg.com/@alpinejs/focus@3.x.x/dist/cdn.min.js"></script>
    <script defer src="https://unpkg.com/alpinejs@3.x.x/dist/cdn.min.js"></script>
    
    <style>[x-cloak] { display: none !important; }</style>
</head>
<body>
    @RenderBody()
</body>
</html>

That's it! Tailbreeze automatically detects Noundry.UI's safelist and includes all component styles.

Tailwind CSS Integration

Noundry.UI components use dynamic Tailwind CSS classes that are generated at runtime. For these to work:

Tailbreeze automatically detects noundry-ui-safelist.html (copied to your project during build) and includes all component classes in the compiled CSS.

No manual configuration required!

Without Tailbreeze (Manual Setup)

If not using Tailbreeze, add the safelist to your tailwind.config.js:

export default {
  content: [
    "./Pages/**/*.{cshtml,razor}",
    "./Views/**/*.cshtml",
    "./noundry-ui-safelist.html"  // Add this line
  ],
}

Disabling Automatic Safelist Copy

<!-- In your .csproj -->
<PropertyGroup>
  <NoundryUICopyClassFiles>false</NoundryUICopyClassFiles>
</PropertyGroup>

Basic Usage

Buttons

<noundry-button variant="primary">Primary</noundry-button>
<noundry-button variant="secondary">Secondary</noundry-button>
<noundry-button variant="danger">Delete</noundry-button>

Alerts

<noundry-alert type="success" dismissible="true" title="Success!">
    Your action was completed successfully.
</noundry-alert>

Form Controls

<noundry-text-input asp-for="Name" label="Full Name" />
<noundry-text-input asp-for="Email" type="email" />
<noundry-switch asp-for="EnableNotifications" label="Enable Notifications" />
<noundry-select asp-for="Country" items="Model.Countries" />

Interactive Components

<!-- Modal -->
<noundry-modal title="Confirm" button-text="Open">
    <p>Are you sure?</p>
</noundry-modal>

<!-- Accordion -->
<noundry-accordion>
    <noundry-accordion-item title="Section 1">Content here</noundry-accordion-item>
</noundry-accordion>

<!-- Tabs -->
<noundry-tabs>
    <noundry-tab-item title="Tab 1">Tab content</noundry-tab-item>
</noundry-tabs>

Available Components

Layout & Navigation

  • Accordion, Tabs, Dropdown Menu, Breadcrumbs, Navigation Menu

Feedback & Status

  • Alert, Badge, Toast, Progress, Banner

Form Controls

  • Button, Text Input, Textarea, Select, Multi-Select, Checkbox, Radio Group, Switch, Date Picker, Range Slider, File Upload

Overlays & Modals

  • Modal, Slide Over, Tooltip, Popover, Hover Card

Data Display

  • Table, Data Table, Card, Stat Card, Image Gallery, Skeleton

Advanced

  • Command Palette, Copy to Clipboard, Combobox, Context Menu

Documentation

License

MIT License - see LICENSE.md

.NET 8.0

No dependencies.

.NET 9.0

No dependencies.

.NET 10.0

No dependencies.

No packages depend on Noundry.UI.

Version Downloads Last Updated
1.52.0 Current 17 1/8/2026
1.51.0 12 12/30/2025

Info

Statistics

Total Downloads
29
Current Version Downloads
17

Authors

Noundry UI Contributors