Your first diagram in 10 minutes

A diagram holds one model of your system and the views drawn from it. Start with an empty one.

1. Open iyedy

   Go to app.iyedy.com and sign in. You land on your Home page.

2. Create the diagram

   Press Ctrl K, type library and run Open library. In the Library, select New diagram: iyedy creates Untitled diagram and opens it in the editor.

3. Name it

   Double-click the diagram's name in the bar above the canvas, or press F2. Type Claims Platform and press Enter.

The new diagram is empty: the sheet says The model is empty, and every view needs a system first. A container is something that runs inside that system: an app, a service, a database. Describe them in one sentence and let the Assistant draft them.

1. Describe the system

   Press Ctrl J to open the Assistant, and write: “A software system called Claims Platform, with three containers: Mobile app (React Native), API gateway (API Management) and Claims Service (.NET 8). The Claims Service calls an external system called Payments.”

2. Apply the draft

   The draft shows on the sheet before anything changes. Read it, then select Apply.

3. Open the Containers view

   In the Views list on the left, select the Containers view.

A relationship says who calls whom. Draw the two that are missing, then say what kind each one is.

1. Pick the Relationship tool

   On the left of the canvas, select Relationship, or press R.

2. Drag from Mobile app to API gateway

   Start on the edge of the first element and release on the second. iyedy routes the line at right angles for you.

   My diagrams / Claims PlatformSystem contextContainersDeploymentDraft

   1T

   Container

   Mobile app

   React Native

   Container

   API gateway

   API Management

   Container

   Claims Service

   .NET 8

   System

   Payments

   External

   2

   Relationship

   Mobile app → API gateway

   Kind3

   Sync requestAsync messageData flowDependency

   Description

   Submits a claim to

3. Add the other relationship

   Draw API gateway → Claims Service the same way, and give it the kind Sync request. The Assistant already drew Claims Service → Payments: select it and set its kind too.

   Check your work. Three lines join the four elements, each with an arrow, and the Inspector shows the kind of the one you select.

iyedy's checks are rules, not AI: they cost nothing and send nothing.

1. Run the checks

   Select Run the checks. The findings appear with their severity: HIGH, MED, LOW or INFO.

2. Read one finding

   Select a finding to see the element it is about and why the rule flags it. You decide what to do with it.

The Assistant proposes, you decide. Nothing changes before you apply.

1. Open the Assistant

   Press Ctrl J. Ask, in your words: “Add a database for the claims, used by the Claims Service.”

2. Read the estimate

   Before you send, the Assistant shows about how many credits the request takes and how many you have left. On Free, the welcome credits pay for it.

3. Review, then apply

   The proposal shows on the sheet as a ghost. Read it, then select Apply, or leave it.

A named version is a state you can come back to and show.

1. Save a named version

   Press Ctrl S or select Save named version…, and name it First draft.

2. Share it

   Select Share…, enter a colleague's e-mail address and keep Can view.