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.1 KiB

Raw Permalink Blame History

summary, read_when

summary

read_when

Mintlify setup notes for publishing docs/.

Setting up docs site

Mintlify

Goal: publish docs/ as a browsable docs site (nice UX for OSS users).

This repo does not include Mintlify config yet (mint.json missing).

Minimal setup

Install Mintlify CLI (per Mintlify docs).
Add a mint.json at repo root that points to docs/ pages.

Example (starter):

{
  "name": "Bot Hub",
  "logo": "public/logo.svg",
  "navigation": [
    { "group": "Start", "pages": ["docs/README", "docs/quickstart"] },
    { "group": "Concepts", "pages": ["docs/architecture", "docs/skill-format", "docs/telemetry"] },
    { "group": "Reference", "pages": ["docs/cli", "docs/http-api", "docs/auth", "docs/deploy"] }
  ]
}

Notes:

Mintlify usually wants page paths without extension; keep files as .md.
If you prefer Mintlify conventions, rename to .mdx later (optional).

Recommended “docs UX” additions

Add an “Overview” page (use docs/README.md).
Keep “Quickstart” copy/paste friendly.
Provide CLI + HTTP API reference pages (done here).
Add a Troubleshooting page for common setup failures.

1.1 KiB Raw Permalink Blame History

Mintlify

Minimal setup

Recommended “docs UX” additions

1.1 KiB

Raw Permalink Blame History