What is Mapwright?
Mapwright turns a rough app idea into a visual plan that you and an AI coding assistant both work from.
The problem
Building an app with an AI coding assistant like Claude Code or Cursor is powerful, but every conversation starts from zero. You explain what you're building, the assistant does some work, and then the next time you open it, it's forgotten everything. You explain it all again. A simple request like "add a login page" turns into several rounds of back and forth, because there was never a written plan for the assistant to work from in the first place.
What Mapwright does
Mapwright gives your idea a home: a visual map of everything your app does, that you build once and keep coming back to. You can lay it out by hand, or just describe your idea in a guided conversation and let Mapwright turn your answers into cards on the map.
Once a feature is on the map, you can turn it into a detailed spec (called a PRD, short for Product Requirements Document) with one click. That spec is what your AI assistant actually reads before it starts building, so it knows what you want instead of guessing.
How it fits together
your idea → a guided conversation → a visual map → specs → a task list → your AI assistant- Start with a map, not a blank page. Every new project comes with a starting layout already in place: sections for your features, your tech choices, your competitors, and who it's for.
- Talk it through, if you'd rather not type it all out. A chat assistant asks you what you're building, section by section, and proposes cards for you to confirm before anything gets added to the map.
- Add detail wherever it helps. Cards can carry notes, reference images, rough sketches, and related features nested underneath them.
- Turn a feature into a spec. One click generates a build-ready document your AI assistant can read directly.
- Turn a spec into a task list. Specs become an ordered list of build steps on a Kanban board, the same kind of board you might already use for project tracking.
- Connect your AI assistant. A simple, secure connection lets your assistant read the map for context, and even add new features back onto it as it works.
Who this is for
You don't need to be an engineer to use Mapwright. If you have a real idea for an app and you're relying on an AI assistant to help build it, this is for you. The rest of these docs will walk you through it, starting with the basics.