{
  "markdown": "<p align=\"center\">\n  <a href=\"https://hqbase.io/\">\n    <img src=\"public/logo.svg\" alt=\"HQBase\" width=\"118\">\n  </a>\n</p>\n\n<h1 align=\"center\">HQBase</h1>\n\n<p align=\"center\">\n  <strong>Your team's email workspace. On your infrastructure.</strong>\n</p>\n\n<p align=\"center\">\n  An open-source shared email workspace that runs in your Cloudflare account and keeps mail and\n  credentials in infrastructure you control.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://hqbase.io/\">Website</a> &middot;\n  <a href=\"https://hqbase.io/docs/\">Documentation</a> &middot;\n  <a href=\"https://github.com/HQBase/hqbase/releases\">Releases</a> &middot;\n  <a href=\"https://hqbase.io/docs/maintainers/contributing/\">Contributing</a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/HQBase/hqbase/actions/workflows/ci.yml\">\n    <img src=\"https://github.com/HQBase/hqbase/actions/workflows/ci.yml/badge.svg?branch=main\" alt=\"CI status\">\n  </a>\n  <a href=\"https://github.com/HQBase/hqbase/releases/latest\">\n    <img src=\"https://img.shields.io/github/v/release/HQBase/hqbase?display_name=tag&amp;sort=semver\" alt=\"Latest release\">\n  </a>\n  <a href=\"LICENSE\">\n    <img src=\"https://img.shields.io/github/license/HQBase/hqbase\" alt=\"AGPL-3.0-only license\">\n  </a>\n  <a href=\"https://discord.gg/U67PB663nf\">\n    <img src=\"https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&amp;logoColor=white\" alt=\"Join the HQBase Discord\">\n  </a>\n  <a href=\"https://x.com/berman_to\">\n    <img src=\"https://img.shields.io/badge/X-Follow-000000?logo=x&amp;logoColor=white\" alt=\"Follow @berman_to on X\">\n  </a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://deploy.workers.cloudflare.com/?url=https%3A%2F%2Fgithub.com%2FHQBase%2Fhqbase%2Ftree%2Fdeploy\">\n    <img src=\"https://deploy.workers.cloudflare.com/button\" alt=\"Deploy to Cloudflare\">\n  </a>\n</p>\n\n## About HQBase\n\n<p align=\"center\">\n  <img src=\"public/hqbase-desktop-screenshot.png\" alt=\"HQBase shared inbox interface\">\n</p>\n\nHQBase gives teams one place to work with shared mailboxes while keeping the application, mail,\nand Cloudflare credentials in customer infrastructure. It includes:\n\n- Shared mailboxes and team access controls.\n- Multi-domain setup, drafts, and audit history.\n- Installation, update, backup, and recovery operations.\n- An OAuth-protected remote MCP server.\n\nSee the [product documentation](https://hqbase.io/docs/) for installation, daily use, architecture,\nand operations.\n\n## Made by the community\n\nWe love seeing people build around HQBase. Independent clients give you more ways to use your\nworkspace:\n\n- [Herald](https://github.com/awizemann/herald) — A native macOS email client for HQBase.\n\nHQBase has tested Herald for compatibility. It is made and maintained by independent community\ndevelopers, so its releases, support, and behavior remain in their care rather than HQBase's.\nPlease review the project and decide whether it is right for your workspace.\n\n## Develop locally\n\n### Start the application\n\n```sh\npnpm install\npnpm db:migrate:local\npnpm db:seed:local\npnpm dev\n```\n\nBefore you run the optional seed command, add these values to `.dev.vars`:\n\n- `BETTER_AUTH_SECRET`\n- `HQBASE_LOCAL_SEED_PASSWORD` with 8 to 128 characters\n\nThe seed command writes only to local D1 and does not contact Cloudflare OAuth. Open\n`http://127.0.0.1:5173/` and sign in as `owner@hqbase.test` with that\npassword. Vite serves the frontend with live reload on port 5173 and proxies API requests to the\nWrangler Worker on port 8787.\n\nTo use the first-run setup flow, omit the seed command and open `http://localhost:5173/setup`.\n\n### Reset local data\n\nTo discard all local D1 data, rebuild the schema, and recreate the demo workspace:\n\n```sh\npnpm db:reset:local\npnpm db:seed:local\n```\n\nThe reset command is destructive and local only. It does not change a deployed database.\n\n### Preview the setup interface\n\nFor presentation-only onboarding work:\n\n```sh\npnpm dev:setup-ui\n```\n\nOpen `http://127.0.0.1:5173/__ui/setup`.\n\n### Review the visual system\n\nTo inspect the shared components, interactive states, product patterns, and local screen routes:\n\n```sh\npnpm dev:ui\n```\n\nOpen `http://127.0.0.1:5173/__ui/design`. The gallery uses deterministic presentation fixtures\nand does not call product APIs.\n\n## Verify changes\n\nRun the full local quality gate:\n\n```sh\npnpm check\npnpm deploy:dry-run\n```\n\nRun `pnpm cf:typegen` after you change `wrangler.jsonc`.\n\nPushes to `main` run the same quality gate and deployment dry-run. Deployed staging is manual and\nalso runs inside the signed release workflow. A release stays in draft until the previous stable\nversion upgrades to the exact signed candidate and passes its checks. Customer installations and\nupdates verify the signed manifest and artifact digest before deployment.\n\n## Documentation\n\n[hqbase.io/docs](https://hqbase.io/docs/) is the public source for user and operator guides,\nproduct specifications, and maintainer procedures.\n\n## Contributing\n\nRead the [contribution guide](CONTRIBUTING.md) before you open a pull request.\n\n## Security\n\nTo report a vulnerability, follow the private process in the [security policy](SECURITY.md).\n\n## License\n\nHQBase is available under the [GNU Affero General Public License v3.0 only](LICENSE).\n",
  "bytes": 5237,
  "sha": "e268b52dbd48a071c21abc4309d0c0f4b58122ff28b0cdb323b984f113c2950e",
  "repo_slug": "hqbase/hqbase",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_hqbase_hqbase_52f49c8b/readme"
}