How fullstackhero/dotnet-starter-kit works
FullStackHero is a source-owned, multi-tenant SaaS starter kit: a modular .NET API backend and separate operator and tenant React applications. The main user workflow is to sign in, use an app’s domain screens, and exchange data with the API; the backend routes work into bounded-context modules backed by shared persistence and services. The README also documents CLI scaffolding, migrations, real-time features, and external infrastructure. Several backend modules and integrations are unsampled, so those branches reflect README-level capabilities rather than inspected implementation details.
Main entry points: Program.cs Minimal API host · GetAuditsQueryHandler.cs Audit queries · QuotaMeteredStorageService.cs Quota-metered storage · routes.tsx Admin console
Components 24
React applications
- Admin console
clients/admin/src/routes.tsx - Tenant dashboard
clients/dashboard/src/routes.tsx
API and domain modules
- Minimal API host
src/Host/FSH.Starter.Api/Program.cs - Identity and access
src/Modules/Identity/Modules.Identity/IdentityModule.cs - Tenant management
src/Modules/Multitenancy/Modules.Multitenancy/MultitenancyModule.cs - Billing
src/Modules/Billing/Modules.Billing - Catalog and tickets
src/Modules/Catalog/Modules.Catalog - Chat and realtime
src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs - File management
src/Modules/Files/Modules.Files - Webhooks
src/Modules/Webhooks/Modules.Webhooks - Audit queries
src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs - Audit persistence
src/Modules/Auditing/Modules.Auditing/Persistence/AuditDbContext.cs
Shared platform services
- Shared domain context
src/BuildingBlocks/Shared - Quota-metered storage
src/BuildingBlocks/Storage/QuotaMeteredStorageService.cs - S3 storage
src/BuildingBlocks/Storage/S3/S3StorageService.cs - Local storage
src/BuildingBlocks/Storage/Local/LocalStorageService.cs
Provisioning and infrastructure
- Database migrator
src/Host/FSH.Starter.DbMigrator/Program.cs - fsh CLI
src/Tools/CLI/Program.cs - PostgreSQL
- Valkey and Hangfire
- S3-compatible store
- SignalR and SSE
Other components
- Operator
- Tenant user
Connections 25
- Operator → Admin console: uses
- Tenant user → Tenant dashboard: uses
- Admin console → Minimal API host: requests data
- Tenant dashboard → Minimal API host: requests data
- Minimal API host → Identity and access: dispatches to
src/Host/FSH.Starter.Api/Program.cs - Minimal API host → Tenant management: dispatches to
src/Host/FSH.Starter.Api/Program.cs - Minimal API host → Billing: dispatches to
src/Host/FSH.Starter.Api/Program.cs - Minimal API host → Catalog and tickets: dispatches to
src/Host/FSH.Starter.Api/Program.cs - Minimal API host → Chat and realtime: dispatches to
- Minimal API host → File management: dispatches to
src/Host/FSH.Starter.Api/Program.cs - Minimal API host → Webhooks: dispatches to
src/Host/FSH.Starter.Api/Program.cs - Minimal API host → Audit queries: dispatches to
- Audit queries → Audit persistence: queries
src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs - Audit queries → Identity and access: checks permission
src/Modules/Auditing/Modules.Auditing/Features/v1/GetAudits/GetAuditsQueryHandler.cs - Chat and realtime → PostgreSQL: queries messages
src/Modules/Chat/Modules.Chat/Features/v1/Search/SearchMessagesQueryHandler.cs - Audit persistence → PostgreSQL: persists audit records
- Minimal API host → Shared domain context: uses shared context
src/Host/FSH.Starter.Api/Program.cs - Quota-metered storage → S3 storage: delegates storage
src/BuildingBlocks/Storage/QuotaMeteredStorageService.cs - Quota-metered storage → Local storage: delegates storage
src/BuildingBlocks/Storage/QuotaMeteredStorageService.cs - Minimal API host → Valkey and Hangfire: uses services
- File management → Quota-metered storage: uses storage
- S3 storage → S3-compatible store: reads and writes
src/BuildingBlocks/Storage/S3/S3StorageService.cs - Minimal API host → SignalR and SSE: serves realtime
- Database migrator → PostgreSQL: migrates schema
- fsh CLI → Operator: scaffolds project