Skip to content
fullstackhero

Reference

Overview

The fsh CLI — scaffold projects, check your environment, and stay current.

views 0 Last updated

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.

Terminal window
fsh new MyApp
fsh new MyApp --no-aspire --no-frontend
fsh new MyApp --non-interactive -o ./somewhere-else
FlagWhat it does
[name]Project name — used for the solution, namespaces, and folders
-o, --outputOutput directory (defaults to ./<name>)
--no-aspireExclude the .NET Aspire AppHost project
--no-frontendExclude the React admin + dashboard apps
--skip-installSkip npm install for the React apps after scaffolding
--non-interactiveSkip prompts and use defaults (name becomes required)
--gitInitialize a git repository (on by default)
--dry-runShow 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)
  • Ports5030, 7030 (API) and 15888 (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.