> ## Documentation Index
> Fetch the complete documentation index at: https://docs.justflow.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a BPMN diagram with AI assistance or from scratch

> Start a new BPMN diagram in seconds — describe your process in plain text, let the AI generate it, or build from a blank canvas at your own pace.

Just Flow It gives you two ways to create a BPMN diagram: let the AI build it from your description, or start with a blank canvas and place elements yourself. Both paths begin in the same place — the **New diagram** button — and you can switch between AI assistance and manual editing at any point after creation.

<Tabs>
  <Tab title="AI Generation">
    The AI generation path is the fastest way to go from idea to diagram. Describe your business process in plain English (or upload a voice note, photo, or PDF), and Just Flow It produces a complete, properly structured BPMN 2.0 diagram in seconds.

    <Steps>
      <Step title="Open Just Flow It">
        Sign in to your account and land on the **My Diagrams** dashboard.
      </Step>

      <Step title="Click New Diagram">
        Select the **+ New diagram** button in the top-right corner of the dashboard.
      </Step>

      <Step title="Describe your process">
        In the prompt field, type a plain-English description of the business process you want to model. Be as detailed or as high-level as you like — you can always refine the result later.

        ```text theme={null}
        A customer submits an order on our website. The warehouse team picks
        and packs the items, then a payment gateway charges the card. If payment
        succeeds, the order ships. If payment fails, the customer is notified
        and the order is cancelled.
        ```
      </Step>

      <Step title="Click Generate">
        Press **Generate** (or hit Enter). The AI creates your BPMN diagram and opens it in the editor within a few seconds. From here you can refine it with chat instructions or edit elements manually.
      </Step>
    </Steps>

    <Tip>
      The more context you give — swimlane owners, decision conditions, exception paths — the richer the initial diagram. You can always add detail through [chat refinement](./chat-refinement) after generation.
    </Tip>
  </Tab>

  <Tab title="Blank Canvas">
    If you prefer to build a diagram element by element, or if you're working from an existing process map you want to recreate precisely, the blank canvas gives you full manual control from the start.

    <Steps>
      <Step title="Open Just Flow It">
        Sign in to your account and land on the **My Diagrams** dashboard.
      </Step>

      <Step title="Click New Diagram">
        Select the **+ New diagram** button in the top-right corner of the dashboard.
      </Step>

      <Step title="Choose Blank canvas">
        In the creation dialog, select **Blank canvas** instead of entering a prompt. The editor opens with an empty canvas and the BPMN element palette on the left sidebar.
      </Step>

      <Step title="Drag elements onto the canvas">
        Click and drag any BPMN element from the left-hand palette — events, tasks, gateways, pools, lanes, and more — onto the canvas. Connect elements by hovering over a shape until the connection handles appear, then dragging to the target element.
      </Step>
    </Steps>

    <Tip>
      Even on a blank canvas you can invoke the AI at any time. Type an instruction in the chat panel and the AI will add or modify elements based on what's already on your canvas.
    </Tip>
  </Tab>
</Tabs>

## Plan limits

<Note>
  Diagrams are **unlimited** on every plan, including Free. The Free plan includes **1 advanced AI prompt per day** — it refreshes automatically at UTC midnight; once you've used it, you can keep editing manually until it resets.

  Upgrade to **Pro** for unlimited advanced AI prompts and version history, or to **Team** for collaboration features. Visit your account settings or click **Upgrade** in the prompt to compare plans.
</Note>

## Supported input formats

Beyond typing a description, Just Flow It accepts several other input formats when generating a diagram:

<CardGroup cols={2}>
  <Card title="Voice note" icon="microphone">
    Record or upload an audio file describing your process. The AI transcribes and interprets the spoken description.
  </Card>

  <Card title="Photo or image" icon="image">
    Photograph a whiteboard sketch or a printed process chart. The AI reads the visual layout and converts it to BPMN.
  </Card>

  <Card title="PDF document" icon="file-pdf">
    Upload a procedure document, SOP, or specification PDF. The AI extracts the process steps and maps them to BPMN elements.
  </Card>

  <Card title="Plain text" icon="text">
    Paste or type any description — bullet points, numbered steps, or free-form prose — directly into the prompt field.
  </Card>
</CardGroup>