Skip to content

App templates

kaos-ui new <kind> <name> (or scaffold(kind, name)) generates a working project. You ran the web:spa capstone in build an app. The six kinds:

KindStackWhat you getPost-install
web:spaFastAPI on kaos-agents + Vite/React + Tailwind + Caddy + DockerFull-stack app: login → bearer → SPA calls /v1/* (chat, documents, search, upload)make install (uv + pnpm, hardened), make dev
web:apiFastAPI on kaos-coreREST backend onlymake install, make dev
dashboard:streamlitStreamlitA data dashboard appmake install, make up
tui:textualTextualA terminal UI appmake install, make dev
moduleKAOS package skeletonA new kaos-compatible module (tools, settings, tests)make install
workflowSingle fileA one-off Python script

Every template ships a Makefile, .env.example, Dockerfile + docker-compose.yml, CLAUDE.md/AGENTS.md, a pre-commit config, and a smoke test. The frontend templates apply pnpm supply-chain hardening (release-age cooldown, blocked exotic specifiers, reviewed build scripts).

Terminal window
kaos-ui list # see all kinds
kaos-ui info web:spa # details for one
kaos-ui new web:spa my-app # scaffold
kaos-ui doctor # health-check the environment

Add your own kind with register_template() — the CLI and MCP tools pick it up automatically.