Documentation

Learn how to create professional infrastructure diagrams with Infragram's AI-powered platform.

Getting Started

Creating your first infrastructure diagram takes just a few steps:

Create an account - Sign up with your email address
Describe your infrastructure - Write a plain English description of your architecture
Generate - Click the generate button and let AI create your diagram
Refine - Regenerate with updated prompts if needed
Export - Download in your preferred format

Tip: Start with a simple description and add details in subsequent iterations. The AI works best with clear, structured prompts.

Writing Effective Prompts

The quality of your diagram depends on how well you describe your architecture. Here are some best practices:

Be Specific About Components

Instead of generic terms, use specific service names:

Bad:  "A web app with a database"
Good: "A React frontend on S3 with CloudFront, Node.js API on ECS Fargate, PostgreSQL on RDS"

Describe Connections

Explain how components communicate:

"The frontend calls the API through an Application Load Balancer.
The API connects to the database on port 5432 and uses Redis for session caching."

Include Infrastructure Details

Mention networking, security, and scaling requirements:

"Deploy in a VPC with public and private subnets across 2 availability zones.
Place the ALB in public subnets, API servers in private subnets.
Use NAT Gateway for outbound internet access."

Example Prompts

Microservices

API Gateway routing to 3 services (users, orders, inventory), each with its own database, connected via SQS

Serverless

Lambda functions triggered by API Gateway and S3 events, storing data in DynamoDB, logs in CloudWatch

Kubernetes

EKS cluster with ingress controller, 3 deployments, horizontal pod autoscaler, connected to RDS and ElastiCache

Data Pipeline

Kinesis streams ingesting data, processed by Lambda, stored in S3, queried with Athena, visualized in QuickSight

Supported Cloud Providers

Infragram includes icons and components for major cloud providers:

Amazon Web Services (AWS) - EC2, Lambda, S3, RDS, ECS, EKS, and 100+ services
Google Cloud Platform (GCP) - Compute Engine, Cloud Functions, Cloud Storage, Cloud SQL, GKE, and more
Microsoft Azure - Virtual Machines, Functions, Blob Storage, SQL Database, AKS, and more
DigitalOcean - Droplets, Kubernetes, Databases, Spaces, Load Balancers
Alibaba Cloud - ECS, OSS, RDS, SLB, and more
IBM Cloud - Virtual Servers, Kubernetes, Cloud Functions, Databases
OVH - Public Cloud, Kubernetes, Object Storage
IONOS - Compute, Kubernetes, S3 Storage
Cloudflare - Workers, R2, D1, CDN, DNS
Kubernetes - Pods, Deployments, Services, Ingress, ConfigMaps
Generic - Databases, servers, users, networks, security components

Export Options

Export your diagrams in multiple formats:

PNG - Raster image format, good for sharing and embedding
SVG - Scalable vector format, ideal for documentation and presentations (Pro plan)
PDF - Print-ready format (Pro plan)
JSON - Raw diagram data for programmatic access (Pro plan)

Version History

Pro users can track changes to their diagrams over time:

Each regeneration creates a new version automatically
View and restore previous versions at any time
Compare versions to see what changed
Up to 5 versions stored per diagram (Pro), unlimited (Team)

API Reference

Integrate Infragram into your workflows with our REST API (Pro and Team plans).

Authentication

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.infragram.io/v1/diagrams

Create a Diagram

POST /v1/diagrams
Content-Type: application/json

{
  "title": "My Architecture",
  "prompt": "A serverless API with Lambda, API Gateway, and DynamoDB"
}

Get Diagram Status

GET /v1/diagrams/{id}

Response:
{
  "id": "abc123",
  "status": "completed",
  "result_svg": "..."
}

Frequently Asked Questions

How many diagrams can I create?

Free accounts can create 1 diagram. Pro accounts can create up to 5 diagrams with version history. Team accounts have unlimited diagrams.

What counts as an AI credit?

Each diagram generation or regeneration uses 1 AI credit. Credits reset monthly based on your plan.

Can I edit the generated diagrams?

Currently, you can regenerate diagrams with updated prompts. Direct visual editing is on our roadmap.

Are my diagrams private?

Yes, all diagrams are private by default. You can optionally make individual diagrams public to share with others.

What happens if I downgrade my plan?

Your existing diagrams remain accessible in read-only mode, but you won't be able to create new ones beyond your new plan's limit.