Kii Meridian

Kii Meridian is the umbrella control repo for architecture, standards, product narrative, governance, and the canonical public www and docs apps.

This repo does not replace implementation repos such as WARPCORE, KIT TypeScript Implementation, or KIT Core.

Quick start (Docker sandbox)

Bring up the full local sandbox — gateway API, operator console, marketing site, and docs site — with one command:

docker compose up --build

This builds and starts four services:

Service	URL	Description
gateway	http://localhost:3000	REST API + event store
console	http://localhost:3001	Operator console
www	http://localhost:3002	Marketing website
docs	http://localhost:3003	Documentation site

Gateway event data persists in the meridian-data named volume (mounted at /data/meridian).

Once the stack is up, seed a demo tenant, instrument, two participants, a policy set, and a settled instruction lifecycle:

MERIDIAN_GATEWAY_URL=http://localhost:3000 node --import tsx scripts/seed-demo.ts

Then open the console at http://localhost:3001 to see the live data.

Running the gateway without Docker

The gateway runs its TypeScript directly via the tsx loader (no build step):

npm install
npm start --workspace @kii-meridian/gateway   # defaults to http://localhost:4300

PORT, HOST, and RUNTIME_DIR are configurable via environment variables.