Skip to content

Development

Local run

dotnet run --project src/{ProjectName}

Default: https://localhost:5000 / http://localhost:5001.

UIKit and Flowbite assets

The template uses ConnectSoft.Blazor.UIKit and Flowbite adapters. Published static assets are validated in integration tests (PublishedStaticAssetsTests). See adapters.md for the styling contract.

Tailwind and theme

Prebuilt wwwroot/css/tailwind.css — no live Tailwind build pipeline in the baseline. Design tokens in design-tokens.css; light/dark via ThemeToggle + shell.js; RTL via dir on <html> for Hebrew.

JSON content authoring

  • Placeholder copy lives in wwwroot/data/pages/*.json
  • Override JSON per consumer site; no Razor edits required for copy changes
  • IPageContentService caches content (~10 minutes)

Adding pages and sections

  1. Add a .razor page under Components/Pages/ with @page directive
  2. Compose from existing section components in Components/Sections/
  3. Register route in navigation via INavigationCatalog or feature flags
  4. Add JSON content file if the page is data-driven

Feature flags

Use Microsoft.FeatureManagement in appsettings.json to toggle page packs at runtime without regenerating the solution.

Template authoring

When changing template.json, keep docs/template-parameters.md and docs/page-catalog.md in sync.

Repo guides: flowbite-page-variants.md, site-profiles.md.