How Polymet works - Polymet Docs

Polymet uses a small set of words the same way everywhere. Knowing them makes the rest of the docs, and the app, easier to follow.

The pieces

Organization
└── Project                      one app, opened on the canvas
    ├── Pages and components     the files the agent writes
    ├── Prototypes               sets of pages you can publish
    ├── Threads                  conversations with the agent
    ├── Versions                 every saved state, newest last
    └── Branches                 parallel copies you can merge back

Word	What it means	More
Organization	Where your projects, members, credits and plan live. Everyone in it shares one pool of credits.	Your organization
Project	One app you are building.	Your projects
Canvas	The board that shows a project’s screens side by side.	The canvas
Page and component	The files that make up your app. Pages are screens. Components are the parts pages are built from.	Pages, components and files
Prototype	A set of linked pages that works as one app. A prototype is what you publish.	Publish a prototype
Polymet Agent	The AI that designs and builds in your project. The docs call it “the agent”.	Prompt the agent
Generation	One run of the agent, from the moment you send a prompt until it stops.	Prompt the agent
Thread	One conversation with the agent. A project can have several.	Threads, context and queued messages
Version	A saved state of the project. Every generation and every save makes one.	Versions and rollback
Branch	A parallel copy of the project. Work on it separately, then merge it back.	Branches
Design system	Its own kind of project, released so other projects can follow it.	Design systems
Theme	One project’s colors, fonts, radius and shadows.	Themes
Credits	What generations cost.	How credits work

Three ways to change your app

Way	Use it when	More
Prompt	You want something new, or a change that touches several places.	Prompt the agent
Select and edit with AI	You can point at exactly what should change.	Select and edit with AI
Visual editor or code editor	You want to make the change yourself.	Edit visually, Edit code

Publish and release

These are two different things.

You publish a project. Publishing puts a prototype on a live link that anyone can open.
You release a design system. Releasing makes a version of it available to your other projects.

Ways to connect Polymet to other things

There are four, and they do different jobs. Integrations, connectors and the MCP server tells them apart. The full list of terms is in the Glossary.