Docs

Principles

Four rules Lorevik does not bend, and the five states every Page must handle honestly.

Last updated 2026-11-03

The four hard rules#

These come from the business rules in Lorevik's domain context. They apply to every Package, every Agent, and every part of the app.

Local-first#

Anything that touches private local data, the user's Agent, writes to the Vault, or scanning runs in the desktop app, not on the web. The web is the control plane: discovery, accounts, purchases, metadata, consent, and audit.

Raw data stays local#

Raw data, uploads, Package contents, and the app's own .lorevik/ files stay on the user's machine. Without a second, explicit consent from the user, raw data never goes to the cloud. The cloud receives metadata only: listing text, the Package's identity, and consent and audit hashes.

Fail closed#

When the local connection to the Agent is unavailable, the app shows an error state. It never substitutes made-up Agent output and never quietly falls back to a web-only mode.

Only the creator publishes#

No Agent can publish a Package. A Package appears in Explore only after its creator confirms it, and publishing happens only in Studio.

Honest Degradation#

A Package can be as small as one SKILL.md. When an optional part is missing, Lorevik shows an honest fallback instead of an error or a blank screen:

  • With only SKILL.md, the Package still opens.
  • Without Package data, the Page renders with an empty object.
  • Without a Page, the container shows a placeholder while the Page is generated.

The five states#

Every Page has to handle these five states honestly. No fake data, no fake progress bars, no blank screens.

StateWhat the Page shows
readyThe real content, from the Package data
emptyThere is nothing yet, and what to do next
loadingNeutral placeholders, with no invented percentage
errorWhat is wrong, so the user or their Agent can fix it
degradedWhat still works, and what could not be confirmed

Note: A Package that has been revoked for a security or IP takedown is handled before these five states. Lorevik shows an isolation notice and never mounts the Page.