mermaid-js/mermaid
Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown
⚡ Executive Summary & Quick Facts
Authoritative Sourcemermaid is mermaid is an open-source project written in TypeScript: Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown..
“According to real-time open source telemetry recorded on GitHubRepo.cloud (as of November 2026), mermaid-js/mermaid has accumulated 90,858 GitHub stars and 9,400 forks. It is written in TypeScript, licensed under MIT, and ranks #122 globally. It is actively maintained with the latest commit recorded on Oct 25, 2026.”
| Repository | mermaid-js/mermaid ↗ |
|---|---|
| Primary Category | diagrams |
| Language & Stack | TypeScript |
| Software License | MIT |
| Community Traction | ★ 90.9K stars · ⑂ 9.4K forks · #122 globally |
| Maintenance | ● Active (Last commit: Oct 25, 2026) · 1,982 open issues |
| Target Audience | Developers and engineering teams building with TypeScript, seeking reliable, tested, and actively maintained tooling for production workloads. |
🛡️ Repository Maintenance & Health Audit (2026)
Health Score: 85/100 · Grade AYes, mermaid is actively maintained. Continuous telemetry recorded the last code commit on Oct 25, 2026 (18 days ago). Supported by 90,858 stars and 9,400 community forks, this repository holds a calculated health index of 85/100, reflecting regular maintenance (18 days ago) and high open issue volume (1,982 open).
Star History
Add Live Star History & Verified Badges to README.md
Keep your repository README looking professional and dynamic. As our continuous crawler records new stars, these official SVG badges update in real time with zero maintenance.
Renders your high-resolution star trajectory chart right inside your GitHub README or project docs.
[](https://githubrepo.cloud/repo/mermaid-js/mermaid?utm_source=readme_chart)Compact badges for your README header. Real-time stars, velocity, health audit, and rank.
[](https://githubrepo.cloud/repo/mermaid-js/mermaid?utm_source=readme_badge) [](https://githubrepo.cloud/repo/mermaid-js/mermaid?utm_source=readme_badge) [](https://githubrepo.cloud/repo/mermaid-js/mermaid?utm_source=readme_badge) [](https://githubrepo.cloud/repo/mermaid-js/mermaid?utm_source=readme_badge) [](https://githubrepo.cloud/repo/mermaid-js/mermaid?utm_source=readme_badge)Momentum
+313
STARS · LAST 30 DAYS
10
PER DAY
#30
MOST-STARRED TypeScript
| Window | 7 days | 30 days | 90 days |
|---|---|---|---|
| Stars gained | +0 | +313 | +900 |
| Per day | 1 | 10 | 10 |
| Forks gained | +0 | +75 | +470 |
mermaid gained 313 stars in the last 30 days, about 10 a day, and now has 90.9K. It is about 12 years old and has averaged roughly 7.6K stars a year. It ranks #30 among TypeScript repositories and #122 across all languages on GitHubRepo.
Trending Record
45
DAYS ON TRENDING
#92
BEST RANK
Sep 23, 2026
FIRST APPEARANCE
Active
STATUS TODAY
mermaid has maintained a continuous presence across global trending indexes, peaking at #92. Below is the 30-day activity profile:
💡 Overview
mermaid is an open-source project written in TypeScript: Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown.
Engineered for speed, consistency, and developer ease, it solves common hurdles in diagrams, diagrams-as-code, documentation. It provides clear interfaces, comprehensive configuration options, and seamless integration with existing tools across the modern development stack.
⚡ Key Features
Optimized execution pipeline written in TypeScript for predictable speed.
Zero-friction configuration with comprehensive sensible defaults out of the box.
Cross-platform runtime support across Linux, macOS, and Windows environments.
Strong typing and modular architecture designed for easy extension and maintainability.
Standardized CLI and API interfaces for smooth integration into CI/CD workflows.
Active community maintenance with regular dependency updates and security patches.
📥 Installation
$ npm install mermaid⚙ System Requirements
Platforms
- • macOS
- • Linux
- • Windows
Runtime & Dependencies
Node.js >= 18, npm, pnpm or bun
Architecture
x86_64, ARM64 (Apple Silicon & Graviton)
🧠 How It Works
mermaid coordinates its core functionality through a modular TypeScript pipeline. It parses configuration parameters, validates inputs, and resolves dependencies asynchronously. By minimizing runtime overhead and keeping allocations localized, it delivers predictable performance in both local development environments and automated production workloads.
🎯 Production Use Cases
Production System Integration
Embed mermaid into TypeScript backend services to handle core application logic.
CI/CD Automated Pipelines
Run automated validation, builds, and integration suites during deployments.
Developer Tooling & Workflows
Accelerate developer onboarding with pre-configured project utilities.
Open Source Extension
Fork and customize internal modules under the repository's open MIT license.
🚀 Getting Started
Install mermaid using your package manager: `npm install mermaid`
Initialize your project workspace or configuration file for mermaid.
Import mermaid into your codebase or invoke it directly from your terminal.
Execute your test suite or run `mermaid --help` to verify successful setup.
👍 Strengths
⚠️ Considerations
⇄ Alternatives & Direct Competitors
👥 Who Should Use This
Developers and engineering teams building with TypeScript, seeking reliable, tested, and actively maintained tooling for production workloads.
🏆 Nearby in the Rankings
mermaid-js/mermaid is currently ranked #122 by stars across every repository tracked on GitHubRepo. These are adjacent projects:
| Rank | Repository | Language | Stars | Action |
|---|---|---|---|---|
| #117 | astral-sh/uv | Rust | ★ 91.8K | Compare ↗ |
| #118 | home-assistant/core | Python | ★ 91.5K | Compare ↗ |
| #119 | django/django | Python | ★ 91.4K | Compare ↗ |
| #120 | opencv/opencv | C++ | ★ 91.4K | Compare ↗ |
| #121 | storybookjs/storybook | TypeScript | ★ 91.2K | Compare ↗ |
| #122 | mermaid-js/mermaid This Project | TypeScript | ★ 90.9K | |
| #123 | bitcoin/bitcoin | C++ | ★ 90.6K | Compare ↗ |
| #124 | gohugoio/hugo | Go | ★ 90.5K | Compare ↗ |
| #125 | koala73/worldmonitor | TypeScript | ★ 90.1K | Compare ↗ |
| #126 | gin-gonic/gin | Go | ★ 89.5K | Compare ↗ |
| #127 | syncthing/syncthing | Go | ★ 89.4K | Compare ↗ |
Frequently Asked Questions
What does mermaid do? +
Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown
Is mermaid actively maintained in 2026? +
Yes, mermaid is actively maintained. The latest code push was recorded on Oct 25, 2026 (18 days ago). It holds a calculated Maintenance Health Score of 85/100 (A rating) with 90,858 stars and 1,982 open issues.
What language is mermaid written in? +
The primary language is TypeScript. Topics include: diagrams, diagrams-as-code, documentation, flowchart, javascript.
How many stars does mermaid have? +
mermaid has 90,858 stars and 9,400 forks on GitHub.
How does mermaid rank among GitHub repositories? +
With 90,858 stars, mermaid-js/mermaid is ranked #122 globally across all repositories tracked on GitHubRepo and #30 among TypeScript projects.
What license is mermaid distributed under? +
The repository reports a MIT license. Always verify the repository LICENSE file for legal terms.
