Skip to content

How-tos ​

One task per page, with the exact calls. Each assumes you have the kernl source and have run pnpm install && pnpm build (Run the shell); for a guided first pass, start with the tutorials instead.

How-toWhat it does
Change the guard profileSwitch the shell between strict, balanced and relaxed, and what a profile can and cannot change.
Grant and revokeWhat the shell asks when an applet opens, what each answer changes, and the Kernl calls behind the grants panel.
Change the shell's layoutChange the spacing, choose which layouts the shell offers, and register a layout of your own.
Write your own window managerReplace how windows are placed, focused and stacked, and the one rule a window manager must keep: tell the guard the truth about what the person can see.
Embed kernl coreImplement KernlHost, call createKernl and mount an applet in an iframe your own page owns.
Add a messaging providerDefine a provider and its backend, and register it in the shell's messaging registry.
Add a bridge backendSupply a backend that turns an unavailable bridge, such as downloads, into a working one.
Add a cache backendKeep events in a store of your own, from an applesauce event database or your own rows, in front of the browser's defaults.
DeployBuild the site, shell, docs and API reference into one static artifact and publish it to kernl.run on bunny.net.
Publish packagesConfigure npm and JSR, validate artifacts, release and retry.

MIT licensed. Protocol authority: NIP-5D (nostr-protocol/nips PR #2303) and the NAPs (napplet/naps).