fullstackhero

Guide

Install

Every way to get the kit — the fsh CLI, the dotnet new template, a git clone, and GitHub (Use this template / Codespaces).

views 0 Last updated

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

Which path?

PathRenames the projectBest for
fsh CLI (recommended)YesStarting a new app; interactive setup + environment check
dotnet new templateYesScripted/CI scaffolding without the CLI
git cloneNoReading the source, contributing, or running the kit as-is
GitHub template / CodespacesYes (via GitHub)Zero local install, or your own repo from the template

Path 1 — The fsh CLI (recommended)

A NuGet-distributed dotnet tool that scaffolds a fresh project from the latest template.

Terminal window
dotnet tool install -g FullStackHero.CLI
fsh doctor          # verify SDK, Docker, Aspire workload, free ports
fsh new MyApp       # interactive: pick DB provider + whether to include Aspire
cd MyApp
dotnet run --project src/Host/MyApp.AppHost

Non-interactive (handy for scripts):

Terminal window
fsh new MyApp --db postgres --no-git

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

Path 2 — The dotnet new template

Install the template from NuGet, then scaffold without the CLI:

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

Path 3 — Clone the repository

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

Terminal window
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 4 — 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 fully provisioned, zero-install dev environment (.NET 10, Docker, and the Aspire workload are preconfigured).

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

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 /scalar.

Next