io.github.las-team/lastest

Free, open-source visual regression testing with AI-generated tests

Record it. Test it. Ship it.

Website • Wiki • Features • Quick Start • How It Works • Why Lastest • Comparison • Commands • Config

---

The Problem

Visual regression testing is either expensive, flaky, or painful to maintain.

• Cloud tools: per-screenshot pricing, cloud-only, no self-hosting
• Enterprise tools: steep learning curve, locked to specific frameworks
• Open-source tools: free but no dashboard, no collaboration, no AI, or in maintenance mode

Meanwhile, you just need to know: "Did my last commit break the UI?"

The Solution

Lastest is a free, self-hosted visual regression testing platform that records your tests, writes them with AI, runs them anywhere, and fixes them when they break — all in one tool.

1. Point it at your app
2. Record your user flows (point-and-click, no code)
3. AI generates resilient test code with multi-selector fallback
4. Run on remote runners or in an embedded browser container (EB setup required)
5. Screenshots compared with 3 diff engines (pixelmatch, SSIM, Butteraugli)
6. Review and approve visual changes — or let AI auto-classify them

When self-hosted, your data stays on your server and your screenshots never leave your infra.

---

Three Ways to Work

Lastest adapts to how you want to build tests — from fully manual to fully autonomous.

1. AI-Free (Manual Recording)

Open the recorder, click through your app, hit stop. Lastest captures every interaction and generates deterministic Playwright code — no AI involved, no API keys needed. You own the test code and can edit it by hand.

Best for: Teams that don't want AI, air-gapped environments, simple flows.

2. AI-Assisted (Human-in-the-Loop)

AI generates, fixes, or enhances tests — but you review and approve before anything is saved. Feed it a URL and get a test back. Import OpenAPI specs or user stories and AI extracts test cases. When a test breaks, AI proposes a fix and you decide whether to accept it.

Best for: Day-to-day development, iterating on tests, fixing breakages fast.

3. Full Autonomous (Play Agent)

One click kicks off an 11-step pipeline: check settings, select repo, set up environment, scan routes & apply testing template, plan functional areas, review plan, generate tests, run them, fix failures (up to 3 attempts per test), re-run, and report results. Uses specialized sub-agents (Orchestrator, Planner, Scout, Diver, Generator, Healer). The agent pauses and asks for help only when it hits something it can't resolve on its own. You resume and it picks up where it left off.

Best for: Onboarding a new project, generating full coverage from scratch, CI bootstrapping.

---

Two Ways to Run

Once your tests exist, you have two execution modes. Local Playwright execution on the host is no longer supported — every test runs inside an Embedded Browser pod, so EB setup is required even for development.

Mode	How	When
Embedded Browser (default)	Browser runs in a container with live streaming back to the UI. Provisioned dynamically into k3d locally, or into your cluster in production.	Default for all dev and prod runs — no local Playwright install needed
Remote Runner	Tests dispatched to remote machines via WebSocket	Distributed execution, different OS/browsers, CI/CD

Both modes support running and recording. Builds can be triggered manually (click Run), by webhook (PR opened/updated), on push to monitored branches via CI/CD (GitHub Action or CLI runner), or on a schedule (cron-based automation). Smart Run analyzes git diffs to run only affected tests.

---

Build Once, Run Forever

Tests are recorded or generated once, then stored as code. Every subsequent run re-executes the same code, captures new screenshots, and diffs them against approved baselines.

• First run: screenshot becomes the baseline
• Every run after: new screenshot is SHA256-hashed — if it matches the baseline, instant pass (no pixel comparison needed). If it differs, the diff engine runs and you review the change.
• AI costs are one-time: AI is only used during test creation and fixing. Running tests uses zero AI — it's pure Playwright execution.
• No per-screenshot pricing on self-hosted: every run is unlimited regardless of volume.

Create tests (one-time)          Run tests (forever)
┌──────────────────────┐         ┌──────────────────────┐
│ Manual recording     │         │ Execute Playwright    │
│   — or —             │  ────▶  │ Capture screenshots   │
│ AI generation        │  save   │ Diff against baseline │
│   — or —             │         │ Review changes        │
│ Play Agent autonomy  │         │ Approve/reject        │
└──────────────────────┘         └──────────────────────┘
  AI may be used here              No AI needed here

---

Features

Core

