ComposeProof — Give AI Eyes Into Your Android App

v1.2 — Code Intelligence + Pro Prompts

npm downloads

AI builds, tests, and verifies your Compose app

ComposeProof is an MCP server that gives AI assistants the full loop: render UI headlessly, mock backend APIs on-device, generate edge-case tests, and verify everything — no emulator needed.

Works with any MCP client

Claude Code Cursor Gemini CLI Android Studio

The problem with AI + Android today

AI coding assistants are powerful at writing code, but blind when it comes to UI. The feedback loop is broken.

AI writes code but can't verify it works

Your AI assistant writes Compose UI code but never sees the result. Empty lists, overflowing text, broken error states — all shipped to QA because nobody tested the edge cases.

Backend state is untested visually

90% of apps depend on API responses. What does your screen look like when the API returns an error? An empty list? 500 items? Nobody mocks the backend to find out.

Edge-case testing is manual or nonexistent

Paparazzi and Roborazzi test the states you write. But who writes the empty string test? The RTL test? The 200-character name test? Nobody generates edge cases automatically.

Three layers. End-to-end coverage.

From headless rendering to API mocking to in-process inspection — AI gets the full feedback loop, not just screenshots.

See it in action

A real session testing StickerExplode — a Compose Multiplatform sticker canvas app.

Generated Health Report

One command generates a self-contained HTML report — assertions, screenshots, compose intelligence, and context graph. Share it, archive it, diff it.

Token Cost

Full project analysis — discover, screenshot, interact, and report — for under 7,500 tokens. That's less than reading a single large file.

Session Flow

This isn't a mock — this is a real session captured from Claude Code + ComposeProof.

Watch the demo videos

One prompt, zero human intervention. AI builds the app, discovers UI patterns, tests interactions, and reports results.

Recorded on a Pixel 9 Pro Fold with StickerExplode demo app.

51 tools shipped. More coming.

Every tool is an MCP endpoint your AI can call. Edge-case testing, API mocking, headless rendering, device interaction, and more.

Up and running in 3 steps

Zero-install architecture. No changes to your project's build files.

Run the setup wizard

One command. Installs the binary, picks your AI agents (Claude Code, Gemini CLI, Cursor), configures MCP, and optionally installs the Compose UI skill.

AI builds and renders

Your AI assistant writes code, renders previews headlessly, generates edge-case tests, and iterates on UI autonomously.

You: "build the order screen"
AI:  writes code → renders 12 edge cases → PASS ✓

Verify end-to-end

Mock backend APIs on a real device, screenshot every state, and confirm the full loop works. No Postman, no manual QA.

AI: mock_api GET /orders → empty, error, 500 items
    take_screenshot × 3 states
    ✓ all states render correctly

AI Skill

Teach AI the render-review-fix loop

ComposeProof ships a skill — a behavioral instruction that teaches AI agents how to do Compose UI work, not just gives them tools.

Without the skill

Default AI behavior

✍️ AI writes Compose code

➡️ Moves on — never checks visually

🐛 Wrong modifier order, broken layout

😰 Render fails → panics, random fixes

With the skill loaded

AI knows the rules

✍️ WRITE the composable

👀 RENDER immediately to check

🔍 REVIEW — alignment, spacing, tap targets

🔧 FIX based on screenshot feedback

🔄 RE-RENDER to verify the fix

🛟 If stuck → asks you with structured choices

Render after every change

AI checks its own work visually, not just at the end

Read screenshots critically

Checklist: layout, spacing, contrast, states, overflow

Mock and verify APIs

Swap backend responses on-device, screenshot every state

Recover from errors

Decision tree for failures instead of flailing

The full loop, not just screenshots

AI writes the code, renders it headlessly, generates edge-case tests, mocks backend APIs on a real device, and screenshots every state. One prompt, full verification.

Works with Claude Code, Gemini CLI, Cursor, and any MCP client. Same 40 tools, same skill, every agent.

$ claude "test OrderScreen with every edge case"

 generate_edge_cases OrderScreen.kt
 render_batch 12 previews
 mock_api GET /orders → empty, error, 500 items
 take_screenshot × 3 device states
PASS 15/15 — 0 overflows, 0 crashes

Roadmap

40 tools shipped across 5 waves. Edge-case testing & API mocking shipped. Multiplatform next.

1

Headless Rendering & Verification

Ready

renderlist_previewsverifyrender_batchdiffinsights

2

Device Inspection & Interaction

Ready

preflightinspect_ui_treedevice_interacttake_device_screenshotbuild_and_deployget_build_statusget_recomposition_statsget_network_logsmanage_proxyget_feature_flags

3

Embedded Agent — Runtime Inspection

Ready

inspect_permissionsinspect_process_lifecycleinspect_navigation_graphinspect_datastoreinspect_coroutine_stateexecute_deeplinksimulate_process_death

4

AI Skills & Session Learning

Ready

npx composeproof installercompose-ui-workflow skillMCP instructionsexpert prompts (6)license gating

5

Edge-Case Testing & API Mocking

Ready

generate_edge_casesmock_apicomposable type analysisWireMock integrationADB proxy orchestrationstale proxy safety

6

Multiplatform & CI

Planned

CMP renderingGradle pluginGitHub ActionHTML reportsSSE transport

Get started

One command. Works on any Compose project, no build file changes.

Free

Free

  • Headless rendering + screenshots
  • Golden diffing + visual regression
  • Device interaction + inspection
  • HTML reports + expert prompts
  • 21 MCP tools + 8 expert prompts

Pro

Pro

499/mo

Cancel anytime ·

  • Everything in Free
  • Code Intelligence — Kartograph (2 tools)
  • Compose Intelligence (5 tools)
  • Embedded Agent (11 tools)
  • Pro Prompts (3 intelligence prompts)
  • Companion app
  • Session screenshots in reports