Setup Instructions

1. Install Docker (Required)

Mac

# Install via Homebrew
brew install --cask docker

# Open Docker Desktop (required for first run)
open -a Docker

Wait for Docker Desktop to finish starting (whale icon in menu bar stops animating).

Windows

Download Docker Desktop from https://docs.docker.com/desktop/install/windows-install/ and run the installer. Restart if prompted. Launch Docker Desktop.

Linux (Ubuntu/Debian)

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group change to take effect

Verify Docker is running

docker --version
docker compose version

---

2. Start the app

docker compose up --build

The app will be running at http://localhost:3000.

---

3. (Optional) Install Claude Code

If you'd like to use AI-assisted testing, you can set up Claude Code with browser automation.

Prerequisites

• Node.js 18+ (node --version to check)
• If you need Node.js: https://nodejs.org/ or brew install node

Install

https://code.claude.com/docs/en/quickstart

Verify

claude --version

First run

claude

You'll be prompted to authenticate with your Anthropic account on first launch.

---

4. (Optional) Set up Playwright MCP

This gives Claude Code browser automation capabilities so it can navigate and test the app.

claude mcp add playwright npx @playwright/mcp@latest

Verify it's configured

claude mcp list

You should see playwright in the list.

Start Claude Code

In a separate terminal from the running app:

claude

---

Troubleshooting

Issue	Fix
docker: command not found	Make sure Docker Desktop is running (Mac/Windows) or the Docker service is started (Linux)
claude: command not found	Run npm install -g @anthropic-ai/claude-code again, or check your PATH includes npm global bin (npm bin -g)
Playwright MCP not connecting	Restart Claude Code after adding the MCP server
Port 3000 already in use	Stop whatever is using it (lsof -i :3000) or change the port in docker-compose.yml