Skip to main content
// CHANGELOG

What's new in Frontguard

Following Keep a Changelog and semantic versioning. Every notable change, newest first.

Unreleased
IN PROGRESS
on main

Storybook, OpenTelemetry & a native Slack app

The next release deepens integrations and observability — capture Storybook stories directly, export run metrics over OTLP, and post results to Slack.

ADDED
  • Storybook integration — a storybook config block enumerates stories from a running Storybook (8.x / 7.x) and renders each, with play()-aware capture and per-story overrides. frontguard init auto-detects .storybook.
  • OpenTelemetry export — run completions emit OTLP/HTTP metrics (runs, comparisons, regressions, duration) to a configurable endpoint; runs on Cloudflare Workers.
  • Native Slack app — a Hono handler with signing-secret verification, the /frontguard slash command, OAuth v2 install, and result posting.
  • Run-over-run perf regressions — the perf-budgets plugin can persist each run’s metrics and flag any metric that degraded since the last run.
  • Accessibility-aware AI — axe-core violations are fused into the AI prompt so the model can correlate a visual change with a known a11y issue.
0.2.0
LATEST RELEASE

The "earn trust" release

The core engine is joined by an AI auto-fix moat, a cloud platform, production monitoring, and a full integration surface.

ADDED
  • frontguard doctor — environment diagnostics for sources of non-determinism (Node, Playwright/Chromium, browsers, config, git state).
  • frontguard monitor — live production URL monitoring with --once, --watch/--interval daemon polling, --history, and webhook alerts.
  • AI fix generation + sandbox verification — generateFixes produces minimal CSS patches; verifyFixes applies them in a sandbox, re-renders, and re-compares against baseline.
  • Fix-pattern database — a SQLite store with accept-fix / reject-fix / export-patterns; the pipeline reuses patterns accepted ≥3 times before calling the AI.
  • Accessibility & performance plugins — axe-core WCAG audits and LCP/CLS/TTFB budgets, both correlated inline with the visual diff.
  • Cloud platform — a Hono service with run submission, baseline approval and usage metering; Cloudflare D1 + R2 + GitHub OAuth.
  • Teams & billing — multi-tenant teams with roles, invitations, approvals, an activity feed, and Stripe billing.
  • Integrations — real Vercel OAuth app, Netlify Build Plugin, and a GitHub App with Check Runs.
CHANGED
  • Documentation site migrated from VitePress to Fumadocs (Next.js + MDX).
  • Reporters now render accessibility, performance and third-party-script sections alongside visual diffs.
0.1.0
INITIAL RELEASE

The core engine

CLI, route discovery, multi-browser capture, pixel diffing, AI analysis, Git baselines and the plugin architecture — the foundation.

ADDED
  • CLI — frontguard init and run with proper flow control and exit codes.
  • Route discovery — auto-crawl plus filesystem detection for Next.js, Nuxt, SvelteKit, Astro and Remix.
  • Multi-browser capture — Chromium, Firefox and WebKit via Playwright.
  • Visual comparison — pixel-level diffing via pixelmatch with a standardized 0–100 diff percentage.
  • AI analysis — BYOK support for OpenAI and Anthropic vision models on a unified confidence scale.
  • Git baselines — orphan-branch storage for baseline screenshots via worktrees.
  • Plugin architecture — 6 lifecycle hooks with error isolation, plus Figma, perf-budgets and monitoring plugins.
SECURITY
  • Hardened by default — shell-injection prevention, path-traversal guards, API-key redaction, and XSS-escaped HTML reports.
TESTING
  • 395 tests across 26 test files covering 27 source files — vision, crawler, Playwright, plugins, reporters, storage and E2E.