mdn/kuma — explained in plain English
Analysis updated 2026-08-01 · repo last pushed 2022-08-26
Study the historical architecture that powered MDN Web Docs.
Reference the codebase for how large-scale developer documentation sites were built.
Explore past contributions and bug-fix workflows from the MDN community.
Understand the legacy system before migrating to or learning about its successor, Rumba.
| mdn/kuma | tencent-hunyuan/hy-world-2.0 | hoainho/img2threejs | |
|---|---|---|---|
| Stars | 1,918 | 1,911 | 1,903 |
| Language | Python | Python | Python |
| Last pushed | 2022-08-26 | — | — |
| Maintenance | Dormant | — | — |
| Setup difficulty | hard | hard | hard |
| Complexity | 4/5 | 5/5 | 4/5 |
| Audience | developer | researcher | developer |
Figures from each repo's GitHub metadata at analysis time.
This is a deprecated, complex production system that was replaced in 2022, setting it up locally is not recommended and would require non-trivial legacy infrastructure configuration.
Kuma is the software platform that powered MDN, Mozilla Developer Network, the widely-used reference site at developer.mozilla.org. If you've ever looked up how a CSS property works or what a JavaScript method does, you've likely landed on a page served by this project. It's the engine behind one of the most visited developer resources on the web. The platform was written primarily in Python and handled everything from serving documentation pages to managing the structure and navigation of MDN's vast library of web development content. The README doesn't go into much detail about the specific architecture or features, but it's clear this was a substantial production system with automated testing, code quality checks, and staged deployments before reaching the live site. The people who would have used this codebase are developers contributing to MDN itself, fixing bugs, improving performance, or adding features to the platform. Mozilla organized issues by priority, with critical bugs flagged for immediate fixes and lower-priority ones tracked for resolution within 180 days. Contributors could find beginner-friendly projects through the contribution guide and connect with the team through Mozilla's forum or chat. The most important thing to know is that Kuma is deprecated. In July 2022, it was replaced by a newer project called Rumba. This repository still exists for reference and historical context, but it's no longer the active platform running MDN. If you're looking to contribute to MDN's current infrastructure or understand how it works today, you'd want to look at the successor project instead.
Kuma was the Python-based platform that powered MDN Web Docs (developer.mozilla.org), one of the most visited developer reference sites. It is now deprecated and was replaced by a newer project called Rumba in July 2022.
Mainly Python. The stack also includes Python.
Dormant — no commits in 2+ years (last push 2022-08-26).
The license is not mentioned in the repository explanation, so usage terms are unknown.
Setup difficulty is rated hard, with roughly 1day+ to a first successful run.
Mainly developer.
This repo across BitVibe Labs
double-check against the repo, no cap.