Building an app

Any member can build an app. Open /apps/new in your workspace and choose one of two ways to start.

Two ways to start

• Describe your app. Write what the app should show and how its numbers are worked out, in up to 4,000 characters. Chiro, your team's assistant, drafts the specification and opens it in the builder.
• Use the structured builder. Set up sources, entities, signals, formulas, stages, and pages with form controls.

Both produce the same kind of specification, and you can switch to the builder at any point.

Describing an app in words

When you describe an app, Chiro drafts only what you stated.

• Anything you did not state is left out and listed as an open question.
• Every drafted signal, authority rule, formula, and stage is marked unconfirmed.
• The model receives your description. The content of your sources is not sent.
• If no valid specification can be produced after three attempts, nothing is created.

On the edit page you can describe a change. That creates a new revision and shows what was added, changed, and removed. Definitions that did not change keep their confirmed state.

Preview

A draft runs against your team's real memory in the selected environment. Use the preview to check signal values, which source supplied each field, formula results, evidence, and empty states before you publish.

Names and addresses

An app has a title and a short address name, such as renewal-risk. The address name uses lowercase letters, digits, and single hyphens between them, up to 64 characters, and must be unique in the environment. new, drafts, approvals, settings, sources, and by-id are reserved. You can change it until the app is first published.