• Record Browser Interactions — Point-and-click test recording via Playwright with multiple engines (custom recorder or Playwright Inspector). No code required.
• AI Test Generation — Claude generates robust test code with multi-selector fallback (data-testid → id → role → aria-label → text → css → OCR).
• Multi-Engine Visual Diffing — Three comparison engines: pixelmatch (pixel-perfect), SSIM (structural similarity), and Butteraugli (human-perception-aligned). Choose the best trade-off between speed and accuracy.
• Multi-Step Screenshots — Capture multiple labeled screenshots per test run for multi-page flow testing.
• Approval Workflow — Review visual diffs before they become baselines. Catch regressions, approve intentional changes.
• Git-Aware Builds — Run tests per branch/commit. Compare across PRs. Track coverage.
• Branch Comparison — Dedicated compare view for side-by-side branch-to-branch test result diffing.
• Test Suites — Organize tests into ordered suites for structured execution.
• Test Versioning — Full version history with change reasons (manual edit, AI fix, AI enhance, restored).
• Test Composition — Cherry-pick tests and pin specific test versions per build via the Compose page. Override latest with any historical version.
• Functional Area Hierarchy — Organize tests into nested parent/child functional areas with drag-and-drop reordering.
• Debug Mode — Step-by-step test execution with live feedback for diagnosing failures.
• Testing Templates — One-click preset configurations for common app types: SaaS/Dashboard, Marketing Website, Canvas/WebGL, E-commerce, Documentation, Mobile-First, SPA, and CMS.
• Auto-Detect Capabilities — Recording automatically detects required browser capabilities (file upload, clipboard, downloads, network interception) and enables corresponding Playwright settings.
• Early Adopter Mode — Team-level toggle to access experimental features before general release.
• Scheduled Test Runs — Cron-based automated builds with preset schedules (daily, weekly, hourly) or custom cron expressions. Auto-disables after consecutive failures. Optional branch targeting.
• Success Criteria Tab — Parsed assertion tracking per test: see which expect() calls passed/failed with expected vs actual values, error messages, and code line references.
• WCAG 2.2 AA Compliance Scoring — Automated 0–100 accessibility score per build with severity-weighted deductions (critical/serious/moderate/minor), trend sparklines across builds, and per-test violation detail.
• Guided Onboarding — 8-step setup guide for new users: connect GitHub, configure AI, scan routes, record first test, run, set baselines, re-run, check results. Auto-detects completion.
• AI Failure Triage — Automatic classification of test failures into real regression, flaky test, environment issue, or test maintenance — with confidence scores and reasoning.
• Bug Reports — In-app bug reporting with auto-captured context (URL, viewport, console errors, failed requests, breadcrumbs), screenshot attachment, and GitHub issue creation.
• Review Todos — Branch-specific actionable items created when a reviewer flags a diff. Track review feedback as todos tied to specific builds and tests.
• Gamification (Beat the Bot) — Competitive scoring layer where humans compete against AI bots on a team leaderboard. Earn points for creating tests (+10), catching regressions (+100), approving real changes (+15), resolving review todos (+5). Small flaky-test penalty (−5, daily-capped). Seasonal play with named seasons, achievements (first test, first regression, beat-the-bot tiers), and Bug Blitz events with configurable multipliers (2–5×). Team-level toggle. Celebratory toasts on score events via SSE.
• Leaderboard — Ranked season standings for humans and bots with top-3 podium styling, per-actor breakdowns (tests created, regressions caught, flakes incurred), and "you are here" row for viewers outside the top 10.
• Test Migration — Move tests and functional areas between Lastest instances. Connect to a remote instance via URL + API key, browse remote repos, and import with idempotent name-based upsert. Also available via REST API (GET /export + POST /import).
• API Tokens — Generate long-lived Bearer tokens (lastest_api_*) for the MCP server, VS Code extension, CI scripts, and cross-instance migration. Revokable per-user with labels.

AI-Powered

• Multiple AI Providers — Claude CLI, OpenRouter, Claude Agent SDK, direct Anthropic API, OpenAI, or Ollama (local models).
• Separate AI Diff Provider — Use a different AI provider for diff analysis than test generation.
• AI Diff Analysis — AI-powered visual diff classification (insignificant/meaningful/noise) with confidence scores and change categories.
• AI Test Fixing — Automatically fix failing tests or enhance existing ones.
• Spec-Driven Testing — Import OpenAPI specs, user stories, or markdown files. AI extracts stories and generates tests automatically.
• Route Discovery — AI scans your source code to discover routes and suggest tests.
• MCP Selector Validation — Real-time selector validation on live pages via Claude MCP.
• Play Agent (Autonomous) — One-click 11-step pipeline: check settings → select repo → environment setup → scan & template → plan areas → review → generate tests → run → fix failures (up to 3 attempts) → re-run → summary. Uses specialized sub-agents (Orchestrator, Planner, Scout, Diver, Generator, Healer). Pause/resume, approve plans, skip steps.
• Agent Monitoring & Activity Feed — Real-time tracking of Play Agent sessions with step-by-step progress, SSE streaming, and session history. Monitor active/paused/completed agents from the dashboard.
• Codebase Intelligence — Automatic detection of project context (framework, CSS framework, auth, state management, API layer, key dependencies) to enrich AI prompts. 100+ package database mapping dependencies to testing recommendations.

