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¶
- Open Config > Pages (route
/config/pages). - 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.) - Edit the JSON. Change
name(lower-case letters, digits,_; e.g.my_workers) andtitle, then thesourcesandspec— e.g. theWorkerTableelement'sfiltertostatus:running tag:world=act. See Pages for the format, the sources and the components. - 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¶
- 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.
- 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+Enterin the text box runs it too.)
Steps: add it to the navigation¶
- Open Config > Navigation (route
/config/navigation). - 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. - Save. Your navigation is saved in this browser: the entry appears at once, at
/infra/<its id>.
Steps: share it (admins)¶
- 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). - 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.