Skip to content

Make a page (by hand and with AI) and add it to the navigation

Goal: build a page of your own (JSON over the component catalog and declared data sources), have AI write or change one, put it into the navigation, and share it with everyone on the context.

Prerequisites

  • Signed in. Your own pages and your own navigation are yours (this browser); sharing a page or the navigation needs an admin and passes the write gate.
  • For AI: a provider set up in Settings > AI (Set up AI).

Steps: by hand

  1. Open Config > Pages (route /config/pages).
  2. Start from a copy: under Built-in, find Workers overview and press Copy. The copy (workers_overview_copy, Workers overview (copy)) appears under Mine, selected, with the JSON editor open. (Or New page for a page with just a heading, my_page.)
  3. Edit the JSON. Change name (lower-case letters, digits, _; e.g. my_workers) and title, then the sources and spec — e.g. the WorkerTable element's filter to status:running tag:world=act. See Pages for the format, the sources and the components.
  4. Watch the validation. The toolbar says valid, or N error(s): showing the last valid version, with each error at its path (e.g. /spec/elements/running/props/filter); the right side keeps rendering the last valid version.

Steps: with AI

  1. On Config > Pages, press Generate…, describe the page (the stopped workers and the lifecycle events), press Generate. Writing…, then possibly Fixing errors (attempt 2 of 3)…. The result becomes a new page under Mine.
  2. To change one of your pages: select it, Change with AI…, say what should change (show only running workers), Change. The changed page is shown next to yours: Keep or Discard. (Ctrl+Enter / Cmd+Enter in the text box runs it too.)

Steps: add it to the navigation

  1. Open Config > Navigation (route /config/navigation).
  2. Under Your structure, in Drag and drop mode, find your page in the Add palette on the right (kind page, its title) and drag it into the tree, e.g. under Infra. Rename its label in place if you like.
  3. Save. Your navigation is saved in this browser: the entry appears at once, at /infra/<its id>.

Steps: share it (admins)

  1. On Config > Pages, select your page (it must validate) and press Share. The page is saved on the context (cfg.page.<NAME>) for every user and client; afterwards the button reads Share again (replaces the shared version).
  2. To give everyone the navigation entry too: on Config > Navigation press Share (Share (replaces the shared one) if one exists). Users without a structure of their own get it.

What you should see

  • The page under Mine (or Shared), and at its navigation entry.
  • Shared: the page under Shared in every browser on the context; Infra > Changes has the share.

Troubleshooting

Symptom Cause and fix
<Component> has no prop '…' / needs '…' Use the props of the catalog.
only reads: a method starting with List or Get invoke sources may only read.
N subscriptions; a page may open at most 8 Fewer topic sources or refreshOn topics.
A naming error at /sources/<id>/… The {entity, event, params} does not name a topic or key: check the entity and its parameters.
The page <name> does not exist here at the navigation entry No built-in, shared or own page has that name (a renamed page?).
Share disabled The page does not validate, or you are not an admin.
AI: The answer still does not validate; keeping it makes this page a draft Keep keeps it as a draft to fix by hand, or Discard and rephrase.
Save refused on Navigation: Protected, must stay Your draft dropped Pages or Navigation (🔒): put them back.

More: Pages, AI-generated pages.