Architecture

Diataxis quadrant: Understanding-oriented

Target Audience

Core developers

Purpose

Explain "why it's designed this way." Help readers build a holistic understanding of the system, including the context and trade-offs behind design decisions.

Writing Principles

• Include Mermaid diagrams to aid understanding
• Explain the "why" behind design decisions, not just the "what"
• Content is verified against actual code, not copied from old documentation
• Provide "further reading" link targets for guide/ and tutorial/

Documents Included

• software-architecture.md -- Presto main application architecture (Wails/Go/Web frontend)
• registry-architecture.md -- Registry architecture (template distribution pipeline)
• cicd-pipeline.md -- CI/CD pipeline (GitHub Actions build matrix)
• website-architecture.md -- Website architecture (Presto-homepage)