zakirullin--files.md/docs/e2e-tests.md

End-to-end tests

One-time setup

Create a .env file in the project root:

APP_URL=http://localhost:3000
API_URL=http://localhost:8080
TOKENS_DIR="<PATH_TO_YOUR_FILES.MD_REPO/storage/-1"
CERT_DIR=""
TOKENS_SALT=""

APP_URL is where Playwright serves the webapp (tests/playwright.config.js starts npx http-server ../web -p 3000). API_URL is where the Go server listens; the tests point the browser at it via localStorage.setItem('apiUrl', ...) in setup().

Commands

All commands are defined in the project root Makefile.

Command	What it does
make e2e	Headless run of every spec. Kills any stray server, starts a fresh one in the background, then runs npm run test in tests/.
make e2e test="name"	Same as above, but filters by test name (passed to Playwright as -g "name").
make e2eh	Headed run - same as e2e but opens a visible browser window (npm run test:headed). Good for debugging visually.
make e2eh test="name"	Headed run filtered by name.
make e2es test="name"	Single-test headless run without restarting the server. Assumes a server is already running. Useful when iterating on one test against an already-warm server.
make e2esh test="name"	Same as e2es but headed.

The test="..." value is a substring / regex matched against test titles (test('…') names in the spec files).

Where test data lives

Every test-generated artifact goes under storage/<WORKER_INDEX>/ at the project root. Playwright runs tests in parallel (8 workers by default; see tests/playwright.config.js), and each worker's server-side user storage is isolated by its worker ID:

• storage/0/, storage/1/, …, storage/7/ - per-worker user filesystems. tests/sync.spec.js beforeEach wipes and recreates the current worker's directory on every test, so state never leaks between tests.
• storage/-1/ - shared tokens directory. Contains one file per worker, named by sha256(workerIndex + salt), whose contents are the worker's user ID. Used by the server's token middleware to authenticate incoming sync requests from the test browser.

Feel free to delete storage/ whenever - it's rebuilt on the next beforeEach.