Keel

Host-owned routing and render-time frontend packs for Kotlin servers.

Docs: Getting started · keel.kolektiv.computer

Coordinate	Name
Maven	computer.kolektiv.keel:core, computer.kolektiv.keel:ktor
npm router	@kolektiv/keel
npm adapters	@kolektiv/keel-svelte, @kolektiv/keel-react, @kolektiv/keel-vue, @kolektiv/keel-solid, @kolektiv/keel-preact, @kolektiv/keel-lit, @kolektiv/keel-angular
npm pack toolchain	@kolektiv/keel-pack
Org	KolektivComputer · kolektiv.computer

License

Apache License 2.0 © Kolektiv Computer

Start here

• Getting started
• AGENTS.md: how to work in this repo (humans and coding agents)
• CHANGELOG.md
• llms.txt: curated map for LLMs (also served from the docs site)

Layout

• buildSrc/: Kotlin JVM + Maven publish conventions
• lib/: seed, manifest, page registry, FrontendBundle, typegen (no Ktor)
• ktor/: Ktor plugin: document shell, respondPage, visits, pack static files
• samples/harbor: Harbor testbench (Ktor + Svelte pack). Not the product path. ./gradlew :samples:harbor:run
• packages/: TypeScript router, framework adapters, and keel-pack (.feb zip + keel-scaffold)
• skills/: Agent Skills (keel-host, keel-pack, keel-scaffold)
• docs/: homepage and documentation (Astro)

./gradlew :lib:test :ktor:test :samples:harbor:test
pnpm install
pnpm test
pnpm build:packages
pnpm dev
./gradlew :samples:harbor:run

Java 17+, Kotlin 2.2, Gradle 9.5. CI runs JVM tests on JDK 17 / 21 / 25 and the JS workspace on Node 22.

Implementing guides: Wire protocol and siblings under /docs/implementing/.

Publishing

Consumers resolve one Maven repo on repo.kolektiv.computer — maven-releases for numbered versions, or maven-snapshots for canonical *-SNAPSHOT builds — never both. maven-public is optional if you already resolve other Kolektiv artifacts from that group. npm consumers and publishers use npm-public:

@kolektiv:registry=https://repo.kolektiv.computer/repository/npm-public/

Credentials: GitHub Actions secrets YURI_CAPITAL_REPO_USERNAME / YURI_CAPITAL_REPO_PASSWORD, or the same names as env, or keel.publishing.yuriCapitalRepoUsername / keel.publishing.yuriCapitalRepoPassword in ~/.gradle/gradle.properties. See .github/workflows/publish.yml.

The pnpm workspace lives at the repository root (packages/* and docs).

Docs deploy to Cloudflare Pages through its Git integration (project keel-docs) at keel.kolektiv.computer. The Pages production branch is main until this work merges to main.