Docusaurus has made great progress in 2021! We've seen a lot of traction and just crossed 30k stars on GitHub!
We've reached full feature parity with v1 after the release of internationalization, announced our first beta, and welcomed significantly more users this year.
The official v2 release is just around the corner! Follow the roadmap issue for any latest news.
Highlights
Let's begin by going over a few highlights this year. Remember the todo-list from half a year ago? Time to take it out again and see how far we've come!
- Internationalization: officially released four months after its initial landing in late 2020. Seen great success in many projects
- Autogenerated sidebars: no need to maintain a big
sidebars.js
anymore - Webpack 5: significantly improved build performance
- Trailing slash config: seamless integration with any content hosting provider
- Redesigned mobile navigation: mobile users now enjoy all navigation features as on desktop
- UI improvements: more accessible quotes, better admonitions, back-to-top button...
- Blog multi-authors: credit all the amazing contributors that collaborated on one blog post!
- More blog features: archive page, structured data for SEO, full post content in feeds – empowering you to ship a fully-featured blog in no time
- Asset collocation: no need for a bloated static folder anymore: colocate your images with Markdown files
- Sidebar category index pages: category labels can now be associated with pages, enabling better doc organization
Our codebase has been polished over time as well. We have improved test coverage, migrated all packages to TypeScript, and reduced our published bundle size by a maximum of 60%!
Trends
npm
Docusaurus v2 continues to grow steadily. V2 installation is now 8 times more than v1. In terms of weekly downloads, we have witnessed another three-fold increase (+209.4%), growing from 28,066 in early January to a peak of 86,846 in mid-December.
(Ah, the classic Christmas dip...)
We released 18 versions, going from 2.0.0-alpha.71
to 2.0.0-beta.14
. That's one release every 20 days!
GitHub
- Stars: 20,460 → 29,679 (+45.1% y/y). And, just before this blog post is published, we have reached 30k stars!
- Total contributors: 512 → 773 (+51.0% y/y)
- Dependents: 5,039 → 14,579 (+189.3% y/y) for v2, and 6,311 → 7,581 (+20.1% y/y) for v1
- Commits: 1,187 commits in the past year, averaging 23 commits every week
- Issues: 619 issues opened, 505 of them eventually resolved
- A new core team member (yep, that's me 😝)
Our star trend is also very positive. Compared to similar projects, we are growing at a faster rate:
With an 8.4k increase in stars, we are ranked number 3 in this year's JavaScript rising stars of static site generators, preceded only by Next.js and Astro.
Featured adoptions
Our showcase has welcomed a few new "favorite" sites that showcase the true potential of Docusaurus 2's pluggable architecture.
The creativity of Docusaurus users is beyond our imagination 🤩 We look forward to more and more adopters leveraging the content features of Docusaurus while exploring original theme designs! If your site uses Docusaurus, we would love to have it in our showcase.