Skip to content
Kitsy Docs Open CNOS
Kitsy Docs

Quick Start

Quick Start

Terminal window
cnos init
cnos value set app.name demo
cnos value set server.port 3000
cnos value set api.default_query_params '["ab", "bc"]'
cnos read value.app.name
cnos build env --profile local --to .env.local
cnos run -- node server.js

In app code:

import cnos from '@kitsy/cnos';


await cnos.ready();
console.log(cnos('value.app.name'));

For explicit creation:

import { createCnos } from '@kitsy/cnos/configure';


const runtime = await createCnos();
console.log(runtime.value('app.name'));
console.log(runtime.read<string[]>('value.api.default_query_params'));

If your repo still expects env files, keep .cnos as the source of truth and generate them:

Terminal window
cnos build env --profile local --to .env.local
cnos dev env --profile local --to .env.local -- pnpm dev

For frontend builds:

  • Vite: @kitsy/cnos-vite
  • Webpack/static bundles: @kitsy/cnos-webpack
  • Next.js: @kitsy/cnos-next

For webpack/static bundles, build-time settings can come from CNOS too:

Terminal window
cnos set value dev.server.port 8800
npm run dev