Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions .github/workflows/ui-quality.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
name: Web UI quality
on: [push, pull_request]
jobs:
ui:
runs-on: ubuntu-latest
timeout-minutes: 15
steps:
- uses: actions/checkout@v4
- uses: actions/setup-go@v5
with:
go-version: '1.25.x'
cache-dependency-path: api/go.sum
- uses: actions/setup-node@v4
with:
node-version: '22'
cache: npm
cache-dependency-path: web/package-lock.json
- run: npm ci
working-directory: web
- run: npx playwright install --with-deps chromium
working-directory: web
- run: npm run typecheck
working-directory: web
- run: npm run test:ui
working-directory: web
- uses: actions/upload-artifact@v4
if: always()
with:
name: ui-accessibility-and-reflow
path: |
web/.test-artifacts/after/
web/.test-artifacts/results.json
web/test-results/
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,14 @@ api/coverage.out
# Web
web/node_modules
web/.next
web/.next-test/
web/out
web/.env.local
web/.turbo
web/tsconfig.tsbuildinfo
web/.test-artifacts/
web/test-results/
web/playwright-report/

# Android
android/.gradle
Expand Down
11 changes: 11 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,3 +124,14 @@ Seed users (created only when the user table is empty):
`GET /health` for probes. Full shape and scale discussion: [SYSTEM_DESIGN.md](./SYSTEM_DESIGN.md).

Env: `PORT` (8080), `JWT_SECRET`, `DATABASE_URL` (`sqlite:inkwell.db` or `postgres://...`).

## Web UI quality

The web client has explicit form labels, keyboard bypass/focus styling, announced
feedback, and long-content reflow fixes. [Measured UI checks](docs/ui-quality.md)
record the before/after accessibility scans and 38 passing Playwright tests across
four viewport widths, including real Go API/SQLite workflows. Automated checks
are partial coverage, not a WCAG certification.

For a real participant study, use the [moderator protocol](docs/usability-study.md)
and blank observation sheet. No participant study has been completed yet.
Loading
Loading