Manage apps

One of: create, get, list, read-source, preview, save, deploy, versions, rollback, share and 17 more

write-data: what to do.

One of: insert, update, upsert, delete, increment

write-data insert/upsert: the row(s).

save: complete UTF-8 contents of changed files. Other files are preserved. Supply versionId from create/read-source as the base; no shell or string-escaping script is needed.

refresh: also refresh results that are still inside their refreshEvery window.

read-source: exact relative source paths. Omit for the entry files and file listing.

query-data, write-data: field equals value.

define-collection: field name → {type, required?, default?, values?, dims?}. Rows have id, owner, created_at and updated_at built in.

define-collection: who sees and changes rows. Every preset keeps the rows in one store for the whole app, so a shared or central database is any preset; the preset named shared means every visitor reads and changes everyone's rows. Pick the least open that works: what visitors submit (forms, sign-ups, applications) is inbox.

One of: private, private_editors_read, inbox, unlisted, public_read, shared, editors_write, editors_only

define-collection: unique keys, like [["email"]] or [["idea_id","owner"]] (one per visitor).

write-data update: fields to set; increment: amounts to add.

drop-collection, define-collection, write-data: true only when the user asked to delete existing data.

diagram: the diagram spec {title, layout, nodes, edges?, stages?, lanes?, sources?}. Read the build-apps guide reference/diagrams.md first. Creates a static app when appId is omitted.

add-files: files to copy into the app, each a chat upload (its Attachment ID) or generated media (its URL). Each becomes a shared app file at /__connie/files/<id>.

diagram: optional widgets.js registering custom blocks with ConnieDiagram.widget(name, render).

define-collection: at most max rows (per value of by).

create: vite (default) is a React/Vite TypeScript app; static is plain HTML/CSS/JS served as-is, with no build.

One of: vite, static

refresh: only these shared bindings. Omit for every binding with refreshEvery.

define-collection, drop-collection, query-data, write-data: the collection name (lowercase, digits, underscores).

define-collection: fields only the app's editors may set (status, approved, is_winner, score).

write-data upsert: the unique key, like "asin" or "idea_id,owner".

define-collection (public_read, shared, editors_write): rows are public only when they match, like {"approved": true}; others stay with their owner and editors.

define-collection: fields everyone may read on rows they otherwise cannot see.