Skip to main content

​
Gitpod Setup

This guide explains how to set up Formbricks in a Gitpod workspace.
Requirements:
  • A Gitpod workspace with Node.JS, pnpm, and Docker support.
Steps:
  1. Open the repository in Gitpod. The workspace typically clones the repo automatically. If not:
  2. Setup NodeJS with nvm:
  3. Install dependencies:
  4. Create a development .env file and generate the required secrets:
  5. Generate the Next.js AGENTS.md file (optional, for AI-assisted development): This step generates an AGENTS.md file at the repository root that provides Next.js documentation context for AI coding assistants (e.g. Cursor, GitHub Copilot). It runs npx @next/codemod agents-md under the hood. Re-run it whenever you upgrade Next.js.
  6. Run the development setup:
Access the running app via the forwarded port (typically http://localhost:3000 inside Gitpod).
Check your Gitpod settings to ensure Docker is enabled if required.