roppoh

Setup Instructions

Prerequisites

• mise - Development tool version manager
• Docker - Required for visual regression testing

Installation

1. install dev tools

mise install

1. install project dependency

mise tasks run install

Visual Regression Testing

Visual regression tests compare screenshots to detect UI changes. Since screenshot rendering differs between platforms (macOS vs Linux), we use Docker to generate consistent Linux screenshots for CI compatibility.

Running VRT locally (macOS)

cd apps/roppoh
bun run test:visual

Generating Linux screenshots for CI

Use Docker to generate Linux-compatible screenshots:

# Build and run Docker container to generate Linux screenshots
mise run tasks update-linux-vrt-screenshots

# The screenshots will be saved to:
# apps/roppoh/tests/visual-regression/pages/__screenshots__/*-linux.png

Important: After generating Linux screenshots, commit them to the repository so CI tests pass.