mygo/web/README.md

MyGO Web

MyGO Web is a client-side React application built with TypeScript and Vite.

Setup

Install the pinned toolchains from the repository root:

mise install

Install Web dependencies from web/:

mise exec -- npm ci

Development

Start the API from the repository root:

mise exec -- go run . serve

Create a development account when needed:

curl --request POST http://127.0.0.1:10086/api/v1/auth/register \
  --header 'Content-Type: application/json' \
  --data '{"username":"web-user","email":"web@example.com","password":"password123"}'

Start Vite from web/:

mise exec -- npm run dev

Vite proxies /api to http://127.0.0.1:10086. Production deployments serve the static build and /api/v1 from the same origin.

Checks

Run the Web checks from web/:

mise exec -- npm run check

The command runs linting, unit tests, type checking, and the production build.

Browser Testing

Install the Debian browser libraries once per development container:

mise exec -- npm run playwright:install:deps

Install the repository-pinned Chromium revision:

mise exec -- npm run playwright:install

Run the headless E2E tests:

mise exec -- npm run test:e2e

Browser Debugging

Use the repository wrapper for interactive diagnostics:

mise exec -- npm run playwright:cli -- open http://127.0.0.1:5173/login
mise exec -- npm run playwright:cli -- snapshot
mise exec -- npm run playwright:cli -- console
mise exec -- npm run playwright:cli -- requests
mise exec -- npm run playwright:cli -- screenshot --filename=.artifacts/playwright-cli/login.png
mise exec -- npm run playwright:cli -- close

The wrapper uses the pinned @playwright/test package, bundled Chromium, and .playwright/cli.config.json. Browser caches and generated artifacts stay under the repository-level .cache/ and .artifacts/ directories.

Do not invoke Playwright through a global installation or a floating npx package. Agents use the repository-scoped $playwright-cli skill for browser work.