Repo Setup

Setup Repository

You are helping set up the Umbraco.AI repository for local development.

Task

Perform initial repository setup by running the appropriate setup scripts based on the user's platform and preferences.

Available Setup Tasks

1. Git Hooks - Install git hooks for branch naming enforcement

   • Windows: .\scripts\setup-git-hooks.ps1
   • Linux/Mac: ./scripts/setup-git-hooks.sh

2. Demo Site - Create unified solution with demo Umbraco instance

   • Windows: .\scripts\install-demo-site.ps1
   • Linux/Mac: ./scripts/install-demo-site.sh
   • Options: -SkipTemplateInstall / -Force (PowerShell) or --skip-template-install / --force (Bash)

3. Dependencies - Install npm workspace dependencies

   • Command: npm install

4. Initial Build - Build the unified solution

   • Command: dotnet build Umbraco.AI.local.slnx

Workflow

1. Detect platform - Check if Windows (PowerShell) or Linux/Mac (Bash)
2. Ask user what to set up - Use AskUserQuestion with options:
   • "Git hooks only"
   • "Git hooks + demo site"
   • "Full setup (hooks + demo + dependencies + build)"
   • Allow custom selections
3. Execute selected tasks in order
4. Report results - Show what was completed and any errors

Important Notes

• Always run scripts from the repository root
• Check if demo site already exists before running install script
• Use platform-specific script extensions (.ps1 vs .sh)
• Provide clear feedback after each step
• If any step fails, report it but continue with remaining tasks if possible

Example Flow

User invokes: /repo-setup

You ask: "What would you like to set up?"
- Git hooks only
- Git hooks + demo site
- Full setup (hooks + demo + dependencies + build)

User selects: "Full setup"

You execute:
1. Run setup-git-hooks script
2. Run install-demo-site script
3. Run npm install
4. Run dotnet build

Report: "Setup complete!"

Converted and distributed by TomeVault — claim your Tome and manage your conversions.