# The architecture canvas

See your cloud architecture, change it, ask for a new version and open the Terraform code behind each part.

Source: https://docs.trycloudforge.com/architecture

## The canvas


Open **Architecture** from CloudForge Home or the **Blueprint** menu.


An empty canvas says so. Choose **Generate** in the toolbar and CloudForge designs an architecture from your approved PRD and requirements. You can also add services yourself: right-click empty space and choose **Add Service…**.


Turn on **Cost Overlay** in the toolbar to see an estimated monthly cost on each box. Treat it as an estimate, not a bill.



## Move and change parts


- Drag a box to move it. Drag from one box to another to connect them.
- Right-click a box for more: **Duplicate**, **Change Service…**, **Disconnect All**, **Move into Container** and **Delete**.
- Right-click a line to change its protocol, switch it between sync and async, or bend it.
- Right-click empty space for **Add Service…**, **Auto-Layout**, **Fit All**, **Snap to Grid** and **Export PNG**.
- Undo with Ctrl+Z. Redo with Ctrl+Y.



## Ask for a new version


1. Choose **Refine** in the toolbar. The chat opens. Say what you want, for example "Add a cache in front of the database".
2. CloudForge shows its proposal in **Review proposed design**. Switch between **Current** and **Proposed** to compare. It lists what is added, changed and removed.
3. Choose **Apply changes** to use it, or **Reject** to keep what you have.


Applying a proposal changes the diagram only. It does not change your Terraform files until you generate them again.



## See the Terraform code


1. Choose **Generate Terraform** in the toolbar. CloudForge saves your progress and writes Terraform code into the `infra/` folder. It does not deploy. When it is done, the button says **Terraform ready**. If something fails, choose **Retry Terraform**.
2. Double-click any box to open the Terraform code for that part. You can also right-click it and choose **View Terraform Code**.


If you change the diagram later, the button changes to **Update Terraform**. Choose it to bring the code in line with the diagram.


Before any Terraform exists, double-clicking a box does nothing, and View Terraform Code is not in the menu. Generate the Terraform first.



## Component status badges


When you [implement](https://docs.trycloudforge.com/implement) a part, a small dot in its corner shows how far the work has come. Hover over the dot to see the state. Parts that you have not started show no dot.


| Badge | What it means |
| --- | --- |
| Planned | The work is planned. No code yet. |
| Scaffolded | The files and structure exist. |
| Coded | The code is written. |
| Validated | The code passed its checks. |
| Integrated | The part is wired to the parts it talks to. |
| Verified | The requirements linked to this part have test evidence, and its security checks pass. |
| Implemented | Done. The dot is solid green with a check mark. |
| Blocked | The work is waiting for a decision from you. The dot pulses and shows the reason. |
| Error | Something is wrong in that part's Terraform code. The dot shows an exclamation mark. The part keeps the progress it already made. |


Badge colors can change with your color theme.


Next: [Implement a component](https://docs.trycloudforge.com/implement).
