Grid82
grid82.comJoin the waitlist
BuildArchitecture

How Grid82 apps work

Every app runs inside an isolated SQLite database beside its permission definition, decoupled from the Studio control plane.

Grid82 splits the Studio (where you design apps) from the Runtime (where invited members use them). Understanding how an app is stored helps you model data, isolate workspaces, and keep schema edits safe.

Isolated app databases

Each app in Grid82 runs in its own isolated SQLite database. Rather than putting all customers into shared database tables with a tenant_id column, every app owns a private database together with its compiled schema, role rules, personal views, page metadata, and change history.

Three practical consequences follow from this design:

  • Zero Studio dependency at runtime. The Runtime resolves an incoming hostname ({suite}.grid82.app or your custom domain) straight to the app’s database and rules. Even if the Studio control plane is offline for maintenance, every published app continues serving users, API calls, and MCP sessions.
  • No noisy cross-tenant locking. Heavy imports, bulk SQL updates, or formula recalculations inside one app never contend with queries in another app.
  • Per-app limits and trash. Each app gets the full per-app record quota of your plan (up to 1,000 records on Free, 50,000 on Starter, and 200,000 on Pro). Deleted tables, fields, and apps remain recoverable in the trash for 30 days.

Permanent IDs vs display labels

Every table (tbl_...), field (fld_...), record (rec_...), view (viw_...), and select option (opt_...) receives an opaque random ID at creation.

  • Display names can be renamed at any time in the Studio without breaking saved views, formulas, Interface pages, or API clients keyed on IDs.
  • Before deleting or renaming a table or field, check its impact report (schema.impact). Grid82 lists every permission rule, formula, lookup, rollup, Interface page, and personal view referencing that item.

How permissions wrap every operation

Every read and write on an app passes through the same permission compiler before reaching the database:

  1. The caller’s roles on that app are resolved (for Runtime users) or the builder’s organisation membership is verified (in the Studio).
  2. Read rules compile directly into query predicates and column masks.
  3. Computed relations (lookup, rollup) are hidden if the user cannot read the target table or field, preventing cross-table counts from leaking restricted records.
  4. Every write records an atomic changeset inside the same database transaction so undo and audit logs stay accurate.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Grid82 documentation and read it in full, instead of answering from memory.

https://grid82.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://grid82.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.