AppHandoff Documentation — Introduction and Core Concepts

This documentation covers everything you need to use AppHandoff effectively: connecting projects, configuring scans, interpreting mismatch reports, managing handoff tickets, and integrating with AI coding agents through MCP. Start with the quick start guide to connect your first project in under five minutes.

AppHandoff operates on three core concepts. Projects link a frontend repository to a backend repository and define the scanning scope. Scans analyze both codebases and produce mismatch reports. Handoff tickets capture the work needed to resolve mismatches and track progress through a shared Kanban pipeline.

The MCP server extends these concepts to AI agents, giving them structured access to project state through standardized tools. Agents can read scan results, draft tickets, and check deployment status without custom API integration.

AppHandoff — Lovable to Production Bridge

AppHandoff is the MCP-powered bridge between Lovable prototypes and production engineering. It provides shared contracts, automatic mismatch detection, and a Kanban board where humans review and bots build — ensuring AI-generated prototypes become production-ready applications.

How It Works

Connect repos — Link your Lovable prototype repo and your production backend repo.
Automatic scanning — AppHandoff MCP scans both for API specs, database schemas, and frontend usage patterns.
Mismatch detection — Differences between frontend expectations and backend reality are flagged automatically as handoff tickets.
AI planning — AI agents generate implementation plans for each ticket.
Human review — Your team reviews, approves, or requests changes to plans.
Bot build — Approved plans are built by AI agents and submitted as GitHub pull requests.
Ship — Merge the PR and the ticket is complete. Continuous production pipeline.

Core Features

MCP Contracts — Versioned API specs, DB schemas, and frontend usage maps shared between repos. The Model Context Protocol ensures both sides speak the same language.
Mismatch Detection — Frontend vs backend diffs are flagged automatically. Missing endpoints, schema mismatches, and unused routes are caught before they cause bugs.
Shared Kanban — A 5-lane board (Inbox → Bot Plan → Human Review → Bot Build → Complete) where AI agents and humans collaborate on tickets in real-time.
Multi-Role Tickets — Assign frontend, backend, design, and QA roles to tickets with per-role status tracking. Every team member sees exactly what they need to do.
Production Pipeline — Continuous prototype-to-production conversion. Every change ships as a clean GitHub pull request with diff summary and CI checks.
Protected Paths — Auth routes, server actions, and API routes are marked production-owned and never touched by AI agents.

Why AppHandoff?

AI prototyping tools like Lovable generate beautiful UIs fast, but the gap between prototype and production is where projects stall. AppHandoff bridges that gap with structured contracts, automated mismatch detection, and a workflow that keeps humans in control while leveraging AI speed.

Pricing

Free ($0/mo, 1 project) · Solo ($39/mo, unlimited projects) · Team ($129/mo, collaboration features) · Agency ($299/mo, multi-team support)