{"id":"986dbdbd-78b1-4bd2-8dae-42581d08a4cb","slug":"trell","kind":"mcp","name":"trell","summary":"The open-source form analytics platform — track form views, submissions & conversions, with funnels, UTM attribution and an MCP server.","owner":"relakeinc","repoUrl":"https://github.com/relakeinc/trell","license":"AGPL-3.0","licenseTier":"strong-copyleft","trust":"community","stars":1,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-08-24T23:31:58.000Z","addedAt":"2026-10-21T21:46:08.964Z","logoUrl":"https://avatars.githubusercontent.com/u/318476524?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["data-analytics","cloud-infra"],"tags":["analytics","conversion-tracking","forms","funnels","nextjs","open-source","posthog-alternative","self-hosted"],"runtime":"binary","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-23T00:06:12.454Z","sample":false,"url":"https://conduits.dev/tools/trell","language":"TypeScript","transports":["stdio"],"install":{},"requirements":{"env":[],"upstreamMayCharge":false},"tools":null,"readme":"<p align=\"center\">\n  <a href=\"https://github.com/relakeinc/trell\">\n    <picture>\n      <source media=\"(prefers-color-scheme: dark)\" srcset=\"apps/web/public/icon-white.svg\" />\n      <img src=\"apps/web/public/icon.svg\" width=\"160\" alt=\"Trell\" />\n    </picture>\n  </a>\n</p>\n\n<p align=\"center\">\n    The open-source form analytics platform.\n    <br />\n    <a href=\"https://github.com/relakeinc/trell\"><strong>Learn more »</strong></a>\n    <br />\n    <br />\n    <a href=\"#introduction\"><strong>Introduction</strong></a> ·\n    <a href=\"#tech-stack\"><strong>Tech Stack</strong></a> ·\n    <a href=\"#self-hosting\"><strong>Self-hosting</strong></a> ·\n    <a href=\"#contributing\"><strong>Contributing</strong></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/relakeinc/trell/blob/main/LICENSE\">\n    <img src=\"https://img.shields.io/github/license/relakeinc/trell?label=license&logo=github&color=f80&logoColor=fff\" alt=\"License\" />\n  </a>\n  <a href=\"https://github.com/relakeinc/trell/stargazers\">\n    <img src=\"https://img.shields.io/github/stars/relakeinc/trell?style=flat&label=stars&logo=github&color=0bf&logoColor=fff\" alt=\"Stars\" />\n  </a>\n  <a href=\"https://github.com/relakeinc/trell/actions/workflows/ci.yml\">\n    <img src=\"https://github.com/relakeinc/trell/actions/workflows/ci.yml/badge.svg\" alt=\"CI\" />\n  </a>\n</p>\n\n<br/>\n\n## Introduction\n\nTrell is the open-source form analytics platform for [form views, starts & submissions](https://github.com/relakeinc/trell), [funnels](https://github.com/relakeinc/trell), and [UTM attribution](https://github.com/relakeinc/trell).\n\nDrop one script on your site and Trell tracks every form automatically — views, field interactions, abandons, conversions — with a dashboard, per-form submissions inbox, funnels, and an MCP server so AI agents can query your analytics.\n\n## Tech Stack\n\n- [Next.js](https://nextjs.org/) – dashboard framework\n- [TypeScript](https://www.typescriptlang.org/) – language\n- [Tailwind](https://tailwindcss.com/) – CSS\n- [Hono](https://hono.dev/) – ingestion + query API\n- [Prisma](https://www.prisma.io/) – ORM\n- [NextAuth.js (Auth.js)](https://authjs.dev/) – auth\n- [Polar](https://polar.sh/) – billing\n- [Model Context Protocol](https://modelcontextprotocol.io/) – AI agent server\n- [Turborepo](https://turbo.build/repo) – monorepo\n- [Docker](https://www.docker.com/) – self-hosting\n\n## Self-Hosting\n\nYou can self-host Trell for greater control over your data. All settings come\nfrom the environment — copy the example file and edit it:\n\n```bash\ncp .env.example .env\n# at minimum: POSTGRES_PASSWORD, TRELL_ADMIN_KEY, AUTH_SECRET, TRELL_ENC_KEY\n# public deployments: also set NEXT_PUBLIC_SDK_URL / NEXT_PUBLIC_INGEST_URL\n# to your own API origin (they bake into the build)\ndocker compose up -d --build\n```\n\n- Dashboard: `http://localhost:3000`\n- API: `http://localhost:8787`\n\nCreate your first project via the onboarding flow, paste the tracking snippet\ninto your site, and events start flowing. [Read the self-hosting guide](docs/selfhost.md)\nto learn more (Google OAuth, custom domains, production checklist).\n\n## Contributing\n\nWe love our contributors! Here's how you can contribute:\n\n- [Open an issue](https://github.com/relakeinc/trell/issues) if you believe you've encountered a bug.\n- Follow the [local development guide](#local-development) to get your environment set up.\n- Make a [pull request](https://github.com/relakeinc/trell/pull) to add new features / fix bugs.\n- Please read and follow our [Code of Conduct](CODE_OF_CONDUCT.md) in all community spaces.\n\n### Local development\n\n```bash\npnpm install\ncp .env.example .env\npnpm db:generate\npnpm dev\n```\n\n```bash\npnpm typecheck  # strict TS across the monorepo\npnpm test       # all suites (api, web, sdk, mcp, shared)\npnpm build\n```\n\nTests use in-memory repos — no database needed. For `prisma validate/generate`\noutside Docker, any dummy `DATABASE_URL` works (e.g.\n`postgresql://trell:trell@localhost:5432/trell`).\n\n### Recommended Versions\n\n| Package | Version |\n| ------- | ------- |\n| node    | v20.x   |\n| pnpm    | 10.33.0 |\n\n### Common Local Development Issues\n\n- `Environment variable not found: DATABASE_URL` from prisma – export a dummy\n  `DATABASE_URL` (see above); no live DB is required for validate/generate.\n- `AUTH_DEV_MODE must never be enabled in production` during `next build` –\n  that guard only trips when `AUTH_DEV_MODE=true` is set; unset it to build.\n- The project is not building correctly locally – verify your versions of\n  `node` and `pnpm` match the recommended versions above.\n\n## Security model\n\n- Publishable keys (`pk_…`) only write events from allowlisted domains.\n- Secret keys (`sk_…`) are encrypted at rest (`TRELL_ENC_KEY`) and bypass the\n  domain check — server-side only, never in the browser.\n- Webhook targets are validated against SSRF (no private IPs).\n- Never commit `.env` files — only `.env.example` is tracked.\n\n## License\n\nAGPL-3.0-or-later — see [LICENSE](LICENSE).\n"}