The architecture canvas

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

On this page

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 codeTerraformA language for describing cloud infrastructure as code. CloudForge writes Terraform for your architecture into the infra/ folder. 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 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.

BadgeWhat it means
PlannedThe work is planned. No code yet.
ScaffoldedThe files and structure exist.
CodedThe code is written.
ValidatedThe code passed its checks.
IntegratedThe part is wired to the parts it talks to.
VerifiedThe requirements linked to this part have test evidence, and its security checks pass.
ImplementedDone. The dot is solid green with a check mark.
BlockedThe work is waiting for a decision from you. The dot pulses and shows the reason.
ErrorSomething 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.

Keyboard shortcuts

Docs keyboard shortcuts
Ctrl + KOpen search
/Open search
?Show this list
[Previous page
]Next page
EscClose search, this list or the menu

Turn these off if they get in the way of speech input or other tools. Ctrl + K always works.