A NuGet-distributed dotnet tool (Spectre.Console, source at src/Tools/CLI) for scaffolding fullstackhero projects and verifying your environment. Four commands: new, doctor, info, update.
fsh new
Scaffolds a fresh, fully renamed project from the latest template. Run bare for the interactive wizard (project name, include Aspire?, include the React apps?), or pass everything as flags.
fsh new MyAppfsh new MyApp --no-aspire --no-frontendfsh new MyApp --non-interactive -o ./somewhere-else| Flag | What it does |
|---|---|
[name] | Project name — used for the solution, namespaces, and folders |
-o, --output | Output directory (defaults to ./<name>) |
--no-aspire | Exclude the .NET Aspire AppHost project |
--no-frontend | Exclude the React admin + dashboard apps |
--skip-install | Skip npm install for the React apps after scaffolding |
--non-interactive | Skip prompts and use defaults (name becomes required) |
--git | Initialize a git repository (on by default) |
--dry-run | Show what would be created without creating anything |
Beyond renaming, new does the setup you’d otherwise do by hand: installs the template if it’s missing, replaces the shared dev JWT signing key with a unique per-project one, generates deploy/docker/.env with strong random secrets so docker compose up works immediately, runs npm install in both React apps, and makes the initial commit on a main branch.
fsh doctor
Checks your environment and prints a pass/warn/fail table:
- .NET SDK — present and version 10+
- Git — installed
- Docker — installed and running
- FSH template — installed (warns with the install command if not)
- Ports —
5030,7030(API) and15888(Aspire dashboard) free
Exits non-zero if a required tool is missing, so it’s scriptable.
fsh info
Shows the CLI version, the latest version on NuGet (and whether an update is available), the installed and latest template versions, your .NET SDK version, and links to the docs and release notes.
fsh update
Updates both halves in one go: dotnet tool update -g FullStackHero.CLI for the CLI, then reinstalls the latest FullStackHero.NET.StarterKit template.
In progress
Detailed pages for this section are being written.