StellarAdmin.UI is a collection of beautifully designed components based on shadcn/ui which you can use to create CRUD screens in ASP.NET Core MVC and Razor Pages applications.
Note: StellarAdmin is in 0.x, so any release may contain breaking changes. Pin the version you use and read the release notes before you upgrade.
Install the StellarAdmin.UI NuGet package:
dotnet add package StellarAdmin.UIUpdate your Program.cs (or Startup.cs) to register the StellarAdmin services.
using StellarAdmin.UI;
builder.Services.AddStellarAdminUI();Update your _ViewImports.cshtml to register the StellarAdmin Tag Helpers and import the StellarAdmin.UI namespace.
@using StellarAdmin.UI
@addTagHelper *, StellarAdmin.UIAdd the StellarAdmin stylesheet and the StellarAdmin JavaScript file to your Razor page or layout.
<!DOCTYPE html>
<html lang="en">
<head>
...
<link rel="stylesheet" href="/_content/StellarAdmin.UI/stellar-admin.css" asp-append-version="true"/>
<script type="module" src="/_content/StellarAdmin.UI/stellar-admin.js" asp-append-version="true"></script>
</head>
<body>
...
</body>
</html>Tip
To change the default theme, create a theme file in the theme builder and link it after the stylesheet. The Theming page provides more information on theming.
Start using the StellarAdmin Tag Helpers inside your Razor Pages or MVC Views. For example, the code snippet below adds an alert to your page.
<sa-alert>
<sa-alert-title>Success! You have configured StellarAdmin correctly.</sa-alert-title>
</sa-alert>Documentation and code examples for all the Tag Helpers can be found online.
StellarAdmin ships agent skills for each product:
- The StellarAdmin UI skill teaches agents how to build MVC and Razor Pages UIs in
.cshtmlfiles, with component references and workflows for forms, layout, and theming. Its supporting documentation is bundled underskills/stellar-admin-ui/references/. - The StellarAdmin theme skill writes theme files from a description or brand colours.
- The admin panel setup skill installs the admin panel, and the admin panel skill builds resources, forms and the sidebar with it.
From your application's project directory, install them with Vercel's skills CLI and choose the ones for the product you use:
npx skills add stellar-admin/stellar-adminThe skills are maintained alongside StellarAdmin; their references may include changes newer than your installed NuGet package. See installation and compatibility for prerequisites, agent selection, installing a single skill, and local-checkout installation.
StellarAdmin.UI also supplies the icon services in StellarAdmin.UI.Icons; configure icons, menus, and forms through AddStellarAdminUI(ui => ...).
This repository also contains StellarAdmin (the admin panel: admin shell and resource screens) and StellarAdmin.EntityFrameworkCore (EF Core resources). Both are MIT licensed. Register the admin panel with AddStellarAdmin(admin => ...) and map it with MapStellarAdmin(); it registers StellarAdmin.UI itself, and admin.ConfigureUI(...) configures it. The AdminPlayground demonstrates Identity user and role management through ordinary resources. There is no paid tier. The packages are available from source; their NuGet publication is a separate release step.
The full solution includes a unified docs/DocsSamples app, the website demo exporter, AdminPlayground, and the admin panel and EF Core resource integration tests.
Start with contributor guidance and development and verification. This checkout includes the development skills, maintained designs, and plans; no workspace checkout is required. The public website remains a separate repository.