End-to-end tests

Readest has two end-to-end lanes. They cover different layers and are run separately.

Web lane — Playwright

Drives the Next.js web build (pnpm dev-web) in a real browser. Fast, no Rust build required. Tests run unauthenticated against a fresh browser context, so each test starts from an isolated, empty local library.

bash

pnpm test:e2e:web          # run the web e2e suite (auto-starts pnpm dev-web)
pnpm test:e2e:web:headed   # run headed, one test at a time, with traces
pnpm test:e2e:web:ui       # run in the Playwright UI mode
pnpm test:e2e:web:report   # open the last HTML report

Every run writes an HTML report to playwright-report/; open it with pnpm test:e2e:web:report.

Layout:

Path	Purpose
`playwright.config.ts` (app root)	Runner config, projects, web server.
`e2e/tests/`	Specs (`*.spec.ts`).
`e2e/pages/`	Page Object Model — actions/queries, no assertions.
`e2e/fixtures/`	Shared fixtures; `fixtures/books/` holds sample books.

Page objects expose locators and actions; assertions stay in the specs so failures point at test intent. To add coverage, prefer extending a page object over inlining selectors in a spec.

The demo-book auto-import (useDemoBooks) is suppressed by the base fixture so the library is deterministic; authenticated/sync flows are out of scope for this lane until a test account is provisioned.

Tauri lane — WebdriverIO

Drives the actual Tauri desktop shell via tauri-driver. Use this for coverage that depends on the native build (Rust integration, window management, platform globals).

bash

pnpm tauri:dev:test        # start the Tauri app with the webdriver feature
pnpm test:e2e              # run wdio against it (specs: e2e/*.e2e.ts)