Stabilization & Flaky Test Prevention

• Text-Region-Aware Diffing — OCR-based two-pass comparison with separate thresholds for text vs non-text regions. Reduces false positives from dynamic text and cross-OS font rendering.
• Timestamp Freezing — Replace Date.now() and new Date() with fixed values for deterministic screenshots.
• Random Value Seeding — Seed Math.random() for consistent outputs.
• Cross-OS Consistency — Bundled fonts + Chromium flags for identical screenshots across operating systems.
• Burst Capture — Multi-frame instability detection: take N screenshots and compare for stability before saving.
• Auto-Mask Dynamic Content — Automatically detect and mask timestamps, UUIDs, and relative times before comparison.
• Network Idle Waiting — Wait for network activity to settle before capture.
• DOM Stability Detection — Wait for DOM mutations to stop before screenshot.
• Third-Party Blocking — Block third-party domains with configurable allowlist, mock external images.
• Font Loading Wait — Wait for webfonts to load, or disable them entirely.
• Loading Indicator Hiding — Auto-hide spinners and loading states with custom selectors.
• Page Shift Detection — Detect vertical content shifts (inserted/deleted rows) with fuzzy row matching.

Integrations

• GitHub — OAuth login, repo sync, PR comments, webhook-triggered builds, reusable GitHub Action.
• GitLab — OAuth login (self-hosted supported), MR comments, webhook triggers.
• Google OAuth — Sign in with Google.
• Google Sheets — Use spreadsheet data as test data sources with per-team OAuth, multi-tab support, custom header rows, fixed ranges, and caching.
• Notifications — Slack, Discord, custom webhooks, and GitHub/GitLab PR comments for build results.
• Email — Team invitation emails via Resend.

Infrastructure

• Smart Run — Analyzes git diffs to run only tests affected by your changes.
• Remote Runners (v2) — Distributed test execution with concurrent multi-task support, SHA256 code integrity verification, remote recording, DB-backed command queue with result tracking, heartbeat polling, and per-test abort support.
• Parallel Test Execution — Configurable max parallel tests for the embedded-browser pool and remote runners.
• Embedded Browser — Containerized Chromium with CDP live streaming back to the UI. Record and run tests without local Playwright. JPEG streaming with configurable quality/framerate, WebSocket auth, concurrent contexts.
• Docker Deployment — Production-ready multi-stage Docker setup based on official Playwright image with persistent volumes.
• MCP Server — Model Context Protocol server (@lastest/mcp-server) exposing 29 tools for AI agent integration: run tests, review diffs, approve baselines, create/heal tests, check coverage. Install via npx @lastest/mcp-server.
• VSCode Extension API — REST + SSE API (/api/v1/) for IDE integration.
• Accessibility Audits — Automated axe-core checks on every screenshot capture with WCAG 2.2 AA compliance scoring.
• Network & Console Tracking — Capture network requests and browser console errors during test runs.

Advanced

• Ignore Regions — Mask dynamic areas (timestamps, ads, counters) from diff comparison with configurable mask styles (solid-color or placeholder-text).
• Planned Screenshots — Compare against design files (Figma exports, etc.) with separate planned vs actual diff tracking.
• Branch Baseline Management — Fork baselines per branch, merge back on PR merge, promote test versions across branches. SHA256-based carry-forward matching.
• Setup & Teardown Orchestration — Repository-default multi-step setup and teardown sequences, build-level execution, and per-test overrides with skip/add extra steps. Supports Playwright (browser), API (HTTP seeding), and test-as-setup/teardown script types. Teardown errors are non-blocking.
• App State Inspection — Access internal app state during tests (window.__APP_STATE__, Redux stores, etc.) for complex assertions.
• Selector Stats — Track selector success/failure rates and response times for automatic optimization recommendations.
• Diff Sensitivity — Configurable pixel/percentage thresholds for unchanged/flaky/changed classification.
• AI Prompt Logs — Full audit trail of all AI requests and responses.
• Background Jobs — Queue tracking for long-running operations (AI scans, builds).
• Diff Engine Benchmarks — Built-in benchmark framework comparing all three diff engines across synthetic test scenarios with timing and accuracy metrics.

Team & Auth

