The ultimate toolkit for the modern Cloud Solution Architect.
Hi, I'm Jonathan. I work at Microsoft as an Azure Infrastructure Architect. This repository is my personal collection of tools, patterns, and automation scripts designed to solve high-scale infrastructure challenges with precision and speed.
| 🏗️ Architecture as Code | 📄 High-Fidelity Publishing | 🛠️ Enterprise Tooling |
|---|---|---|
Python Diagrams: Create cloud architecture diagrams using the diagrams library. |
Pandoc + Mermaid: Convert Markdown to professional Word/HTML with full diagram rendering. | Latest Stack: Python 3.13 (uv), PowerShell 7.5, Azure CLI, and GitHub CLI pre-configured. |
| Graphviz Rendering: High-quality SVG/PNG output for design reviews. | Enterprise Layouts: Automatic TOC, page breaks, and cover pages for RFP-grade reports. | Cloud-Ready: Native support for Azure infrastructure operations and automation. |
Important
This environment is designed to run in VS Code Dev Containers.
- Launch: Open folder in VS Code and click "Reopen in Container".
- Generate: Run the publishing engine to build your architecture documents.
python3 conversions/publish.py
- Consume: Find high-fidelity HTML and DOCX reports in
superapp/dist/.
| Category | Tools & Technologies |
|---|---|
| Cloud |     |
| Docs |    |
| Logic |    |
| Diagrams |   |
📐 Architecture Diagrams via Code
Combine the power of Python and Graphviz to design enterprise clouds.
with Cluster("Azure"):
hub = VNet("Hub")
spoke = VNet("Spoke")
hub >> spoke🖋 Professional Publishing Pipeline
Automated workflow that takes your Markdown and transforms it into RFP-grade reports.
- Source Markdown: Written in human-readable Markdown.
- Mermaid Rendering: Browser-based rendering of diagrams into high-fidelity PNGs.
- Pandoc Assembly: Heavy-duty conversion with custom Lua filters and CSS styling.
- Final Output: Document-ready DOCX and responsive HTML.
🏗 Enterprise Dev Container
Ubuntu 24.04 based container pre-baked with:
- Optimization: Multi-architecture support for x64 and ARM64.
- Automation: GitHub CLI (
gh) and Azure CLI Extensions pre-installed. - Stability: Fixed package versions for reproducible builds.
Built with ⚡ for High-Performance Azure Architecture