Skip to content
nomos

Build your first Nomos application

You need Node.js 24 or later. You do not need an account, cloud workspace or Nomos source checkout.

Create the application

Section titled “Create the application”
Terminal window
npx --yes create-githolon@latest my-nomos-app
cd my-nomos-app
npm install

The published starter creates one durable Estate, one atomic business intent named commissionAsset, and one generated application.

Compile the law and application

Section titled “Compile the law and application”
Terminal window
npm run compile

Compilation emits:

  • readable typed USDA law and its transport package;
  • a generated TypeScript client;
  • layered generated Dart packages;
  • a generated local business proof.

Prove the business journey

Section titled “Prove the business journey”
Terminal window
npm run proof

This is not a mocked unit test. The proof starts the real local offer kernel, births the application, offers commissionAsset, reads the result through the generated application, discards resident state, restores custody, verifies the chain and reads the same business world back.

The successful final signal is:

ALL GREEN — my-nomos-app used only its generated application surface

Make it yours

Section titled “Make it yours”

Open domains/estate.ts. Change business nouns and verbs there, then rerun:

Terminal window
npm run compile
npm run proof

The generated application is the service layer. Do not wrap it in repositories, session managers or a second cache. Pass the opened application instance through your UI and call its typed business language.