• Multi-Tenant Teams — Slug-based team workspaces with invitations.
• Role-Based Access — Owner, admin, member, viewer roles.
• Multiple Auth Methods — Email/password (Argon2 hashing), GitHub OAuth, GitLab OAuth, Google OAuth via better-auth.
• Email Invitations — Send team invitations via Resend with verification and password reset tokens.

---

Quick Start

Local dev

Running tests requires the Embedded Browser stack — there is no local-Playwright fallback. Bring up the database, the host app, and the k3d EB cluster together:

git clone https://github.com/las-team/lastest.git
cd lastest
docker compose up -d         # postgres on :5432 (named volume `lastest-pgdata`)
pnpm install

# Configure env (required before pnpm dev — without EB_PROVISIONER the app
# starts but no test can ever provision an Embedded Browser).
cp .env.example .env.local
cat >> .env.local <<EOF
EB_PROVISIONER=kubernetes
EB_NAMESPACE=lastest
EB_IMAGE=lastest-embedded-browser:latest
LASTEST_URL=http://host.k3d.internal:3000
SYSTEM_EB_TOKEN=$(openssl rand -hex 32)
EOF

pnpm db:push                 # apply schema
pnpm stack                   # REQUIRED: create k3d cluster + build/import EB image
pnpm dev                     # http://localhost:3000

Open http://localhost:3000.

• Stop the DB: docker compose down (data persists in the lastest-pgdata volume).
• Wipe the DB: docker compose down -v.

Embedded Browser stack (required for any test run)

The dev app runs on the host while EB pods are dynamically provisioned into a local k3d cluster — one EB per test. Without pnpm stack running, no test can execute or record.

pnpm stack           # create k3d cluster, build + import the EB image
pnpm stack:status    # cluster + EB jobs + host /api/health
pnpm stack:logs      # tail EB pod logs
pnpm stack:refresh   # rebuild the EB image after editing packages/embedded-browser
pnpm stack:stop      # delete the cluster

The .env.local keys the EB stack requires (already added by the Quick Start block above):

EB_PROVISIONER=kubernetes
EB_NAMESPACE=lastest
EB_IMAGE=lastest-embedded-browser:latest
LASTEST_URL=http://host.k3d.internal:3000
SYSTEM_EB_TOKEN=<openssl rand -hex 32>
DATABASE_URL=postgresql://lastest:lastest@localhost:5432/lastest

Note on defaults: EB_PROVISIONER defaults to 'none' in code, so omitting it lets pnpm dev start cleanly but every test will silently fail to provision an EB. Always set it for any environment that runs tests.

See k8s/ and scripts/k3d-*.sh for the manifests and bootstrap scripts.

First steps

1. Create an account (local, no external auth required)
2. Add a repository and set its local path or connect GitHub/GitLab
3. Click Record — interact with your app, Lastest captures everything
4. AI generates test code automatically
5. Run the test — screenshots are captured and diffed against baselines
6. Review visual changes and approve or reject

Requirements

• Docker: Docker 20+ with Compose v2
• Node.js: 18+ and pnpm 10.x
• Required for running/recording tests: k3d ≥ 5.6, kubectl, openssl (the EB stack — no local-Playwright fallback)

---

How It Works

┌──────────────────┐     ┌─────────────┐     ┌─────────────┐
│   Create Tests   │ ──▶ │   Run       │ ──▶ │   Review    │
│                  │     │             │     │             │
│ Record manually  │     │ Embedded    │     │ Approve/    │
│ AI-assisted      │     │ Browser or  │     │ Reject      │
│ Play Agent auto  │     │ remote/CI   │     │ changes     │
└──────────────────┘     └─────────────┘     └─────────────┘
   One-time cost           No AI per run      New baseline
   (AI optional)           (pure Playwright)  saved

Core Flow

1. Create: Build tests your way — record manually in the browser, let AI generate from a URL or spec, or let the Play Agent autonomously scan your entire app.

2. Run: Execute tests in an Embedded Browser pod (default), on remote runners, or in CI/CD. Screenshots are captured at key steps. No AI needed — pure Playwright execution at zero cost. Local Playwright on the host is no longer supported; the EB stack is required.

3. Compare: New screenshots are diffed against baselines using your chosen engine (pixelmatch, SSIM, or Butteraugli). Text-region-aware comparison available. Accessibility audits run automatically.

4. Review: Visual diffs are classified (unchanged/flaky/changed). AI can optionally auto-classify with confidence scores. Approve intentional changes — they become the new baseline.

5. Fix: When tests break, AI can propose fixes (human-in-the-loop) or the Play Agent can fix and re-run autonomously. Or edit the code by hand — your choice.

Development & Review Flow

End-to-end view of how Lastest fits into a CI/CD workflow — from git push through preview-env validation to merge approval.

Remote Runners Architecture

