Skip to content

Repository files navigation

Kagin

Kagin

English · 中文

App license-key platform on Cloudflare: issue keys, verify, heartbeat, floating seats, feature tokens.

Hosted SaaS uses email signup for a workspace and optional Stripe billing. Self-host the same code with an external admin JWT and no Stripe.

Stack: Hono API, TanStack admin, TypeScript SDK. Runtime: Workers, D1, KV, Durable Objects.

Docs

Doc Contents
Doc index Map of all docs
Product overview Verified behavior
Licensing API and policy
Deploy Self-host on Cloudflare
Security Vulnerabilities and secrets
ADRs Architecture decisions
SDK Client

Hosted discovery files (after deploy): llms.txt, product.md, sitemap.xml.

Most of the docs/ tree is in Chinese.

Layout

apps/worker/    Hono API and LicenseDO
apps/admin/     TanStack admin
packages/sdk/   TypeScript client
examples/ts/    Integration sample

Local development

pnpm install
pnpm dev:worker    # http://127.0.0.1:8787
pnpm dev:admin     # http://127.0.0.1:5173, API proxied to the worker

Sign up or log in with email in the local admin. For a self-hosted JWT:

cd apps/worker && pnpm exec tsx scripts/gen-admin-jwt.ts

Env template: .dev.vars.example at the repo root. Copy it to .dev.vars. Do not commit real values.

Verify

pnpm typecheck
pnpm test
pnpm build
pnpm verify      # wrangler dev, API smoke, SDK sample

Production deploy: docs/DEPLOY.md.

License

Source is licensed under PolyForm Noncommercial 1.0.0. Commercial use needs a separate license.

About

Source-available, auditable app licensing

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages