ERO Product Docs

Appearance

Arch2 Desktop Onboarding & Device Setup Report ​

This document records the zero-friction onboarding framework designed for the Arch2 Desktop environment. Onboarding is fully automated via scripts/bootstrap.ps1 (natively integrated into VS Code Build Tasks via Ctrl+B).

Automated Setup Sequence ​

1. Host Policy & Toolchain Provisioning ​

  • PowerShell Execution Policy: Configures the shell execution policy to RemoteSigned for the CurrentUser scope to allow scripts to run cleanly.
  • Git: Installs/verifies Git.Git via winget (git version 2.55.0.windows.3).
  • Node.js: Installs/verifies OpenJS.NodeJS.LTS via winget (v26.4.0).
  • Terraform: Installs/verifies HashiCorp.Terraform via winget (v1.15.8).
  • .NET SDK: Installs/verifies Microsoft.DotNet.SDK.10 via winget (10.0.302).

2. Environment Variables & Secret Configuration ​

  • Automatically checks for settings/.env.local.
  • If missing, launches browser portals for Azure DevOps, Cloudflare, and Gemini token generation, and prompts the user to enter credentials to scaffold the environment variables.

3. Database Scaffolding & Seeding ​

  • Restores project dependencies in api/.
  • Runs schema.sql to initialize the database tables.
  • Runs seed.sql to fully populate Bloodstock Open Air 2026 stages, bands, sets, walking travel times, and sample user preferences.

4. VS Code Extension Provisioning ​

  • Reads .vscode/extensions.json.
  • Iterates and silently installs all recommended workspace extensions (Astro, PowerShell, Terraform, Tailwind CSS, SQLTools) using code --install-extension --force.

5. Dual-Server Dev Services Launch ​

  • Restores dependencies in app/.
  • Asynchronously launches the Cloudflare Wrangler Local Dev API (http://127.0.0.1:8787).
  • Asynchronously launches the Astro Dev Server (http://localhost:4321) with Vite proxy rules mapping /api/* requests to the Worker API.
  • Sleeps for 4 seconds to allow servers to bind, and automatically opens the local PWA in the default browser.

Status: Verified Operational. Onboarding is fully automated and friction-free for any developer onboarding onto the Arch2 Desktop.