Skip to content

fix: Make Echo seamless to run locally on Windows#776

Open
PurdueDM wants to merge 3 commits intoMerit-Systems:masterfrom
PurdueDM:local-improvements
Open

fix: Make Echo seamless to run locally on Windows#776
PurdueDM wants to merge 3 commits intoMerit-Systems:masterfrom
PurdueDM:local-improvements

Conversation

@PurdueDM
Copy link
Copy Markdown

Closes #597

This PR makes Echo truly seamless to run locally on Windows by addressing critical setup gaps identified after testing with a fresh Windows environment.

Changes

Windows-Native Support

  • PowerShell setup script (setup-windows.ps1) - equivalent to bash setup.sh
  • Prerequisite checker (check-prerequisites-windows.ps1) - verifies Node, pnpm, Docker, Git
  • Comprehensive Windows setup guide (WINDOWS-SETUP.md)

Documentation Improvements

  • Explicit prerequisites section in main README
  • Clear pnpm installation instructions (npm install -g pnpm)
  • Windows-specific troubleshooting guide
  • Docker Desktop setup clarification
  • Quick start workflow improvements

Why This Matters

Tested on a fresh Windows environment and discovered users hit these blockers:

  1. No pnpm installed - README says pnpm i but users don't have pnpm
  2. Bash scripts only - setup.sh won't run in PowerShell without Git Bash
  3. Missing prerequisites guidance - No clear list of what to install first
  4. No Windows troubleshooting - Windows-specific issues undocumented

Testing

Verified on Windows with:

  • Fresh Echo clone
  • PowerShell-native workflow (no Git Bash required)
  • Prerequisite checker catches missing dependencies
  • Setup script generates .env correctly

Addresses Gaps in Existing PRs

Existing PRs improved Unix/Mac setup but missed Windows-specific needs:

  • Other PRs assume pnpm is installed
  • No PowerShell equivalents for .sh scripts
  • No Windows troubleshooting documentation

This PR completes the Windows experience.

Bout1 added 3 commits April 24, 2026 15:13
Add comprehensive Windows support for local development:
- PowerShell equivalent of setup.sh (setup-windows.ps1)
- Prerequisite checker script (check-prerequisites-windows.ps1)
- Complete Windows setup guide (WINDOWS-SETUP.md)

Addresses Merit-Systems#597 by making Echo seamless to run on Windows with:
- pnpm installation instructions (npm install -g pnpm)
- PowerShell-native scripts (no Git Bash required)
- Windows-specific troubleshooting
- Docker Desktop setup guidance

Fixes: Merit-Systems#597
Enhance main README with:
- Explicit prerequisites section (Node, pnpm, Docker, Git)
- pnpm installation instructions
- Quick start workflow improvements
- Reference to WINDOWS-SETUP.md for Windows users
- Common issues troubleshooting

Addresses Merit-Systems#597
Update packages/app/control/README.md with:
- pnpm installation guidance
- Windows PowerShell script reference (setup-windows.ps1)
- Link to comprehensive WINDOWS-SETUP.md

Addresses Merit-Systems#597
@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 24, 2026

@Bout1 is attempting to deploy a commit to the Merit Systems Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Make Echo seamless to run locally

2 participants