Development
Run the monorepo locally, the scripts it ships with, and how the images and this site are published.
Layout
Komodo CD is a Turborepo monorepo with Bun workspaces.
| Path | What |
|---|---|
apps/backend |
Bun + Hono: a thin server for Better Auth, oRPC and OpenAPI. |
apps/frontend |
Astro 7 (SSR) + React + TanStack Query. |
apps/gateway |
The production Caddy: the only published port, routing to the backend and the frontend. |
apps/site |
This website: static Astro, published to GitHub Pages. |
trivy |
Not a workspace: a service in compose.yml running the upstream aquasec/trivy server, which the backend’s trivy client scans images against. |
packages/api |
oRPC routers (v0), the Komodo client and the ntfy and Trivy services. |
packages/auth |
Better Auth config and the session resolver (cookie or x-api-key). |
packages/db |
Drizzle (SQLite/libsql): schema, relations, migrations and seed. |
packages/env |
Validated server environment (t3-env + zod). |
packages/logger |
Shared pino logger. |
packages/config |
Shared tsconfig. |
Run it
Requires Bun 1.4 or newer.
bun install
bun run setup:dev # writes .env with a random secret and admin password
bun run dev # Docker dev stack on http://localhost:4321 (hot reload, Ctrl+C stops)
bun run dev:down # remove its containers (-v also drops its database)
bun run dev:local # the same without Docker: backend (:3000) + frontend (:4321) with turbo watch
bun run dev:backend # only the backend, without Docker
bun run dev:frontend # only the frontend, without Dockerbun run dev puts the production gateway (apps/gateway/routes.caddy) in front of both apps, so routing in development is the one in production. It keeps its own SQLite database in a Docker volume, separate from apps/backend/dev.db. Without Docker, the Vite dev server proxies /api, /rpc, /doc and /scalar to the backend the same way.
Scripts
| Script | Does |
|---|---|
bun run build |
Builds every app (turbo build). |
bun run check-types |
Type-checks every app and package. |
bun run format |
Formats with Biome. |
bun run check |
Biome lint and format, with autofix. |
bun run db:generate |
Generates Drizzle migrations from the schema. |
bun run db:studio |
Opens Drizzle Studio. |
bun run docker:up |
Builds the images from source and starts the stack. |
Docker images
The Dockerfiles live in apps/*/Dockerfile, but the build context is always the repository root:
docker build -f apps/backend/Dockerfile -t komodo-cd-backend .
docker build -f apps/frontend/Dockerfile -t komodo-cd-frontend .
docker build -f apps/gateway/Dockerfile -t komodo-cd-gateway ..github/workflows/docker-build.yml builds and pushes the three of them to ghcr.io/nonetss/komodo-cd-backend, ghcr.io/nonetss/komodo-cd-frontend and ghcr.io/nonetss/komodo-cd-gateway, rebuilding only the ones whose files changed:
| Trigger | Tags |
|---|---|
Push to main |
latest, main, main-<sha> |
Tag vX.Y.Z |
X.Y.Z, X.Y |
The trivy service is not built here: it runs the upstream aquasec/trivy image, at the same version as TRIVY_VERSION in apps/backend/Dockerfile.
To publish a release, tag the commit and create the GitHub release:
git tag -a v1.0.0 -m "v1.0.0" && git push origin v1.0.0
gh release create v1.0.0 --generate-notesThis site
bun run dev:site # http://localhost:4322/Komodo-CD/The pages are Markdown in apps/site/src/content/docs/<lang>/, one file per language, and the landing copy is in apps/site/src/i18n/ui.ts. The screenshots are the ones in the root img/ directory, shared with the README. .github/workflows/pages.yml publishes the site to GitHub Pages on every push to main that touches it.