Skip to content

Repository files navigation

Helpthread

Open-source support infrastructure.

Helpthread provides the foundation upon which support systems are built: durable conversations, trustworthy email threading, an operator inbox, public APIs and events, and an extension model available equally to first-party and community software.

It is serverless-native and optimized first for Vercel and Supabase, while keeping platform services behind Helpthread-owned interfaces. Organizations deploy Helpthread into infrastructure they choose and control.

Status: pre-release and dogfooded in production. Helpthread is developed by Resonant IQ, Inc. and runs the company's support operation today, but it is not ready for general deployment. Current work is tracked in the Helpthread OSS Roadmap.

Start here

  • Founding Charter — identity, principles, and project commitments
  • Architecture — the map to current technical contracts
  • Roadmap — public delivery status and planned work
  • Governance — how project decisions are made today
  • Legal and licensing — the AGPL core and commercial-module boundary
  • specs/ — the maintained behavioral and product contracts
  • fixtures/ — the mail engine's black-box acceptance suite

Architecture in one breath

TypeScript on Vercel plus Supabase for Postgres, authentication, storage, and realtime. Inbound mail arrives through push delivery and bounded reconciliation rather than a long-running poller. Signed reply tokens minted into outbound messages give Helpthread verifiable threading authority. See the architecture overview.

Development

Prerequisites: Node 20+.

npm install

Scripts:

  • npm run typecheck — TypeScript, strict, no emit.
  • npm run lint / npm run lint:fix — Biome lint (and autofix).
  • npm run format — Biome format.
  • npm test / npm run test:watch — Vitest.
  • npm run test:coverage — Vitest with v8 coverage (text + lcov).

Contributing

Helpthread is not accepting external code contributions yet. Issues and discussion are welcome; see CONTRIBUTING.md.

License

AGPL-3.0 for the core. © Resonant IQ, Inc. Commercial modules add to the core; they do not subtract from it. See legal and licensing.

About

No description, website, or topics provided.

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages