Project Structure
The koko.config.json Manifest
The koko.config.json Manifest
On project initialization, Koko creates a `koko.config.json` manifest at the root. This file acts as the immutable single source of truth for your architecture, allowing developer tools and future commands to inspect your tech stack without parsing config files manually.
JSON Schema Specification
The standardized schema published at `https://koko-cli.dev/schema.json` contains four main sections: `project`, `architecture`, `stack`, and `features`:
{
"$schema": "https://koko-cli.dev/schema.json",
"project": {
"name": "my-super-app",
"cliVersion": "v2.0.0",
"createdAt": "2026-09-01T12:00:00Z"
},
"architecture": {
"layout": "monorepo",
"packageManager": "pnpm"
},
"stack": {
"frontend": {
"framework": "nextjs",
"language": "typescript",
"styling": "tailwindcss"
},
"backend": {
"framework": "express",
"language": "typescript"
},
"database": {
"provider": "postgres",
"orm": "drizzle"
}
},
"features": {
"auth": {
"provider": "better-auth",
"status": "installed"
},
"infrastructure": {
"dockerCompose": true,
"ciCd": "github_actions"
}
}
}