Install

Make sure you’ve got everything in Prerequisites first. There are four ways to get the kit — pick based on whether you want the raw source, zero local install, or (soon) a renamed project from the CLI.

Which path?

Path 1 — Clone the repository (recommended for now)

Get the full source as-is, with no project renaming (the solution keeps its FSH.Starter names):

git clone https://github.com/fullstackhero/dotnet-starter-kit.git MyApp
cd MyApp
dotnet restore src/FSH.Starter.slnx
dotnet run --project src/Host/FSH.Starter.AppHost

This is the path for reading the code, contributing, or running the kit unchanged.

Path 2 — GitHub: Use this template / Codespaces

On the GitHub repo, click Use this template to create your own repository from the kit — or Open in Codespaces for a zero-install dev environment (the devcontainer ships the .NET 10 SDK and Docker-in-Docker, restores the solution, and forwards the API ports).

First Codespaces boot takes a couple of minutes; subsequent ones are instant.

Path 3 — The fsh CLI (prerelease)

A NuGet-distributed dotnet tool that scaffolds a fresh, fully renamed project from the latest template:

dotnet tool install -g FullStackHero.CLI --prerelease
fsh doctor          # verify .NET SDK, Git, Docker, the template, free ports
fsh new MyApp       # interactive: include Aspire? include the React apps?
cd MyApp
dotnet run --project src/Host/MyApp.AppHost

Non-interactive (handy for scripts) — skips the prompts and uses defaults:

fsh new MyApp --non-interactive

See the CLI reference for every command (new, doctor, info, update) and flag.

Path 4 — The dotnet new template (coming with the stable release)

Once published, you’ll install the template from NuGet and scaffold without the CLI:

dotnet new install FullStackHero.NET.StarterKit
dotnet new fsh -n MyApp
cd MyApp
dotnet run --project src/Host/MyApp.AppHost

Verify it’s running

However you installed, the AppHost launches the Aspire dashboard. Every service should reach a healthy/running state, and the API serves OpenAPI + Scalar at https://localhost:7030/scalar.

Next

• Quick Start — the minimal clone-and-run walkthrough.
• Local Orchestration with Aspire — what each service is and why it’s wired that way.
• Architecture — the modular monolith + vertical slice mental model.