The AI-Native Device Platform
User Manual

awaBerry | Create Automation Project

Create a new Smart Automation project by uploading a JSON definition, generating one with AI from a prompt, or starting from an empty template.

Create Automation Project

Summary

The Create Automation Project screen offers three distinct pathways for adding a new project to the Smart Automation Framework: importing an existing JSON project file, generating a project automatically with an AI model from a natural-language description, or creating a blank project by providing only a name. All three pathways end at the Edit Project screen where the full project configuration can be reviewed and refined before saving.

Create Automation Project — initial state

Screen on arrival

Features

  • AppBar "Create new project" — back arrow navigates to the Project Overview screen without creating a project.
  • Option 1 — Upload from JSON:
    • "Upload Project JSON" button (with upload icon) — opens the device file picker filtered to .json files. The selected file is parsed and validated; if the JSON contains valid projectname, projectdescription, and agenttype fields the project is saved and the Edit screen opens.
    • If required fields are missing an error message is shown inline.
  • Option 2 — Generate with AI:
    • Prompt TextField (hint "Enter your project idea here…", multiline 10 lines) — the natural-language description of what the project should do. Must be at least 16 words before generation is allowed.
    • "Generate Project" ElevatedButton — sends the prompt to the AI writing agent (FullScreenProjectWritingAgent). While generating, a CircularProgressIndicator and a LinearProgressIndicator (30-second progress timer) are shown. The button is disabled during generation.
    • On completion the generated project is saved and the Edit screen opens for review.
  • Option 3 — Create empty project:
    • Project name TextField (label "Project name", hint "Enter project name…") — the only required input for an empty project.
    • "Create Empty Project" ElevatedButton — creates a blank project with the given name and opens the Edit screen immediately.

Scenarios

Import a project from a JSON file

  1. Tap the Upload Project JSON button.
  2. In the file picker, locate and select a .json project definition file.
  3. The app validates that projectname, projectdescription, and agenttype are present in the JSON.
  4. If valid, the project is saved to the device and the Edit Project screen opens so you can make any adjustments.
  5. If invalid, an error message identifies the missing fields.

Generate a project with AI

  1. Type a clear, detailed description of what you want the automation to do in the prompt field (at least 16 words).
  2. Tap Generate Project.
  3. A progress indicator appears; the AI model produces a structured project definition (this typically takes up to 30 seconds).
  4. When generation completes, the project is saved and the Edit Project screen opens for review and any final edits before the first run.

Create a blank project and configure it manually

  1. Type a name into the Project name field.
  2. Tap Create Empty Project.
  3. The Edit Project screen opens with only the name populated. Fill in the description, main prompt, execution schedule, and any other settings.
  4. Tap Save in the Edit Project screen to persist the project.
Navigate ← Automation ← User Manual