Distributed test execution via HTTP polling. The Lastest server queues commands; runners (Docker / CI / Cloud VM / local machine) poll for work, execute Playwright tests, capture screenshots, and report results back.

---

Why Lastest

Comparison

Capability	Lastest	Percy	Applitools	Chromatic	Argos	Meticulous	Playwright
Price	Free self-hosted / hosted plans	Paid	Paid	Paid	Paid	Paid	Free
Screenshot volume (self-hosted)	Unlimited	Limited	OSS only	Limited	Limited	None	Unlimited
Self-hosted	Yes	No	Enterprise	No	OSS core	No	Yes
Open source	FSL-1.1-ALv2	SDKs only	SDKs only	Storybook	MIT core	No	Apache-2.0
No-code recording	Yes	No	Low-code	No	No	Session	Codegen
AI test generation	Yes	No	NLP	No	No	Session-based	No
AI auto-fix tests	Yes	No	No	No	No	Auto-maintain	No
Autonomous agent	Yes (Play Agent)	No	No	No	No	No	No
AI diff analysis	Yes	AI Review Agent	Visual AI	No	No	Deterministic	No
Multi-engine diffing	3 engines	No	Visual AI	No	No	No	No
Text-region-aware diffing	Yes	No	No	No	No	No	No
Spec-driven test gen	Yes	No	No	No	No	No	No
Approval workflow	Yes	Yes	Yes	Yes	Yes	PR-based	No
Accessibility	axe-core	No	No	Enterprise	ARIA snaps	No	No
Route discovery	Yes	No	No	No	No	No	No
Multi-tenancy	Yes	Projects	Enterprise	Projects	Teams	Projects	No
Figma integration	Yes	No	Yes	No	No	No	No
Google Sheets data	Yes	No	No	No	No	No	No
Debug mode	Yes	No	No	No	Traces	No	Trace
Remote runners	Yes (npm package)	Cloud	Cloud	Cloud	Cloud	Cloud	No
Embedded browser	Yes (container + live stream)	No	No	No	No	No	No
Local AI (Ollama)	Yes	No	No	No	No	No	No
Cross-OS consistency	12 stabilization features	No	No	No	Stabilization engine	No	No
GitHub Action	Yes	Cloud-only	Cloud-only	Cloud-only	Cloud-only	Cloud-only	No
GitLab integration	Yes (self-hosted)	Yes	Yes	No	No	No	No
Test composition	Yes	No	No	No	No	No	No
Testing templates	8 presets	No	No	No	No	No	No
Setup/teardown orchestration	Yes	No	No	No	No	No	No
Branch baseline management	Yes	Yes	Yes	Yes	No	No	No
Scheduled test runs	Yes (cron)	Cloud	Cloud	Cloud	Cloud	Cloud	No
MCP server (AI agent API)	Yes (29 tools)	No	No	No	No	No	No
WCAG compliance scoring	Yes (0–100)	No	No	No	No	No	No
AI failure triage	Yes	No	No	No	No	No	No
Assertion tracking	Yes	No	No	No	No	No	No
Agent monitoring	Yes (real-time SSE)	No	No	No	No	No	No
In-app bug reports	Yes (auto-context)	No	No	No	No	No	No
Gamification	Yes (leaderboard + achievements)	No	No	No	No	No	No
Cross-instance migration	Yes (API export/import)	No	No	No	No	No	No
API tokens	Yes (long-lived Bearer)	Cloud	Cloud	Cloud	Cloud	Cloud	No

What makes Lastest different

• Record + AI generate + run + diff + approve in one self-hosted tool — no competitor does all five
• Two execution modes: embedded browser container with live streaming (default — no local Playwright install needed), or remote runners (@lastest/runner on npm) for distributed/CI runs
• Autonomous Play Agent: one-click 11-step pipeline scans routes, generates tests, runs them, fixes failures, and reports results
• AI auto-fix: tests break as your UI evolves, Lastest fixes them automatically
• Self-hosted with unlimited screenshots — no per-screenshot pricing, no volume limits when you run it on your own infra
• Your data never leaves your server — screenshots stay local, no cloud dependency
• MCP server with 29 tools — let AI agents (Claude, etc.) run tests, review diffs, and heal failures autonomously
• Scheduled test runs — cron-based automation with smart failure handling
• WCAG 2.2 AA compliance scoring — automated 0–100 accessibility score per build with trend tracking
• 6 AI providers including OpenAI and Ollama — run AI completely locally with zero API costs
• Agent monitoring — real-time SSE activity feed tracking Play Agent progress step-by-step
• Codebase intelligence — auto-detects your stack to generate better, more relevant tests
• Spec-driven testing — feed it OpenAPI specs, user stories, or markdown files and get tests back
• 3 diff engines — pixelmatch, SSIM, and Butteraugli with OCR-based text-region-aware comparison
• 12 stabilization features — timestamp freezing, random seeding, burst capture, auto-masking, DOM/network stability, and more
• Auto-capability detection — recordings auto-detect clipboard, upload, download, and network needs
• Gamification — "Beat the Bot" leaderboard with seasonal scoring, achievements, and Bug Blitz multiplier events
• Cross-instance migration — export/import tests between Lastest deployments via REST API or in-app UI

