@k2b/cloud

Modular Hono+SolidJS framework for building per-app docker services behind a dynamic gateway.

The runtime that powers github.com/k2b-dev/cloud — an application platform that runs on infrastructure you operate, where every feature ships as its own Bun container, registers with a gateway through Redis, and inherits a shared session, UI kit, settings store, search, logging, email, websockets, and admin surface.

Install

bun add @k2b/cloud

The package is published as .ts source. It is intended for Bun consumers.

Quick start

// packages/my-app/src/config.ts
import { defineApp } from "@k2b/cloud";

export const app = defineApp({
  id: "my-app",
  name: "My App",
  icon: "ti ti-rocket",
  description: "What this app does",
  basePath: "/app/my-app",
  baseUrl: "http://app-my-app:3000",
  nav: { href: "/app/my-app", section: "more", requiresAuth: true },
  routes: ["/api/my-app", "/app/my-app", "/admin/my-app", "/public/my-app"],
});

export const { ssr, plugin } = app;

// packages/my-app/src/index.ts
import { app } from "./config";
import { Hono } from "hono";

export default await app.start({
  routes: {
    api: new Hono().get("/", (c) => c.json({ ok: true })),
    pages: new Hono().get("/", ...ssr(() => () => <div>hello</div>)),
  },
});

A standard app declares four prefixes (/api/<id>, /app/<id>, /admin/<id>, /public/<id>); the gateway routes them to your container by URL prefix from a Redis-backed registry.

Public building blocks

Documentation

Application setup, public contracts, and deployment guidance:

• Create the first application — standalone project setup and a verified API endpoint
• github.com/k2b-dev/cloud — the platform monorepo (gateway, core, all platform apps)

Security

Report a vulnerability privately through GitHub Security Advisories, never in a public issue. Security fixes appear in this package's changelog, and a published advisory names the first patched version. See the security policy.

License

GNU Affero General Public License v3.0 or later.

Commercial use, hosting, modification, and redistribution are permitted under the AGPL. If you modify Cloud and let users interact with it over a network, you must provide those users access to the corresponding source code under the same license.

Separate commercial licenses for proprietary, reseller, managed-service, white-label, or embedded product use are available by contacting the maintainer.

See the repository LICENSE file.