Build on the backend

This section is for teams changing Synap core backend behavior (new capabilities, upgraded flows, platform updates), not only consuming existing APIs.

Start with architecture principles

Before editing backend code, review:

• Data pod — backend boundaries and responsibilities
• Event flow — request → validation → executor pipeline
• Validation policy — proposal governance and approval flow
• Hub Protocol flow — how intelligence and external agents call into backend

Build workflow

1. Set up local backend: Development setup
2. Understand type surfaces: Type packages
3. Implement extensions: Extending Synap
4. Validate behavior: Testing guide

Common build goals

• Announce a new backend capability through API/router + event chain updates
• Upgrade existing backend features without breaking event governance
• Add or evolve executors/workers while preserving policy checks
• Extend intelligence-facing contracts through Hub-safe endpoints

For external integration tracks (agents, websites, sources), go back to Build & integrate.