GitUML

UML visualisation
for Git repositories

Try Now

Understanding source code
is every programmer's
biggest challenge

GitUML helps programmers understand new code more quickly.

Understand code quickly

Rapidly generate diagrams from programming source code.

Language Support

GitUML reverse-engineers the following languages:

  • Python
  • Java
  • Javascript
  • Typescript Babel powered - latest ts syntax supported
  • Objective C (Apple - iOS, MacOS, tvOS source code 🍏)
  • C#
  • Delphi/Free Pascal


GitUML converts source code into beautiful, helpful diagrams:

GitUML can reverse engineer Python, Javascript, Java, C#, Objective C and Delphi/Free Pascal.


Build "Literate Code Map" diagrams

When you want more detail than a UML diagram can provide try building a Literate Code Map which is a new, practical evolution of UML for today's code centric, practical programmer. Blend reverse engineering (via GitUML) with your "literate" custom code fragments and rich, text narrative comments/stories - step by step so that viewers of the diagram follow the use case story.


2 min Video Tutorial

Creating a UML diagram in 10 seconds then upgrade it into a more powerful "Literate Code Map" diagram.



A revolution in documentation

GitUML rapidly produces beautiful UML class diagrams every time.

  • Diagrams automatically update when you push code using git
  • Diagrams are always up to date
  • This lets programmers focus on coding instead of fussing with drawing tools.
A $60K/annum employee may very well take $120K before reaching the productivity level and
contribution of the developer who left the team. Dave Laribee

Onboard new programmers more quickly using software visualisation.

Save as programmers become effective more quickly.

Rethinking Code Visualisation

Making software diagramming useful to today's modern, agile, code-centric programmers

  • Easy reverse engineering into UML by simply selecting files from GitHub repositories. File uploads and "UML Fiddles" (direct code to diagram) mode too!
  • When new code changes are pushed, diagrams are updated automatically thus remain up to date with the code. This maintains diagram accuracy/usefulness and requires less diagram maintenance - saving programmer time.
  • UML diagrams can sometimes be too abstract for programmers to find useful. GitUML supports evolving reverse engineered UML diagrams into Literate Code Maps, which are innovative, powerful "Tuftian" visualisations that empower the programmer to understand complex code, add features and fix bugs more quickly.
  • Literate Code Maps combine class and sequence diagrams into the one diagram, with numbered steps which lead the reader's eye, step by step, through the diagram. Each diagram box (which can be a class, file or any container) can contain one or more code compartments where you can add real source code fragments and rich narrative commentary. See the Literate Code Map manifesto for more information.
  • Easy to share rich, zoomable diagrams via urls.
  • Using textual PlantUML markup for flexible diagram editing rather than $$ and fiddly tools. Each GitUML diagrams is built from a blend of both automated reverse engineering and additional custom diagram markup.
  • GitUML is appealing to organisations who understand that powerful, insightful, diagrams containing rich detail are a boon to new programmers joining a team, increasing productivity thus reducing new staff onboarding times. They can capture knowledge when programmers leave a project, too.
  • The idea of building a Code Map is based on what many programmers already do when taking notes in their notebooks and reading code. The process of building a Code Map will give a programmer understanding of any complex software behaviour, which empowers the programmer to add features and gets bugs fixed more quickly.

    The process of building a Code Map is a secret weapon to tackle software complexity, spaghetti code, and complex Object Oriented code. Spend days browsing code, guessing and hacking - or respect the problem, do it right, and in an hour or two have a solution by building a code map.
  • Consulting services available to facilitate the use of GitUML in your organisation. Custom hosting for sensitive, non GitHub codebases available.
GitUML is a nice project!
Arnaud Roques, creator of PlantUML

Point and Click

Browse any git repository on the web and select the files you want to visualise.

  • Popular public repositories listed
  • Browse your own repositories
  • Automatic layout - saving you time

Gallery View

Access your diagrams via a thumbnail gallery.

  • Click to edit or delete, duplicate etc
  • View descriptions and user comments
  • Search by repository or tags
39% of survey respondents view application complexity as their top challenge. Trends in Web Technologies – A Global Research Report

Building a UML or Literate Code Map diagram as part of code analysis results in real understanding plus a knowledge artifact (the diagram) to keep and share.

Keep diagrams simple

Communicate what's important

  • Select only the files and classes that you want
  • Capture knowledge
  • Each diagram tells a story, your way

Refine your diagrams

Add anything you want to your diagrams

  • Attach yellow text notes to any class
  • Add additional classes & relationships
  • Use "point and click" to add common elements or use PlantUML markup
  • Evolve your reverse engineered UML diagram into a powerful Literate Code Map diagram containing source code fragments and much more. Blend automatic with custom diagram elements.

Losing staff who "know the code"
is every company's fear

GitUML protects your intellectul property when staff turnover occurs.

Productive Handovers

Developers with knowledge can document designs rapidly before they leave

  • Preserve knowledge of the code
  • Offboard existing staff with more confidence.
  • Onboard new staff more quickly - saving you money
The total cost of losing an employee can range from tens of thousands of dollars to
1.5 to 2 times their annual salary. Rachel Ferrigno

Unplanned turnover hurts — especially when you lose top people. Aaron Reed

Share your diagrams

Diagrams are URLs

  • Each diagram is a permalink URL internet resource.
  • Share diagrams with your team, in print, blogs and documentation.
  • Turn off GitUML git push auto update to lock a diagram to a moment in time.
from http://www.quansershare.com/Images/submit-ad.png

Attract contributors

