Skip to content

Latest commit

Β 

History

History
144 lines (99 loc) Β· 4.35 KB

MINIMAL_SETUP_DOTNET.md

File metadata and controls

144 lines (99 loc) Β· 4.35 KB

Minimal Local Setup Guide β€” .NET Track

Use this guide if you want the fastest possible setup for the .NET track: no Dev Container, and only the extensions strictly required to use GitHub Copilot. No language-specific VS Code extension (like C# Dev Kit) is installed here β€” you'll rely on the standard dotnet CLI for build/test.

Want IntelliSense, debugging, and test explorer in VS Code? Use the full LOCAL_SETUP.md guide instead, which installs C# Dev Kit.


1. GitHub Account & Copilot Subscription


2. Git

  • Install Git
    • macOS: xcode-select --install or brew install git
    • Windows: git-scm.com/download/win
    • Linux: sudo apt install git / sudo dnf install git
  • Verify: git --version β†’ 2.30 or later
  • Configure identity:
    git config --global user.name "Your Name"
    git config --global user.email "your.email@example.com"

3. Visual Studio Code

  • Install VS Code (1.95+) β€” code.visualstudio.com
  • Verify: code --version
  • macOS extra step: Command Palette (Cmd+Shift+P) β†’ "Shell Command: Install 'code' command in PATH"

4. Minimal VS Code Extensions

Only the two extensions required to use Copilot:

Extension ID Purpose
GitHub Copilot GitHub.copilot Inline AI completions
GitHub Copilot Chat GitHub.copilot-chat Chat interface, agents, instructions
code --install-extension GitHub.copilot
code --install-extension GitHub.copilot-chat

After installing, sign in to GitHub when VS Code prompts you to activate Copilot.


5. Clone the Repository

git clone https://github.com/centricconsulting/ai-coding-workshop.git
cd ai-coding-workshop
git checkout main
git pull
git checkout -b your-name-workshop
code .

6. .NET 9 SDK


7. Verify the Build

# From the repository root
dotnet restore
dotnet build src-dotnet/TaskManager.sln
dotnet test

Expected: build succeeds for all projects, and tests report total: 11, failed: 11, succeeded: 0 β€” 11 failing tests is correct; they're workshop placeholders.


8. .NET HTTPS Dev Certificate

dotnet dev-certs https --trust

Accept any OS prompt to trust the certificate.


βœ… Verify GitHub Copilot Is Working

  1. Open src-dotnet/src/TaskManager.Domain/Tasks/Task.cs in VS Code.
  2. Check the Copilot icon in the status bar is active (not red/crossed out).
  3. Add a line and type a comment, e.g., // Method to validate task title, press Enter β€” you should see gray ghost-text suggestions.
  4. Press Tab to accept, Esc to dismiss, then delete the test line.
  5. Open Copilot Chat (Cmd/Ctrl+Shift+I) and ask What testing frameworks are used in this project? #codebase

Not working? Click the Copilot status bar icon β†’ "Sign in to GitHub", verify your subscription, or reload VS Code (Command Palette β†’ "Developer: Reload Window").


πŸ†˜ Quick Troubleshooting

Problem Solution
dotnet: command not found Restart terminal after install; check PATH
Old SDK version showing Restart terminal; run dotnet --list-sdks
Copilot suggestions not appearing Wait 1-2 seconds; check status bar icon; reload window
Build fails with "SDK not found" Confirm SDK version with dotnet --list-sdks

πŸ“‹ Quick-Check Before the Workshop

dotnet --version        # 9.0.x
cd ai-coding-workshop
git pull origin main
dotnet build src-dotnet/TaskManager.sln

Then open VS Code (code .) and confirm the Copilot status bar icon is active.


πŸ“š Related Documentation