fullstackhero

Guide

Quick Start

Clone fullstackhero and run the whole stack locally with one command.

views 0 Last updated

The quickest way to run the kit today is to clone the repo and start it with .NET Aspire.

1. Clone the repo

Terminal window
git clone https://github.com/fullstackhero/dotnet-starter-kit.git MyApp
cd MyApp

A clone keeps the original FSH.Starter project names — it doesn’t rename the solution. Once the stable CLI + template ship, fsh new MyApp will scaffold a fully renamed project.

2. Install frontend dependencies (one time)

Aspire launches both React apps for you, but it doesn’t install their packages:

Terminal window
cd clients/admin && npm install
cd ../dashboard && npm install
cd ../..

Skip this if you only want the API.

3. Run

Terminal window
dotnet run --project src/Host/FSH.Starter.AppHost

Aspire brings up Postgres (with pgAdmin), Valkey, and MinIO in containers, runs the DbMigrator (migrations + seed) and the demo seeder, then starts the API and both React apps — all wired together with connection strings and OTLP export. Watch everything come up in the Aspire dashboard.

Once it’s green:

WhatWhere
API + Scalar docshttps://localhost:7030/scalar
Admin apphttp://localhost:5173
Dashboard apphttp://localhost:5174

Log in with one of the seeded demo accounts — the dashboard login page has a persona picker in dev.

Next

  • Demo accounts — the seeded tenants, personas, and what each one demonstrates.
  • Troubleshooting — fixes for the common first-run failures (containers, volumes, ports, migrations).
  • Install — every install path (GitHub template, Codespaces, the CLI, and the dotnet new template).
  • Architecture — the modular monolith + VSA mental model.
  • CLI — the fsh commands and where the NuGet release stands.