Toolshedkernable demo

A demo of kernable

A tool library for clubs,
run on one event log

Members borrow drills and ladders, stewards hand them out, late returns cost a fee. Three services in three languages work on it together: TypeScript for accounts and the API, Rust for the catalog and loans, Python for members, fees and reports. kernable keeps their events, checks every request, runs the loan's process and holds the personal data.

You get a club of your own: four people to be, a dozen items, loans in every state. Nothing leaves the demo (no mail is sent), the data is made up, and everything is erased daily at 03:30 UTC.

What you can try

Events, not rows

Every change is an event in a signed log. Watch them arrive, from which service, with what data.

Event sourcing

Rules the kernel keeps

One active loan per item, unique item codes, no retiring what is lent: checked at commit, across services.

Unique keys and requirements

Who may do what

Owners, stewards, members: the kit's middleware decides every command and query in the kernel, and says why.

Authorization

Processes with timers

A loan handed out is followed: a reminder, then overdue, a late fee and a notice. Returning it ends the case.

Business processes

Personal data, erasable

Phone numbers and addresses live in the vault, not the log. "Forget me" erases them everywhere; the log stays whole.

Erasure

Scheduled commands, files, cache

A reservation ends by itself; item photos go to the kernel's file store; rate limits live in its cache.

Scheduling

One token, three languages

Sign in once: the TypeScript, Rust and Python services each check the same token with their own kit.

The kits

Your data, yours

Download every event of your club. Run the demo yourself: the same code, from the repository.

Export

How it is built

Browser API · TypeScriptkit: accounts, clubs, groups · middleware · sandboxes Catalog · Rustitems · loans · the loan's process Community · Pythonmembers · fees · outbox · reports kernable kernel: one log, the vault, processes, files, cache

Run it yourself

The demo is a small, ordinary kernable application: the kernel from kernable.com/install.sh, the SDKs from npm, PyPI and crates.io, and the kit copied into each service with kernable-sdk add kit.

curl -fsSL https://kernable.com/install.sh | sh
git clone https://github.com/kernable/kernable-demo
cd kernable-demo && scripts/run.sh     # then open http://127.0.0.1:8080