Integrations

Architecto integrates seamlessly with the tools your team already uses.

Version Control

GitHub

Import repositories and trigger architecture generation on code changes.

Setup:

1. Go to Integrations → GitHub
2. Click Connect GitHub
3. Authorize Architecto to access repositories
4. Choose specific repositories or all

Use Cases:

• Import Terraform files into diagrams
• Auto-update architecture when IaC changes
• Create architectures from repository code
• Link diagrams to pull requests

Actions:

- Import Terraform from GitHub
- Watch for changes in .tf files
- Create PR comments with diagram preview
- Sync architecture to GitHub discussion

GitLab

Similar to GitHub integration (coming soon)

• Import from GitLab repositories
• GitLab CI/CD pipeline integration
• Sync diagrams to merge requests

Infrastructure as Code

Terraform

Parse Terraform files and generate architecture diagrams.

How It Works:

1. Upload .tf file or connect GitHub
2. Architecto parses provider resources
3. Generates topology from resource definitions
4. Creates nodes for each resource
5. Connects them based on dependencies

Example: Uploading this Terraform file:

resource "aws_vpc" "main" {
  cidr_block = "10.0.0.0/16"
}

resource "aws_lb" "main" {
  load_balancer_type = "application"
}

resource "aws_instance" "app" {
  instance_type = "t3.medium"
  count         = 3
}

resource "aws_rds_cluster" "db" {
  engine = "aurora-postgresql"
}

Generates diagram showing: VPC → Load Balancer → EC2 Instances → RDS

CloudFormation

Import AWS CloudFormation templates.

• Parse YAML/JSON templates
• Generate topology from stacks
• Support for all AWS resources

Bicep

Azure infrastructure language support (coming soon)

CDK (Infrastructure as Code)

AWS CDK support (coming soon)

Collaboration Platforms

Discord

Share architectures and get notifications in Discord.

Setup:

1. Go to Integrations → Discord
2. Click Add to Discord
3. Select workspace and authorize
4. Choose notification channel

Features:

• Share architectures in Discord channels
• Get notifications on:
  • Architecture shared with you
  • Comments added to shared diagrams
  • Team invitations
• Search architectures in Discord
• Unfurl architecture links with preview

Example:

/architecto share my-ecommerce-arch #team-architecture

Jira

Link architectures to Jira issues and create tickets from findings.

Setup:

1. Go to Integrations → Jira
2. Enter Jira Cloud ID
3. Generate and paste API token

Features:

• Link architecture to Jira epics/stories
• Create tickets from analysis findings:
  • Cost optimization suggestions
  • Scalability recommendations
  • Security mitigations
  • Compliance issues
• Add architecture diagrams as Jira attachments
• Update issue status from Architecto

Confluence

Embed architectures in Confluence documentation.

Setup:

1. Go to Integrations → Confluence
2. Select target Confluence space
3. Authorize access

Features:

• Embed live architecture diagrams in pages
• Auto-generate documentation from architecture
• Keep diagrams in sync across wiki
• Publish RFC/ADR directly to Confluence

Communications

Email

Send architectures and reports via email.

• Share diagrams with non-team-members
• Email analysis reports
• Scheduled email digest of new architectures
• Export and attach to email

Teams (coming soon)

Microsoft Teams integration

• Share to Teams channels
• Get Teams notifications
• Embed diagrams in Teams chats

Analytics & Monitoring

Datadog (coming soon)

Monitor architecture deployments.

New Relic (coming soon)

Track performance metrics.

Grafana (coming soon)

Visualize metrics and logs.

Cloud Providers

AWS

Native AWS integration (already included)

• Service icons for 200+ AWS services
• Pricing data integration
• VPC and security group support

Google Cloud Platform

GCP integration (already included)

• Service icons for GCP services
• Pricing data
• VPC support

Microsoft Azure

Azure integration (already included)

• Service icons for 100+ Azure services
• Pricing data
• Virtual network support

Kubernetes

Kubernetes and container orchestration (already included)

• Pod, deployment, service icons
• Multi-cluster support
• Helm charts visualization (coming soon)

Development Tools

VS Code

View and edit architectures in VS Code.

Install Extension:

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search "Architecto"
4. Click Install

Features:

• View architectures in editor
• Link code to architecture components
• Quick architecture preview on hover
• Edit architecture without leaving IDE

Postman

Test APIs and integrations.

• Postman Collection
• Import to test all endpoints
• Pre-configured authentication

AI & Automation (Coming Soon)

GitHub Actions

Automate architecture workflows.

- name: Update Architecture
  uses: architecto/update-architecture@v1
  with:
    terraform-path: ./infrastructure
    api-key: ${{ secrets.ARCHITECTO_API_KEY }}

Zapier

Connect to 1000+ apps via Zapier.

• Trigger actions on Zapier events
• Send architectures to any connected app

Custom Integrations

Webhooks

Build custom integrations with webhooks.

POST /webhooks
{
  "url": "https://your-app.com/architecto-webhook",
  "events": ["architecture.created", "analysis.completed"]
}

API

Use the REST API to build anything.

• Full API Reference
• SDKs for Python, Node.js, Go, Ruby, Java
• GraphQL support (coming soon)

Integration Setup Best Practices

1. Least Privilege — Only authorize scopes you need
2. Secure Secrets — Store API keys in environment variables
3. Test First — Test integration in staging environment
4. Monitor — Track integration health and error rates
5. Document — Keep team documentation updated

Troubleshooting

Can't find an integration?

• Check the Integrations page
• Post feature request on GitHub
• Email us at support@architecto.dev

Integration not working?

• Check API key expiration
• Verify webhook URL is accessible
• Check error logs in integration settings
• Contact support@architecto.dev

Next Steps:

• API Reference
• Example Workflows