Documentation
Learn how to design, analyze, and document cloud architecture with Architecto. Comprehensive guides for architects, engineers, and cloud leaders.
Welcome to Architecto
Architecto is the AI-native platform for modern cloud architecture. Transform natural language descriptions into production-ready cloud architecture diagrams, comprehensive analysis reports, and professional documentation—all in one unified workflow.
What You Can Build
With Architecto, you can:
- Design Architecture Visually — Use Architect AI to generate multi-cloud architecture diagrams from natural language descriptions, or start with our pattern library of 240+ pre-built reference architectures
- Analyze Before Deployment — Leverage our Ultrathink analysis suite to evaluate cost implications, scalability limits, security threats, and performance characteristics
- Generate Professional Documentation — Create RFCs, ADRs, runbooks, and design documents automatically from your architecture
- Share and Collaborate — Export to PPT with custom branding, share diagrams via token links, and collect team feedback with inline comments
- Learn Cloud Architecture — Master best practices through 1,000+ quizzes and 1,000+ flashcard suites with spaced repetition
- Integrate with Your Workflow — Connect with GitHub, GitLab, Terraform, VS Code, Discord, Jira, and Confluence
Core Workflows
1. Prompt to Architecture
Describe your infrastructure needs in plain English, and Architect AI generates multiple architecture options with cost, security, and scalability analysis.
2. Code to Diagram
Upload your Terraform, CloudFormation, or Bicep files. Architecto automatically generates topology diagrams and identifies optimization opportunities.
3. Architecture Review
Share diagrams with your team. Collect feedback, compare versions, and track governance compliance with our built-in drift detector.
4. Learning and Mastery
Daily quizzes and flashcards help you and your team build cloud architecture expertise with structured, gamified learning paths.
Getting Started
Choose your path:
- New to Architecto? Start with Getting Started to understand core concepts and set up your first project
- Ready to Design? Jump to Architect AI to generate your first architecture
- Building Integrations? Explore our API Reference and Integration Guides
- Best Practices? Discover our Pattern Library and Governance Framework
Platform Features
Architecture & Design
- Architect AI — Multi-cloud architecture generation with natural language input
- Topology Canvas — Visual editor with drag-drop component system
- Pattern Library — 240+ industry-standard reference architectures
- Code Analysis — Parse Terraform, CloudFormation, and Bicep files into diagrams
Analysis & Intelligence
- Cost Estimator — 3D cost modeling with financial sustainability analysis
- Scalability Analyzer — Queuing theory-based load testing and throughput prediction
- Threat Modeler — STRIDE-based security analysis with mitigation strategies
- Architecture Diff — Semantic comparison of topology changes
- Performance Simulator — Latency modeling and bottleneck identification
- Drift Detector — Continuous infrastructure configuration monitoring
Documentation & Learning
- HyperDocs — Rich markdown editor with embedded visuals and real-time AI assistance
- AI Documents — Auto-generate documentation from topology diagrams
- CoDocs — Parse codebases and generate comprehensive reference documentation
- Quiz System — 1,000 daily quizzes across 10 cloud architecture categories
- Flashcard Suites — 1,000 topic-specific flashcard sets for spaced repetition
Export & Sharing
- Multi-Format Export — PNG, SVG, PDF, PPT with custom branding
- Token-Based Sharing — Secure, shareable links for collaboration
- Themed Exports — Full customization of colors, fonts, and backgrounds
- Comment Threads — Asynchronous feedback on shared diagrams
Key Concepts
Before you begin, familiarize yourself with these fundamental concepts:
- Topology — The visual representation of your cloud architecture and service relationships
- Nodes — Individual components (compute, storage, networking, databases, etc.)
- Flows — Data movement and communication between services
- Analysis Modules — Specialized tools that evaluate architecture against specific dimensions (cost, security, scalability)
- Profiles — Predefined cloud provider configurations (AWS, GCP, Azure, Kubernetes)
- Themes — Visual customization for exports and presentations
Documentation Structure
This documentation is organized into several sections:
| Section | Purpose |
|---|---|
| Getting Started | Foundational concepts, account setup, and first project creation |
| Core Concepts | Deep dives into architecture terminology and Architecto-specific conventions |
| Features | Comprehensive guides for each major feature and analysis module |
| API Reference | Developer documentation for programmatic access and integrations |
| Integrations | Step-by-step guides for connecting with external tools and services |
| Best Practices | Architecture patterns, governance strategies, and optimization techniques |
| Governance | Compliance frameworks, policy-as-code, and organizational management |
Need Help?
- Questions? Check our FAQ or join our Community Discord
- Need Examples? Browse Real-World Architectures for inspiration
- API Issues? Check API Reference for endpoints and error handling
- Community — Join our Community Discord.
- Support — Reach out to our engineering team at support@architecto.dev.
Ready to design your first architecture? Start here →