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

# Your first diagram

> Generate a diagram from a prompt in under a minute.

<Frame caption="The five steps from blank page to exported diagram">
  <img src="https://mintcdn.com/docdiagram/41jLckNKrw3Njatp/images/diagrams/first-diagram-flow-light.svg?fit=max&auto=format&n=41jLckNKrw3Njatp&q=85&s=154c40755287c157195567f9b2c6bce9" alt="Open prompt, describe it, generate, iterate, export" className="block dark:hidden" width="880" height="220" data-path="images/diagrams/first-diagram-flow-light.svg" />

  <img src="https://mintcdn.com/docdiagram/41jLckNKrw3Njatp/images/diagrams/first-diagram-flow-dark.svg?fit=max&auto=format&n=41jLckNKrw3Njatp&q=85&s=e741d646161ddb1c6e709d11283d8d6e" alt="Open prompt, describe it, generate, iterate, export" className="hidden dark:block" width="880" height="220" data-path="images/diagrams/first-diagram-flow-dark.svg" />
</Frame>

You don't need an account to try DocDiagram. New visitors get 3 free credits, no card required.

## 1. Open the prompt box

Go to [docdiagram.com](https://docdiagram.com). The prompt box sits in the middle of the page with the placeholder *"Ask DocDiagram to draw\..."*.

## 2. Describe what you want

Be specific about the kind of diagram and the pieces involved. Good prompts name the components and the relationships between them.

**Examples that work well:**

* *"A sequence diagram showing a user signing in with Google OAuth: browser, our API, Google, and the database."*
* *"An architecture diagram for a Next.js app on Vercel with a Postgres database and a Redis cache."*
* *"An ER diagram with Users, Posts, and Comments. Users have many Posts, Posts have many Comments."*

**Tips:**

* Name the diagram type (sequence, architecture, flowchart, ER, org chart).
* List the entities or steps explicitly.
* Mention the direction of flow if it matters ("left to right", "top to bottom").

## 3. Generate

Press the submit button or hit Enter. DocDiagram renders the diagram and shows it to you in a chat-style editor.

## 4. Iterate

Not quite right? Tell it what to change in plain English:

* *"Add a load balancer in front of the API."*
* *"Move the database to the right."*
* *"Use dashed lines for async calls."*

Each refinement is a turn in the chat. Your previous diagram stays in context.

## 5. Export

Click the export button and pick your format. See [Exporting](/quickstart/exporting) for what each format is best for.

## Next

<Card title="Start from a template" icon="grid" href="/quickstart/from-a-template">
  Skip the blank-page problem.
</Card>
