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
| Concept | Meaning |
|---|---|
appId | Public, stable identifier embedded in the HTML. It identifies the app, not the data. |
| Project | An isolated data space. Each user gets their own project for an app; sharing is explicit. |
| Collection | A logical group of JSON documents inside a project, e.g. gastos. |
| Record | A JSON document with id, data, version and timestamps. |
| Member | A user with a role in a project: owner or editor. |
| Device token | A revocable token stored in the browser so the session survives reloads. |
Start here
Quickstart
A complete single-file HTML example with CRUD, footer and logout.
For AIAI instructions
Prescriptive rules for ChatGPT, Claude, Gemini or any assistant integrating the SDK.
ReferenceAPI
Endpoints, authentication, error codes and request examples.
ControlMy account
Projects, members, invitations, usage, export and deletion.
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.