mirror of https://github.com/hanzoai/bot-hub.git synced 2026-10-30 18:46:42 +00:00

Files

T

zeekay cacc1f4d92 rebrand clawhub → bothub + add self-hosted API backend

Migration from Convex/Vercel to self-hosted infrastructure:

API Backend (api/):
- Hono server with PostgreSQL (Drizzle ORM) + pgvector
- Skills CRUD, search (hybrid vector + lexical), auth (hanzo.id OAuth)
- Upload (MinIO S3), stars, comments, API tokens
- Rate limiting middleware, session management

Frontend Adapter (src/lib/):
- api.ts: REST API client replacing Convex SDK
- hooks.ts: React hooks replacing convex/react useQuery/useMutation
- AuthContext.tsx: Auth provider replacing ConvexAuthProvider

Deployment:
- Dockerfile (multi-stage: API build + web build + production)
- K8s manifests for hub.hanzo.bot on hanzo-k8s
- GitHub Actions CI/CD (build → GHCR → deploy)

Rebrand:
- clawhub/clawdhub/ClawHub → bothub/Bot Hub
- Domain: clawhub.ai → hub.hanzo.bot
- CLI: clawhub → bothub
- Package: @hanzo/bot-hub-api

2026-02-16 19:36:19 -08:00

1.2 KiB

Raw Permalink Blame History

summary, read_when

summary

read_when

Documentation index + reading order.

New contributor onboarding

Looking for the right doc

Docs

Reading order (new contributor):

README.md (repo root): run locally.
docs/quickstart.md: end-to-end: search → install → publish → sync.
docs/architecture.md: how the pieces fit (TanStack Start + Convex + CLI).
docs/skill-format.md: what a “skill” is on disk + on the registry.
docs/cli.md: CLI reference (flags, config, lockfiles, sync rules).
docs/http-api.md: HTTP endpoints used by the CLI + public API.
docs/auth.md: GitHub OAuth + API tokens + CLI loopback login.
docs/deploy.md: Convex + Vercel deployment + rewrites.
docs/troubleshooting.md: common failure modes.

Feature/ops docs (already present):

docs/spec.md: product + implementation spec (data model + flows).
docs/security.md: moderation, reporting, bans, upload gating.
docs/telemetry.md: what bothub sync reports; opt-out.
docs/webhook.md: Discord webhook events/payload.
docs/diffing.md: version-to-version diff UI spec.
docs/manual-testing.md: CLI smoke scripts.

Docs tooling:

docs/mintlify.md: publish these docs with Mintlify.

1.2 KiB Raw Permalink Blame History

Docs

1.2 KiB

Raw Permalink Blame History