App builder

Describe your app in plain language. The platform configurator (PA3) proposes an app.json document — dry run only until you click Apply. The preview uses the same DynamicRenderer as production apps.

Info

Describe the app you want — pages, tables, KPIs. The configurator proposes app.json (dry run); you review and apply.

Preview

How it works

1. Generate — POST /api/config/natural on your Render-hosted engine (via a Netlify BFF so your API key stays server-side).
2. Review — diff summary + live preview from the proposed app.json.
3. Apply — explicit PUT /api/app-json creates a new versioned snapshot.

See AI & the governed agent for the safety model (nothing is applied without your action).

Configure the doc site

Netlify (production)

Set these in your Netlify site environment variables (Site settings → Environment):

Variable	Example
PLATFORM_API_URL	https://odata-platform.onrender.com
PLATFORM_API_KEY	k-demo-editor (must match PLATFORM_API_KEYS on Render)

Render (engine) — LLM for Generate

Variable	Notes
CURSOR_API_KEY	Recommended — Cursor Dashboard → Integrations
GEMINI_API_KEY	Free tier — Google AI Studio
DEEPSEEK_API_KEY	Needs paid balance on DeepSeek
LLM_PROVIDER	Optional: cursor, gemini, deepseek, or anthropic when multiple keys are set

Set CURSOR_API_KEY on Render and remove GEMINI_API_KEY if you want Cursor instead of Gemini. Redeploy after changing env vars.

The BFF lives at /.netlify/functions/platform-api and never exposes the platform key to the browser.

Local dev

# Terminal 1 — engine (PE1 dev or Fly-deployed PE2)
npm run engine   # or use your Fly URL

# Terminal 2 — platform docs with BFF
cd platform-site
cp .env.example .env   # edit PLATFORM_API_URL + PLATFORM_API_KEY
npm run dev

Open /guide/app-builder.