Skip to content
fullstackhero

Guide

Quick Start

Scaffold a fullstackhero project and run it locally in under a minute.

views 0 Last updated

The fastest path uses the FSH CLI — a NuGet-distributed tool that scaffolds a new project from the latest template.

1. Install the CLI

Terminal window
dotnet tool install -g FullStackHero.CLI

2. Scaffold a project

Terminal window
fsh new MyApp
cd MyApp

The interactive wizard asks for your database provider and whether to include the Aspire AppHost. Run fsh doctor first if you’d like to verify your environment (SDK, Docker, Aspire workload, free ports).

Want it non-interactive?

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

3. Run

Terminal window
dotnet run --project src/Host/MyApp.AppHost

Aspire brings up Postgres and Valkey containers, wires connection strings, launches the API host, and enables OTLP export. Open the Aspire dashboard to watch services start; the API serves at https://localhost:5285 with OpenAPI and Scalar at /scalar/v1.

Next

  • Install — alternative install paths (dotnet new template, git clone, Codespaces).
  • Architecture — the modular monolith + VSA mental model.
  • CLI — every fsh command and option.