Get the Starter App

Everything from Act 0 on uses one small app, a .NET budget tracker. This step gets it onto your machine and confirms it runs, so the workshop itself can stay about Kiro, not setup.

1. Install the .NET SDK

The workshop app targets .NET 10. On macOS, Windows, or most Linux, install it with dotnetup, the .NET toolchain manager — it installs and manages .NET at the user level, no admin required. On Ubuntu, the simplest path is straight from apt.

1. Install the SDK for your platform.

   macOS / Linux

   Download and run dotnetup:

   curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

   Follow the printed instructions to add dotnetup to your PATH and restart your terminal, then run it and take the suggested first-time setup:

   dotnetup

   • Channel: pick 10.0. The workshop app targets .NET 10.
   • Mode: pick Terminal Mode.
   Windows (PowerShell)

   Download and run dotnetup:

   iwr https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

   Follow the printed instructions to add dotnetup to your PATH and restart your terminal, then run it and take the suggested first-time setup:

   dotnetup

   • Channel: pick 10.0. The workshop app targets .NET 10.
   • Mode: pick Terminal Mode.
   Ubuntu (apt)

   Install the SDK directly from apt — no toolchain manager needed:

   sudo apt-get update && \
     sudo apt-get install -y dotnet-sdk-10.0

2. Verify the install (restart your terminal first if you used dotnetup):

   dotnet --version

Deterministic alternative: let the repo pick the SDK

Using dotnetup? The starter repo pins its SDK in global.json. Once you’ve cloned it (next step) you can skip the channel choice: run dotnetup sdk install inside it and dotnetup installs exactly the .NET the app needs. dotnet then refuses any mismatched SDK, so you can’t accidentally end up on the wrong one.

2. Clone and run the app

1. Clone the starter repo:

   git clone https://github.com/dwalleck/kiro-hero-budget-tracker.git budget-tracker
   cd budget-tracker

2. Run it once to confirm everything works:

   dotnet run --urls http://localhost:5000

3. Open http://localhost:5000 in your browser. You should see the dashboard: this month’s spending up top, with the seeded transactions below it.

   

Checkpoint

Everyone has dotnet --version working and the app responding on http://localhost:5000.