Documentation

Store data from an HTML file.

IAVICA is a small persistence backend for HTML apps generated by AI. The app stays a single file; IAVICA handles identity, storage, multi-device access and sharing.

Overview

The SDK connects the HTML to the API. The first time, the user enters an email and approves a magic link. From then on, the same appId and email reach the same project from any device.

Concepts

ConceptMeaning
appIdPublic, stable identifier embedded in the HTML. It identifies the app, not the data.
ProjectAn isolated data space. Each user gets their own project for an app; sharing is explicit.
CollectionA logical group of JSON documents inside a project, e.g. gastos.
RecordA JSON document with id, data, version and timestamps.
MemberA user with a role in a project: owner or editor.
Device tokenA revocable token stored in the browser so the session survives reloads.

Start here

Environments

The hosted SDK is served at https://iavica.com/sdk/iavica.js and talks to https://iavica.com/v1 by default (no apiBaseUrl needed). For local development the stack is fully Dockerized; the bundle is built with pnpm sdk:build and loaded from packages/sdk/dist/iavica.js for the file:// example.

Need a machine-readable index? See /llms.txt.