Docusaurus
p/docusaurus
Easy to maintain open source documentation websites
Sebastien Lorber
Docusaurus 2.0 โ€” Build great docs websites, focus on your content - by Meta
Featured
152
โ€ข
Docusaurus helps you ship a top-notch documentation site in no time!
 
Focus on your content: just write Markdown files!
Put your site online in 5 minutes, then customize it.
 
Full-featured: plugins, themes, search, blog, versioning, i18n, React...
Replies
Max Lynch
Huge fans of Docusaurus over at Ionic. We've adopted it for all of our docs moving forward. It replaces a ton of custom work we've had to build and maintain over the years and now all our docs are fast and easy to contribute to.
Sebastien Lorber
@maxlynch thanks a lot Max. Really happy to see your Ionic site, it's a been a good example I use to demonstrate the value of Docusaurus
Johan Steneros
Love Docusarus. I'm not a developer and I got our Knowledge Base setup and going in no time.
Sebastien Lorber
@jsteneros awesome, thanks for the feedback ;)
Ashley Porciuncula
This is awesome! Congratulations on the launch!
Sebastien Lorber
@ashleymarinep thanks ๐Ÿ’–
peter hatch
icon lust!
David Leuliette
It's always hard to have good-looking and up-to-date documentation. Thanks to all team for maintaining this project! @sebastienlorber one thing that drives me crazy: no URL for search Example: 1. https://twitter.com/search?q=seb... 2. search done 1. Go https://docs.nativebase.io/ 2. hit command + k 3. type your search 4. get results Is there a way to access the search feature only via an URL + query params?
Sebastien Lorber
@flexbox Thanks David :) As Yangshun answered we have a dedicated search page. Would it be useful to have a way to display the search modal on app open too?
David Leuliette
Thanks @yangshun ๐Ÿ™Œ That's what I was looking for @sebastienlorber I think as a small link it can help as an alternative way to search โ€”aka using alfred or other launchers IF the search is available I don't know if it's a setting to optin / opout Because It's available on https://reactnative.dev/search?q... and not https://docs.nativebase.io/searc...
Sebastien Lorber
@flexbox the NativeBase doc doesn't have a search page, because it's using Next.js instead of Docusaurus :p Our official Algolia DocSearch plugin has a search page by default, and some community local search plugins too
Sebastien Lorber
@flexbox me too ๐Ÿ˜„ as Docusaurus is quite customizable I always wonder and have to inspect the DOM head to be sure
Pierre-Gilles
I've been using Docusaurus for an open-source project I'm maintaining ( Gladys Assistant: https://gladysassistant.com/) since the alpha of this v2 and it saved me tons of time. Docusaurus is an amazing piece of tech, well maintained and easy to use!
Sebastien Lorber
@pierregillesl thanks for being an early adopter of our i18n support ;)
Swyx
has been a very very long journey, but Docusaurus has rightfully earned its place as the default docs engine for most dev focused companies and startups and OSS libraries. huge congrats to you for shepherding this through AND consistently updating users through the process so that we did not lose confidence. Congrats!
Sebastien Lorber
@swyx Thanks a lot for the feedback โค๏ธ๏ธ
Kruno Golubiฤ‡
We use Docusaurus for our documentation. It is powerful and easy to use. It can be extended with various plugins. I love the fact that you can version your docs and that you can use both Markdown and HTML to write the content. If you know React then you'll have a bunch of features at your fingertips.
Sebastien Lorber
@kgolubic thanks for sharing your experience :) Yes we try to make Docusaurus easy to get started, but also to scale with your usage with more advanced features
deepu
congrats
Maรซl Nison
I've been using Docusaurus for a couple of OSS library websites and it's been an amazing tool. What's extra nice is that while developer tools have historically been a little, say, barebone, visually speaking, Docusaurus' default design is both appealing and flexible. Perfect to build many small documentation sites.
Sebastien Lorber
@arcanis Thanks a lot Mael :) It should also work for much larger doc sites with thousands of pages, see for example https://xsoar.pan.dev/
Yangshun Tay
Hi Product Hunt! I was the lead maintainer of Docusaurus from 2018-2020. The first version of Docusaurus was great, it enabled us to build documentation websites very easily by handling everything besides the content for us. However, as the web advanced, users started to ask for more features: adding interactivity, theming, using their React components, etc on the page. Docusaurus 1 was built as a monolith and was fundamentally creating websites with a different architecture. To address the shortcomings of Docusaurus 1, in 2018, we started rearchitecting Docusaurus 2 from the ground up and split V2 into a few core modules: - Infima: a CSS framework written from scratch that helps people build content-driven websites quickly (https://infima.dev/) - Docusaurus core: allows for plugins, themes and page generation - Docusaurus classic preset: a collection of plugins and themes which reimplemented the functionality of Docusaurus 1 for a "works out-of-the-box" experience! It's very extensible and themeable. It has been a multi-year effort and we're glad we're finally shipping it. Check it out!
Christophe Chaudier
Docusorus it easy to use. We use Docusaurus for the website of our SaaS : https://froggit.fr/
Sebastien Lorber
@c_chaudier really happy to see it become popular in France, in part thanks to you ;)
Sebastien Lorber
๐Ÿ‘‹ Hey Product Hunt! I'm Sรฉbastien, the current lead maintainer of Docusaurus โšก๏ธ Docusaurus is a developer tool to build awesome documentation websites! ๐Ÿข Docusaurus comes from Meta Open Source (Facebook), and is one of our most successful open source project (๐Ÿ“ˆ growing fast, strong adoption, 35k+ GitHub stars). Free, MIT license. ๐Ÿง‘โ€๐Ÿ’ป Technically, it's a React + Node.js static site generator, full-featured with content-centric features (docs, blog, pages, versioning, i18n, a11y, SEO...) that allows you to get started fast and focus on your content: just write Markdown files! ๐ŸŽจ But it also scales with your usage and is very flexible (plugins, theming...): it is really possible to build great-looking sites that do not look the same ๐Ÿ”ฅ It also uses MDX: this allows to use React inside Markdown files to make your doc interactive. We believe you don't need to be Stripe and have a full engineering team working on your doc to make it a top-notch experience. A good example is Courier documentation integrating a custom interactive OpenAPI client. ๐Ÿ’ก Docusaurus Story: Meta has a lot of internal/external project. Before Docusaurus, it was a pain to create a new documentation website for each one. We started to copy a Jekill template, but it wasn't really maintainable. Hence we created Docusaurus in 2017. v1 was a success, but was a bit limited in terms of theming, didn't have a plugin system, and we didn't really leverage React, so we started working on a v2 starting 2018. ๐Ÿฅณ๏ธ Docusaurus v2.0 is now officially released, after a very long alpha/beta phase (4 years ๐Ÿ˜…). Please read our Announcing Docusaurus 2.0 post! ๐Ÿ“ˆ The community adopted Docusaurus v2 pre-releases even before its launch! In practice Docusaurus 2 has been relatively stable for a while already, but we weren't ready to respect Semantic Versioning. We have a site showcase with almost 300 v2 sites, and it's only the tip of the iceberg. We've heard about strong internal usage at companies such as LinkedIn, Microsoft, Shopify, SAP and many more... The community quicky adopted Docusaurus v2 pre-releases before it's even launched. A sample of great Docusaurus v2 sites: - ๐Ÿ”— Figma - ๐Ÿ”— Snapchat - ๐Ÿ”— Supabase - ๐Ÿ”— React-Native - ๐Ÿ”— Ionic - ๐Ÿ”— StackBlitz - ๐Ÿ”— Redis - ๐Ÿ”— Algolia DocSearch - ๐Ÿ”— Tauri - ๐Ÿ”— Hasura - ๐Ÿ”— Lacework - ๐Ÿ”— Iota - ๐Ÿ”— Solana - ๐Ÿ”— Cardano โŒ I pitched Docusaurus, now it's also worth explaining its limits. Docusaurus remains a developer tool, requiring basic Node.js knowledge, and you'll also need to know React if you want to build a greatly customized site. The Markdown files are usually stored in Git. If you are not a technical person and ready to use Node.js + Git (or a Git-based CMS), Docusaurus may not be good for you. We plan to improve the authoring experience later, and work on CMS integrations. Docusaurus is not like a Wiki/Confluence where you have a built-in UI to submit edits. โ“ Let me know if you have any question, I'll be happy to answer the pros and cons of Docusaurus in a fair way so that you understand the tradeoffs of Docusaurus. Some comparable tools include: VuePress, VitePress, GitBook, MkDocs, Dokz, Docsify, Gatsby, Nextra... ๐ŸŽž Little video demo to show what we mean by "focus on your content": just create a Markdown file and that's it. Note we also have powerful Markdown front matter to customize various things like the position of a doc in the sidebar, the sidebar label, the pagination label, SEO metadata, tags...
Edit: Lee Robinson did a much better video than mine here. In 60 seconds of video you can understand the value of Docusaurus: https://twitter.com/leeerob/stat...
Seb Bryers
@sebastienlorber super clean work! I wondered how Figma's docs were put together, they use the product super well.
Sebastien Lorber
@srbryers Thanks Actually have no idea, discovered their site recently by chance while looking for a Figma API doc . What I can see by inspecting DOM + network request is that they have 2 separate Docusaurus sites for plugins and widgets: - https://www.figma.com/widget-docs/ - https://www.figma.com/plugin-docs/ Navigating from plugins to widgets lead to a full page reload (no SPA navigation) Probably sharing a custom theme or preset between the 2 sites The rest of their docs are not based on Docusaurus. They just made all the things look consistent, but you'll notice some little differences in the layout.
Meenank Minnu
Ahh finally a product that removes the dread out of the documentation process. We all hate paperwork and this name makes me immediately want to sign up. I just have one question to the @sebastienlorber, can we use Docusaurus for courses or wiki site creation?
Sebastien Lorber
@superminnu yes you can use Docuaurus courses and wikis for sure, but I don't see that use-case too often: Some similar sites comparable to what you might be looking for? https://www.techinterviewhandboo... https://react-typescript-cheatsh... Docusaurus remains quite dev centric, using Git and Markdown so it's not really a wiki with a wysiwig editor but more a tool to build a knowledge base and present it in a nice way.
Meenank Minnu
@sebastienlorber I personally find my usecase working truly great for docusaurus. Will share with you what I build next.
Amin
Is it just me, or is the phrase "by meta" an instant turn-off as it reduces the credibility?
Sebastien Lorber
@footer not just you, but I think it's unfair to bash everything coming from Meta. It's free, open source, MIT license and I am not even a Meta employee myself. It's quite unrelated to Facebook/Instagram and just a good tool that the community can use.
ลukasz Chludzinski
I've been using Docusaurus for 3 years now, for all my documenting needs - large and small. Dosucaurus is extremely useful and easy to work with. Great work team and especially @sebastienlorber
Sebastien Lorber
@lukaszchopin yesss, thanks a lot ๐Ÿค—๐Ÿ’–
Hung Nguyen
I've been using Docusaurus pre-release for production sites for a while and it works seamlessly. It's an opinionated solution to document your products and publish blog posts/ updates. If you want to customize it for your own needs, simply use the Swizzling feature, which is super flexible. I hope to see Docusaurus continue to grow to help more people bootstrapping a website effortlessly
Sebastien Lorber
@hellothere123 thanks for sharing your experience ;)
Alex DeBrie
I've made a few documentation-like sites over the years, and the one I made a few months ago with Docusaurus 2.0 was by far the one I'm happiest with. Super easy to get started, a very clean look, and easy to customize without being a frontend wizard. I don't have a horse in this race other than I want to see better documentation out in the wild. I've recommend this to a few people now, and I wouldn't choose anything else.
Sebastien Lorber
@alex_debrie thanks a lot for your comment ;) glad you liked it
This looks really cool. Well done. Might use it for a future project
Sebastien Lorber
@florin_biro thanks. Please show us your site once it's online ๐Ÿ˜Š
Eric Simons
Best docs generator I've ever used! Highly recommend
Sebastien Lorber
@ericsimons40 thanks a lot StackBlitz โค๏ธ๏ธ Docusaurus: https://developer.stackblitz.com/ And Docusaurus โค๏ธ๏ธ StackBlitz: https://docusaurus.new/stackblitz