---

Commands

pnpm dev          # Start development server on localhost:3000
pnpm build        # Production build
pnpm start        # Start production server
pnpm lint         # Run ESLint
pnpm test         # Run unit tests (Vitest)
pnpm test:watch   # Run unit tests in watch mode
pnpm test:coverage # Run tests with coverage report
pnpm test:ui      # Run tests with Vitest UI
pnpm db:studio    # Open Drizzle Studio for database inspection
pnpm db:push      # Push schema changes to database
pnpm db:generate  # Generate Drizzle migrations
pnpm db:reset     # Reset database (drops all tables + removes screenshots/baselines)
pnpm db:seed      # Seed test data
pnpm test:visual  # Run visual tests via CLI (see below)

# Local k3d cluster — hosts dynamically-provisioned EB Job pods (no app, no db)
pnpm stack              # create cluster + build/import EB image
pnpm stack:refresh      # rebuild + import EB image (alias of stack:refresh:eb)
pnpm stack:refresh:eb   # same
pnpm stack:status       # cluster + EB jobs/pods + host /api/health
pnpm stack:logs         # tail EB pod logs
pnpm stack:stop         # delete cluster

---

Tech Guides

In-depth docs for every integration live on the Lastest Wiki. The README keeps things at a glance — click through for flags, payloads, and CI examples.

Guide	What it covers	Wiki
CLI Test Runner (CI/CD)	pnpm test:visual --repo-id <id> for GitHub Actions / other pipelines; auto-captures GITHUB_HEAD_REF / GITHUB_REF_NAME / GITHUB_SHA	CI/CD Integration
GitHub Action	Reusable composite action las-team/lastest/action@main — zero local Playwright, runs on your Lastest server via a remote runner; outputs status + build URL + counts	CI/CD Integration · GitHub Integration
Smart Run	Diff-based test selection — only tests affected by changed files run, comparing the feature branch against the default branch via GitHub/GitLab API	Running Tests
Self-Hosted Deployment	pnpm deploy:zima (ZimaBoard / CasaOS via docker compose) and pnpm deploy:olares (Olares via kubectl); shared multi-stage Dockerfile, GET /api/health. Required env: POSTGRES_PASSWORD, BETTER_AUTH_SECRET, SYSTEM_EB_TOKEN	Docker Deployment
Remote Runners	@lastest/runner on npm — register in Settings → Runners, then lastest-runner start -t <token> -s <url>; supports run, record, parallel, daemon mode, system-info reporting	Remote Runners
MCP Server	npx @lastest/mcp-server --url <…> --api-key <…> exposes 29 tools (run/poll/list/heal/approve/reject/coverage/…) for Claude and other agents; structured JSON responses	MCP Server
Scheduled Runs	Cron-based automated builds with presets (daily 3am, weekly, hourly, every 15min) or custom expressions; auto-disable after 5 consecutive failures	Scheduled Runs
Google Sheets Integration	Spreadsheet-backed test data — per-team OAuth, multi-tab spreadsheets, custom header row, fixed ranges; surfaces values on the test Vars tab	Google Sheets
Custom Webhooks	POST build.completed payloads (status / counts / git refs / build URL) to any HTTP endpoint, with custom method + headers	Custom Webhooks
VSCode Extension	lastest-vscode — Test Explorer in the Activity Bar, run tests from the editor, live status bar, real-time WebSocket updates; powered by /api/v1/ REST + SSE	VSCode Extension API
API Tokens	Long-lived Bearer tokens for programmatic access (CI runners, MCP server, REST clients)	API Tokens
Bug Reports	In-app reporting with auto-captured browser/network/console context, optional GitHub-issue creation	Bug Reports
Agent Monitoring	Real-time SSE activity feed tracking Play Agent sessions step-by-step	Agent Monitoring
Gamification	"Beat the Bot" — scoring, seasons, leaderboards, Bug Blitz multiplier events	Gamification
Test Migration	Cross-instance export / import of tests, areas, and configs via REST API or in-app UI	Test Migration

---

Settings

All configuration lives under a unified Settings page. Per-section deep dives live on the Settings Reference wiki — the table below is the quick map.

