BlazorBlueprint.Templates 3.0.1

BlazorBlueprint Templates

Project templates for creating Blazor applications with BlazorBlueprint pre-installed.

Installation

dotnet new install BlazorBlueprint.Templates

Usage

Create a new project

# Default: Auto render mode with component showcase
dotnet new blazorblueprint -n MyApp

# WebAssembly mode
dotnet new blazorblueprint -n MyApp -R WebAssembly

# Auto mode (Server then WASM)
dotnet new blazorblueprint -n MyApp -R Auto

# Without showcase pages
dotnet new blazorblueprint -n MyApp -I false

# Target .NET 10
dotnet new blazorblueprint -n MyApp -F net10.0

Run your new project

cd MyApp
dotnet run

Visit https://localhost:5001 to see your app.

Template Parameters

What's Included

• BlazorBlueprint.Components - 80+ pre-styled components (shadcn/ui design)
• BlazorBlueprint.Primitives - 17 headless primitives for custom styling
• BlazorBlueprint.Icons.Lucide - 1,640+ beautiful icons
• Tailwind CSS - Pre-built utilities with config file for customization
• Toast notifications - Ready to use
• Dark mode support - Built-in theme switching
• Showcase pages - Learn by example (optional)

Showcase Pages

When --IncludeShowcase is true (default), your project includes demo pages at /showcase/*:

• Buttons - All button variants, sizes, and states
• Cards - Card layouts and compositions
• Forms - Inputs, selects, checkboxes, and more
• Dialogs - Modals, alert dialogs, and sheets
• Alerts - Alert banners and toast notifications
• Navigation - Tabs, accordions, and collapsibles
• Data Display - Tables, avatars, badges, and progress

To remove showcase pages, simply delete the Pages/Showcase/ folder.

Customizing CSS

The template includes a Tailwind CSS setup with pre-built utilities:

• wwwroot/css/app.css - Pre-built Tailwind utilities (generated during build)
• wwwroot/css/app-input.css - Tailwind source file
• tailwind.config.js - Tailwind configuration with theme color mappings

Regenerating CSS

If you add new Tailwind classes to your pages, rebuild the CSS:

# Windows (requires tailwindcss.exe in tools/ folder)
tools\tailwindcss.exe -i wwwroot/css/app-input.css -o wwwroot/css/app.css --minify

# Or install Tailwind CLI globally
npx tailwindcss -i wwwroot/css/app-input.css -o wwwroot/css/app.css --minify

Theme Customization

Edit wwwroot/styles/themes/default.css to customize colors. See THEMING.md for all available CSS variables.

Uninstall

dotnet new uninstall BlazorBlueprint.Templates

Development

To test templates locally:

# Install template from source
./scripts/install-template-local.sh

# Create and run a test project
./scripts/create-template-test.sh
./scripts/run-template-test.sh

To rebuild template CSS after modifying content:

npx tailwindcss -i content/BlazorBlueprint.WebApp/wwwroot/css/app-input.css -o content/BlazorBlueprint.WebApp/wwwroot/css/app.css --minify

Links

• BlazorBlueprint Documentation
• GitHub Repository
• Component Reference
• Theming Guide