Stateproof forces loading, empty, error, and offline states at the browser wire via CDP with zero app code tampering. Includes a native MCP server for AI coding agents (Cursor, Claude) with self-healing DOM selector suggestions and PR proof cards.
Hey Product Hunt community! 👋 I'm super excited to share **Stateproof** with you today.
### The Genesis Story: Why We Built Stateproof
Over the last few month, like many of you, our team shifted to building with AI coding assistants (Cursor, Claude Code, Windsurf). While AI can generate an entire UI dashboard in 30 seconds, we noticed a painful pattern across our pull requests:
**The happy path works, but the edge states are constantly broken:**
- Loading skeletons flicker or hang indefinitely on slow connections.
- Empty zero-states render a blank white page instead of helpful illustrations.
- Server error boundaries fail to display or hide the retry button below mobile viewports.
- Offline drops crash client-side transitions.
Writing 50 lines of Playwright or Cypress route-mocking for every single micro-state felt sluggish. Mocking at the application level (MSW) meant polluting our source code with service workers and test boilerplate that risked leaking into production.
### How Stateproof Solves This: Wire-Level Proof
We built Stateproof to validate UI edge states directly at the **browser wire layer via Chrome DevTools Protocol (CDP)**:
1. **Zero App Tampering**: 0 service workers, 0 source code mocks, 0 build config changes. If your dev server runs on localhost, Stateproof can test it.
2. **The 4 Canonical States**: Tests **Loading** (request delay), **Empty** (instant JSON fixtures), **Error + Recovery** (HTTP 500 → click retry → recover), and **Offline** (`internetdisconnected` abort) in milliseconds.
3. **Native MCP Server for AI Coding Agents**: Stateproof exposes first-party MCP tools (`@stateproof-dev/mcp-server`) with self-healing selector suggestions (`suggest`). When a selector fails, your agent inspects the live DOM and fixes the code in 1 turn—saving 3–5x tokens.
4. **Visual PR Proof Cards**: Generates deterministic Markdown tables and 100% offline HTML reports for your PR descriptions.
### Experience It in 10 Seconds (Zero Setup Required)
You don't need to configure anything to try it right now. Just run:
```bash
npx @stateproof-dev/cli demo