Skip to content

Integration ​

Connect Manifesto from a working app to UI, shared server runtime, and agent automation.


Start With The Base Runtime ​

Most integrations start with the SDK runtime:

text
createManifesto(schema, effects) -> activate() -> action.x.submit()
                                                       -> snapshot()/observe.*

That shape stays the same whether the caller is a React component, a server route, a CLI command, or an AI worker.

Add approval and history later only when the product needs explicit review, durable history, or audit queries around those same transitions.


First Web App + Agent Sequence ​

If your goal is a web app plus agent, follow this order:

This sequence assumes you already have the Todo domain from Building a Todo App. If not, build that first, then come back here.

StepGo HereUse It For
1Bundler SetupImport .mel files in Vite or another bundler
2Code GenerationEmit the generated Todo facade for TypeScript
3ReactRender a browser-owned Todo UI and submit typed actions
4Web App + AgentMove the runtime to the server so UI and agent tools share state

Other Paths Later ​

NeedGo Here
Deeper agent-only or server-worker tool loopsAI Agents
Fulfill declared effects and return patchesEffect Handlers
Editor, CLI, or agent-facing tooling around the same schemaDeveloper Tooling
Explicit proposals, approvals, and branch historyWhen You Need Approval or History

If you only need current-state reads and direct action submission, stay on the SDK path.


Tooling Around The Runtime ​

The same domain can also feed editor, inspection, and agent-assistance tools:

Those tools do not replace the runtime. They sit around it so humans and agents can author, inspect, and debug the same domain model.


When Approval Or History Enters The Picture ​

If your integration later needs explicit approval, branch history, or audit queries, add the advanced runtime on top of the same app model. That decision point is introduced in When You Need Approval or History, then spelled out in the advanced tutorials and package guides.


See Also ​