Skip to content

Add end-to-end startup script and developer onboarding docs #101

Description

@jongalloway

Goal

Provide a single script that sets up everything needed to run the full system, plus clear documentation for new developers.

Work needed

Setup script (\scripts/Setup-DevEnvironment.ps1)

  1. Check prerequisites (VS 2022, .NET Framework 4.8 SDK, LocalDB, IIS Express)
  2. Create LocalDB instances and run schema + seed scripts
  3. Restore NuGet packages
  4. Build the solution
  5. Report ready status with URLs for each web app

Developer docs (\docs/getting-started.md)

  • Prerequisites list with download links
  • Step-by-step first run instructions
  • Architecture overview pointing to each runnable component
  • Troubleshooting common issues (port conflicts, LocalDB failures, etc.)

Optional: launch profile

  • A solution-level launch configuration that starts all web apps + WCF service together
  • Or a \scripts/Start-AllServices.ps1\ that launches everything

Dependencies

  • All other runnable-app issues should be complete first

Acceptance criteria

  • A fresh clone + running the setup script → working system
  • README links to getting-started docs
  • No undocumented manual steps required

Metadata

Metadata

Assignees

No one assigned

    Labels

    go:needs-researchNeeds investigationrunnable-appWork to make the legacy solution actually run end-to-endsquadSquad triage inbox — Lead will assign to a membersquad:ripleyAssigned to Ripley (Lead)

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions