Kehto Runtime Toolkit

Kehto is an unopinionated toolkit and protocol kernel for building NIP-5D Nostr applet ("napplet") runtimes. It supplies routing, lifecycle, capability, service, and browser-shell primitives without deciding a runtime's origin, signer, or deployment policy. Paja is Kehto's reference developer runtime; the playground is a visualization and integration fixture.

Alpha status: kehto/web is under heavy development and is far from complete, It presently offers components but still requires the implementer to manage envelope security, process isolation, performance optimization and more. It is presently being dogfooded where lessons and implementations will be reflected back into the packages. Additionally, NIP-5D is still under development, and NAP contracts are not final. Package APIs, capability names, requires declarations, and supports() behavior may change as the spec evolves.

It provides packages for building a napplet host client by handling capability enforcement, message routing, host service registration, gateway artifacts, and development tooling. The applet-side packages (@napplet/core, @napplet/shim, @napplet/sdk, and @napplet/vite-plugin) live in the @napplet repo; Kehto supplies the runtime toolkit, while Paja demonstrates one complete implementation.

• Public web portal: https://kehto.github.io/web/
• Playground demo: https://kehto.github.io/web/playground/
• Docs: https://kehto.github.io/web/docs/
• Alpha status: docs/alpha-status.md
• Local docs entry: docs/index.md
• Package reference index: docs/packages/index.md
• Generated API reference index: docs/reference/api.md

If you are building a host app, start with the minimal host shell tutorial, then use the package table below to jump into the implementation surface you need.

To run the same pointer-entry Paja Runtime published on GitHub Pages, use:

pnpm install
pnpm paja

Then open http://127.0.0.1:4175/web/paja/ and enter a napplet naddr or nevent. This builds only Paja and its workspace dependencies, not the playground or documentation site.

Package roots link to package-local READMEs and source. Markdown docs are the same pages used by the VitePress site.

The playground visualizes protocol and toolkit behavior. It loads 9 sandboxed napplets through the same gateway artifact shape used by the static Pages build; it is not Kehto's reference runtime and does not define runtime policy. Use Paja for the reference developer-runtime implementation.

• Public demo: https://kehto.github.io/web/playground/
• Local app root: apps/playground
• Playground README: apps/playground/README.md
• Playground docs: docs/packages/playground.md

Run it locally from the repository root:

pnpm install
pnpm --filter "./apps/playground/napplets/*" build
pnpm --filter @kehto/playground dev

Use the preview command when reproducing the production build used by the Playwright suite:

pnpm --filter @kehto/playground preview

pnpm install
pnpm build
pnpm type-check
pnpm test:unit
pnpm test:e2e

Docs and Pages artifact commands:

pnpm docs:site:dev
pnpm docs:check
pnpm build:pages
pnpm audit:pages

Generated API docs are produced by:

pnpm docs:api

MIT