Documentation

Building an app

Create a useful app from a clear description and improve it through chat.

The best app builds begin with a narrow operational outcome and expand after the first complete workflow works. This reduces rework in the data model, permissions, and generated behavior.

Prepare the brief

Write down the app’s audience, main job, records, actions, rules, and acceptance test. Decide which resources it truly needs: workspace Data, Storage, Knowledge, or a supported Connector. If you cannot describe the primary path in a few sentences, split the app into milestones.

  1. Create the app

    Open Apps, choose New app, and give it a purpose-specific name.

  2. Describe the data and workflow

    List fields, allowed status values, who performs each action, and what success looks like. Ask Appaca to confirm the proposed screens and actions.

  3. Build one complete path

    Generate the smallest path from input to result. For a request queue, that might be submit, review, assign, and close.

  4. Connect resources deliberately

    Grant only the Data, Knowledge, Storage, or Connector access needed for the path. Verify external actions with test data.

  5. Use it and improve

    Use it straight away, and continue to chat with Appaca AI agent for any improvements you need.

Data model decisions

Use Data when the app owns structured records. Tell Appaca which fields are required and list allowed values for controlled fields such as status.

Continue with pages and functions, the code editor, or app troubleshooting.