Basket DB overview
The realtime application database: collections, records, rules, realtime.
Basket DB is the application database inside a Flares Cloud project. You define collections with typed fields, write records into them over HTTPS, control access with security rules evaluated on every request, and subscribe to changes in realtime over WebSocket.
Each project's data lives in its own isolated database on Fareedah, Flares' managed data layer — not a shared table with a tenant column. Isolation is at the database level.
The screens
- Collections — define and inspect schema.
- Data — browse, filter, edit, delete records.
- Rules — who may read and write what.
- Realtime — live subscriptions and a tester.
- Backups — on-demand snapshots.
Every record carries
| Field | Meaning |
|---|---|
id | Assigned by Basket; unique within the collection. |
version | Increments on every write. Send it back to get optimistic concurrency — a stale version is refused rather than silently overwriting someone else's change. |
created_at, updated_at | Server timestamps. Never client-supplied. |