DevToolsArchitectureOpen SourceDocumentation

GSL — Architecture as Text

Describe your system architecture as text, not just a diagram

Problem
Mermaid and PlantUML run into expressiveness limits fast: they can't capture the nuance or runtime behavior of real systems, so diagrams drift away from reality.
Solution
A text-based architecture description language: describe components, data flows, deployment constraints, and runtime patterns with readable syntax, then render clear diagrams and a verifiable model. Exports to Mermaid so the description stays tool-friendly.
Users
System architects, backend engineers, teams writing architecture docs
MVP
Define core syntax and parser; support components, connections, data flows, and constraints; render diagrams and export Mermaid/SVG; CLI to validate description files; ship a runnable example repo
Revenue
Open-source core language plus team plan for hosted editor, collaboration, and version diffs
Why now
Systems are getting more complex and AI-generated code makes architecture drift faster, raising the value of text descriptions that stay in sync with implementation

Source discussions · 1

  1. Hacker NewsShow HN: GSL – I wanted to describe the architecture, not just draw it1↑ 0
← Back to list