Skip to content
skivaDocumentation
Start here

Your first diagram

Start with a small system. You can add detail as the architecture takes shape.

1. Open your workspace

Sign in with Google, select your workspace in the sidebar, and choose New diagram. Give it a name that describes the system you are mapping.

2. Describe the connections

Enter a concrete description in the command bar. Include the components, their responsibilities, and the direction of requests or data.

A web app sends orders to an API. The API stores orders in Postgres and publishes a job to a queue. A worker consumes the jobs and sends confirmation emails.

Use ⌘ / Ctrl + K to focus the command bar.

3. Review the proposal

Inspect the suggested changes before accepting them. Accept applies the proposal to the diagram; reject keeps your current diagram. If the canvas has changed since a proposal was created, generate a fresh proposal against the current version.

4. Make it yours

Move components, edit labels and notes, or ask for a focused change such as “Add a cache between the API and Postgres.” When you are ready, use the share or export menu. Explore the canvas →