Section	Description	Wiki
GitHub	Connect account, select repositories, manage PR-comment + issue-creation hooks	GitHub Integration
GitLab	Connect account (supports self-hosted instances), MR comments, webhooks	GitLab Integration
Google Sheets	Connect Google Drive, manage data sources, surface vars on the test Vars tab	Google Sheets
Playwright	Browser type, viewport, headless/shell mode, selector priority, recording engine, animation freezing, screenshot delay, max parallel tests, headed playback for debugging	Settings Reference
Stabilization	Network idle, DOM stability, timestamp freezing, random seeding, third-party blocking, font loading, loading-indicator hiding, cross-OS consistency, burst capture, auto-mask dynamic content	Stabilization
Environment	Server startup (manual vs auto-start), health check URLs, EB-mode toggles	Environment Vars
Diff Sensitivity	Diff engine selection (pixelmatch / SSIM / Butteraugli), text-region-aware diffing, DOM-diff fallback, pixel/percentage thresholds, page-shift detection, per-step ignore regions	Visual Diffing
AI	Test-generation provider, diff-analysis provider, API keys, model, custom instructions, Ollama / OpenAI / Claude / OpenRouter support, MCP wiring for "Enhance with AI"	AI Configuration
Notifications	Slack, Discord, custom webhook config, auto-create GitHub issue from a visual diff	Custom Webhooks
Branches	Baseline and scanning branch selection, branch baseline fork/merge/promote	Visual Diffing
AI Logs	Audit trail of all AI requests (last 50 entries) with cost + latency	AI Configuration
Testing Templates	One-click preset configurations for SaaS, Marketing, Canvas, E-commerce, Documentation, Mobile-First, SPA, CMS	Testing Templates
Setup	Default repository-wide multi-step setup scripts (Playwright and API types), with per-test overrides	Settings Reference
Teardown	Default repository-wide multi-step teardown scripts with per-test overrides	Settings Reference
Schedules	Cron-based automated test runs with presets and custom expressions	Scheduled Runs
Vars	Test-data variables — static, AI-generated (with presets), and Google Sheets-backed	Google Sheets
API Tokens	Long-lived Bearer tokens for programmatic + MCP access	API Tokens
Account	Email preferences, unsubscribe, GDPR / self-serve account deletion	—
Users	Team member management, invitations (admin only)	Getting Started
Runners	Remote runner registration and management (admin only)	Remote Runners

---

Tech Stack

• Framework: Next.js 16 (App Router)
• UI: React 19, Radix UI, Tailwind CSS 4
• Browser Automation: Playwright
• Visual Diffing: pixelmatch, SSIM, Butteraugli
• Accessibility: axe-core
• Database: PostgreSQL + Drizzle ORM
• Auth: better-auth (email/password with Argon2, GitHub, GitLab, Google OAuth)
• AI: Claude (Agent SDK, CLI, OpenRouter, direct Anthropic API), OpenAI, Ollama
• MCP: @lastest/mcp-server for AI agent integration
• OCR Fallback: Tesseract.js
• Test Data: Google Sheets integration
• Email: Resend
• Testing: Vitest (unit), Playwright (visual)
• State: TanStack React Query

---

Environment Variables

# GitHub OAuth (for repository sync + login)
GITHUB_CLIENT_ID=
GITHUB_CLIENT_SECRET=
GITHUB_REDIRECT_URI=              # Optional
GITHUB_WEBHOOK_SECRET=            # Optional: verify webhook signatures

# GitLab OAuth (supports self-hosted instances)
GITLAB_CLIENT_ID=
GITLAB_CLIENT_SECRET=
GITLAB_REDIRECT_URI=              # Optional
GITLAB_INSTANCE_URL=              # Default: https://gitlab.com
GITLAB_WEBHOOK_SECRET=            # Optional: verify webhook signatures

# Google OAuth (for login)
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=
GOOGLE_REDIRECT_URI=              # Optional

# Google Sheets OAuth (separate scope from login)
GOOGLE_SHEETS_REDIRECT_URI=       # Separate redirect for Sheets OAuth

# Email (optional, for invitations)
RESEND_API_KEY=
EMAIL_FROM=

# Database
DATABASE_URL=                     # Default: postgresql://lastest:lastest@localhost:5432/lastest
MONITORED_BRANCHES=               # Default: main,master,develop
NEXT_PUBLIC_APP_URL=              # Your app's public URL
NEXT_PUBLIC_BASE_URL=             # Base URL for API calls

---

Roadmap