Get more contributors to Open Source projects. Contribute more.

  • Key design diagrams of Github projects helps everyone.
  • Attract more contributors by making it easier for them to understand the code.
  • Contribute more productively to well documented projects.

AI-Powered Code Explanations

Revolutionary AI-generated documentation that combines engaging narrative with multiple UML diagrams - creating rich, visual explanations that read like a well-crafted technical article.

Beyond Simple Diagrams

Traditional code documentation offers you two choices: dry, text-only explanations or isolated UML diagrams. GitUML's AI-Powered Explanations give you something completely different - engaging technical narratives that seamlessly weave together prose with multiple diagram types, creating documentation that's actually enjoyable to read.

The AI doesn't just describe your code - it tells the story of how your software works, using diagrams exactly where they're needed to illuminate complex concepts. Think of it as having an expert technical writer who deeply understands UML, software architecture, and visual communication.

Intelligent Multi-Diagram Generation

The AI analyzes your codebase and automatically generates the right diagrams at the right time:

  • Class Diagrams - to show object-oriented structure and relationships
  • Sequence Diagrams - to illustrate how objects interact over time
  • State Diagrams - to visualize state machines and workflows
  • Activity Diagrams - to map out process flows and algorithms
  • Component Diagrams - to show high-level architecture
  • Use Case Diagrams - to capture functional requirements
  • Entity-Relationship Diagrams - for data models
  • Custom PlantUML - any diagram type you need

Each diagram is strategically placed within the explanation to maximize understanding. The AI knows when a class diagram clarifies architecture, when a sequence diagram reveals flow, and when a state diagram unlocks complex logic.

Three Ways to Explain Your Code

  • GitHub Repositories - Point to any public or private repository, select the files you want explained, and let AI create comprehensive documentation
  • File Uploads - Upload your source files directly. Perfect for private codebases or code that's not in version control yet
  • Code Snippets - Paste code directly into the editor. Ideal for explaining algorithms, patterns, or getting quick documentation for code fragments

Universal Language Detection: The AI automatically detects Python, Java, JavaScript, TypeScript, C#, Objective-C, Delphi/Pascal, and more - no configuration needed.

Bring Your Own AI - Complete Control

GitUML's PRO accounts support BYOK (Bring Your Own Key) - use your own API keys with leading AI providers:

  • OpenAI - GPT-5, etc
  • Anthropic - Claude 4.5 Sonnet, Opus
  • Google - Gemini 2.5 Pro, Flash
  • Ollama Cloud - Open-source models
  • Together.ai - Choose an open-source model of your choice
  • Grok - Models offered by X
  • Choose the best model for your needs
  • Control your AI spending
  • Keep your data secure

Free accounts can try the feature using GitUML's shared AI credits. PRO users get unlimited explanations using their own API keys with full control over which models to use, custom prompts, and complete data privacy.

Why AI-Powered Explanations Are Game-Changing

For Individual Developers:

  • Understand unfamiliar codebases in minutes instead of hours
  • Generate documentation for your own projects automatically
  • Learn from explanations that combine text and visuals naturally
  • Share engaging technical documentation with your team
  • Export explanations as PDF or HTML for easy distribution

For Teams and Organizations:

  • Onboard new developers faster with instant, high-quality documentation
  • Preserve institutional knowledge when developers leave
  • Maintain living documentation that's always up-to-date
  • Reduce context-switching time when moving between projects
  • Create consistent documentation standards across your organization

Learn More About AI-Powered Explanations

Want to dive deeper into how AI-Powered Explanations work? Check out our detailed documentation for insights on the underlying technology, customization options, and best practices to get the most out of this revolutionary feature.

The Future of Code Documentation Is Here

Stop choosing between plain text and isolated diagrams. AI-Powered Explanations combine the best of both worlds - creating documentation that's visual, engaging, and comprehensive.

Whether you're documenting a complex algorithm, explaining a microservice architecture, or creating onboarding materials for new team members, AI-Powered Explanations deliver the clarity and depth you need - automatically.

Try AI Explanations Now View PRO Features

Note: AI-Powered Explanations work with any programming language that the AI knows about.


Benefit Summary :


Leaders of IT projects...


Developers...


Try Now

Pricing

Choose a pricing plan that fits your needs.

All prices are in USD

  • Basic
  • 5 Diagrams
  • public Repositories
  • limited classes per Diagram
  • FREE

  • Pro
  • unlimited Diagrams
  • public and private Repositories
  • max classes per Diagram
  • $25

    per year
    per developer
  • Team
  • unlimited Diagrams
  • public and private Repositories
  • max classes per Diagram
  • team members share Diagrams
  • Contact Us To Discuss Pricing

    per month (5, 10 or more email team)


Custom GitUML Hosting

Tailored to your needs

  • Run GitUML inside your cloud containers - for complete security
  • Run GitUML inside your company network infrastructure
  • Access any local git repositories (not just GitHub).

Rapid 'Staff Onboarding' Service

We will work with your team - hands on, to

  • Oversee the documentation of your critical project creating:
    • An engaging project overview and architecture summary document (five pages).
    • Five key GitUML project diagrams incl. some as Literate Code Maps.
    • Two quality tutorials.
  • Develop rapid onboarding programs for new staff that use this documentation, together with traditional onboarding through handovers, working with automated tests etc.
  • Ensure knowledge is captured when staff leave
  • We can audit your project documentation to protect your company IP and to support governance
  • Our consulting pays for itself through increased programmer productivity and the ability to scale projects more rapidly.

Feedback

Please take the time to fill out a short survey on this site.