Skip to main content
This section is for people working on the Formbricks codebase itself. It documents how the platform is put together and the conventions its code follows — not how to use Formbricks, which is what the rest of these docs are for.

​
What is here

Technical Handbook

The architecture: how the Next.js app, the API gateway, the MCP server and the database fit together, and how tenants are kept apart.

Standards

How the repository is organised, how code is formatted and named, how errors are handled, and what a review and a test are expected to cover.

​
Running Formbricks locally

Setup instructions live with the code, where they stay in step with it:
  • README — prerequisites and the steps to get an instance running.
  • CONTRIBUTING.md — how to raise an issue, and what a good pull request looks like.
  • Open in Gitpod — a configured workspace in the browser, if you would rather not install anything.
If something goes wrong, GitHub Discussions is the fastest way to get help from people who have hit the same thing.
Looking to run Formbricks rather than develop it? See Self-hosting. Building against it? See the API v2 reference and the SDK guides.