• GitHub Actions integration (CLI runner)
• Slack/Discord notifications
• Team collaboration features
• GitLab integration (OAuth, MR comments, webhooks)
• Docker deployment
• Smart run (git-diff based test selection)
• Custom webhook notifications
• Google OAuth
• Google Sheets test data integration
• AI diff analysis with confidence scoring
• Spec-driven test generation
• Accessibility audits (axe-core)
• VSCode Extension API
• Remote runners with WebSocket
• Test versioning and history
• Planned screenshots (design comparison)
• Ignore regions for dynamic content
• Setup script orchestration
• Ollama support (local AI models)
• Cross-OS screenshot consistency
• Flaky test prevention (timestamp/random freezing, burst capture)
• Auto-mask dynamic content
• Page shift detection
• Multi-step screenshots
• Debug mode
• Branch comparison view
• App state inspection
• Network & console error tracking
• GitHub Action (reusable composite action)
• Test composition (cherry-pick tests + version overrides)
• Testing templates (8 preset configurations)
• Teardown orchestration (default + per-test overrides)
• Branch baseline management (fork/merge/promote)
• Functional area hierarchy (parent/child organization)
• Multi-engine diffing (SSIM, Butteraugli alongside pixelmatch)
• Text-region-aware diffing (OCR-based)
• Diff engine benchmark framework
• Auto-detect capabilities from recording
• Early adopter mode (experimental feature gating)
• Runner v2 (concurrent execution, code integrity, remote recording)
• better-auth migration (replaced Clerk)
• Remote runner NPM package (@lastest/runner on npm)
• Embedded browser container (live streaming, no local Playwright needed)
• Runner management UI (register, monitor, configure from dashboard)
• Play Agent (autonomous 11-step test generation pipeline with sub-agents)
• Guided onboarding (8-step setup guide with auto-detection)
• MCP server v2 (@lastest/mcp-server — 29 tools for AI agent integration)
• AI failure triage (auto-classify failures: regression, flaky, environment, maintenance)
• Scheduled test runs (cron-based automation with preset schedules)
• WCAG 2.2 AA compliance scoring (severity-weighted 0–100 score with trends)
• Success criteria tab (parsed assertion tracking with pass/fail per expect())
• Selector stats & recommendations (auto-suggest enable/disable/reorder)
• Storage state management (browser state persistence for auth flows)
• OpenAI provider (6th AI provider)
• Agent monitoring & activity feed (real-time SSE tracking of Play Agent sessions)
• Codebase intelligence (auto-detect project context for AI prompts)
• Bug reports (in-app reporting with auto-captured context + GitHub issue creation)
• Review todos (branch-specific reviewer feedback tracking)
• GitHub issues integration (cached issues for analytics and bug report linking)
• DB-backed runner commands (persistent command queue replacing in-memory approach)
• Embedded session lifecycle management (claim/release with status tracking)
• On-demand Kubernetes EB pool (1 test per browser, worker-pool per build, warm-pool keep-alive)
• EB busy-state tracking + graceful reaping during deploy
• Per-step ignore regions (per-screenshot dynamic-content masking instead of per-test)
• Test spec & agent plan consolidation (test_specs + agent_plan replace freeform descriptions)
• Step-level success criteria parsing (per-step assertions tracked individually)
• AI test data variables (AI-generated values + presets, Google Sheets vars surfaced on Vars tab)
• Auto-create GitHub issues from visual diffs (notification setting + per-diff one-click)
• DOM-based diff fallback (catches structural changes when pixel diff is inconclusive)
• Favorite repos (pin frequently-used repos in the selector)
• Mobile-responsive shell (mobile top bar, sidebar, recording flows)
• Headed playback for debugging (replay tests with visible browser)
• Recording verification step (sanity-check captured selectors before save)
• Selector resolution speedup (faster fallback chain evaluation at runtime)
• Auto-reload page on transient sub-resource failures during goto
• CNI burst protection (throttle pod creation to avoid k8s networking storms)
• Runner TypeScript stripping (annotations stripped at execution time)
• Refreshed auth pages (brand logo + card layout, GDPR opt-in, auto-signup on unknown email)
• Email unsubscribe flow + self-serve account deletion
• Umami analytics integration (privacy-friendly product analytics)
• Watermarked share links + share-link refactor (publicly viewable runs/diffs)
• Gamification / "Beat the Bot" (scoring, seasons, leaderboards, Bug Blitz)
• "Enhance with AI" MCP wiring (live test names while AI builds)
• Hosted (managed) deployment option — in progress

---

Contributing

External pull requests are not being accepted at this time. For bugs, feature requests, or questions, please open an issue or visit lastest.cloud.

---

License

FSL-1.1-ALv2 — see LICENSE

---

_{Built for solo founders who ship fast and break things (then fix them before users notice).}