Build optimized websites quickly, focus on your content. Part of @MetaOpenSource.
Menlo Park, CA
Based in United States
- Tweets 487
- Following 32
- Followers 7,147
- Likes 253
This was just a quick preview of Docusaurus v3
More details in the blog post:
docusaurus.io/blog/releases/…
v3.0 does not come with a huge list of features, but is an important infrastructure upgrade.
This sets the ground for a new wave of Docusaurus features we plan to implement!
2
10
3,393
Inject HTML data attributes with query-string / search params
This can be useful for various reasons
For example, you can customize CSS based on query-string params
Tip: use this to embed Docusaurus as an iframe in another website, and customize the layout
No FOUC expected!
1
2
11
7,016
Docusaurus v3 greatly improves TypeScript support
- Config files support TS
- New official base config
- Normalized TS exports
- Require TS 5.0+
1
4
476
React 18!
This comes up with all React 18 improvements
We'll soon explore how to properly support Suspense/React.lazy in Docusaurus
We also use the automatic JSX runtime, and you don't need to import React anymore
1
6
504
Unlisted content!
We had "draft: true" front matter
Now we have "unlisted: true" 🆕
This will publish your pages in production builds, but make them "secret"
Impossible to discover: noindex, search, sitemap, RSS, sidebars...
Ideal for getting final review before publication!
1
7
574
Now let's focus on a few features we particularly like.
ESM and TypeScript configs!
This new support should greatly improve the Docusaurus DX!
And it's not only for your site config, but also docs sidebars, plugins, and preset modules!
1
6
607
Seb ⚛️ ThisWeekInReact.com @sebastienlorber
MDX v1 ➡️ MDX v3 is the main challenge to adopt Docusaurus v3
Docs that compiled successfully under Docusaurus v2 might now fail to compile under Docusaurus v3
But we went the extra mile to make it less difficult for you!
1
5
696
Larger, more complex sites may require more work.
We came up with a few strategies to help you upgrade more easily:
- Prepare your site ahead of time, while staying on v2
- Set up visual regression tests to catch unexpected visual changes
docusaurus.io/blog/preparing…
2
7
1,110
Non-complex Docusaurus sites should be able to adopt v3 very easily
All you have to do is update a few dependencies and you're ready to go!
1
7
984
This is a new major version of Docusaurus, coming with new exciting features.
We respect Semantic Versioning principles: this release also includes breaking changes.
They are exhaustively documented in the v3 upgrade guide.
Release blog post: docusaurus.io/blog/releases/…
1
1
10
1,471
💥 Docusaurus v3.0 stable is available! 💥
➡️ MDX 3
➡️ React 18 / Automatic JSX runtime
➡️ ESM + TS Config
➡️ Unlisted content
➡️ TypeScript 5
➡️ Mermaid 10
➡️ Node 18
➡️ CommonMark (experimental)
🧵 Details below 👇
5
58
270
75,675
We are excited to share the Docusaurus V3.0 Release Candidate - explore what's new in this overview 🧵:
💥 Docusaurus v3 RC.1 is available!
➡️ MDX 3 🆕 🎉
➡️ React 18
➡️ TS 5
➡️ Mermaid 10
➡️ Node 18
➡️ ESM + TS Config
➡️ Unlisted docs/blog
➡️ ESLint rules
Release discussion + links: github.com/facebook/docusaur…
1
6
23
11,152
💥 Docusaurus v3 first alpha is available! 💥
Please give this pre-release a try and share feedback!
Main breaking changes:
➡️ MDX v1 => v2
➡️ React v17 => v18
🔗 github.com/facebook/docusaur…
3
10
87
14,463
💥 Docusaurus v2.4.1 is available! 💥
Little release fixing 2.4.0 bugs, notably:
🐛 Collapsibles bug when prefers-reduced-motion is turned on
🐛 Algolia indexing SkipToContent
🐛 Markdown links with [link](<link>)
🔗 github.com/facebook/docusaur…
3
19
6,655
Many other changes too!
Check the full changelog here:
docusaurus.io/changelog/2.4.…
This is likely the last 2.x minor release.
The next one should be v3.0, including MDX 2 and React 18 🤞 🙌
👋
1
4
1,845
💥 Docusaurus v2.4.0 is available! 💥
No breaking change, easy upgrade!
🆕 link/cat description
💪 npm2yarn
🌓️ ?docusaurus-theme
📊 gtag multi-IDs
💅 DX - Error messages
🇭🇺 🇳🇴 Theme translations, DOCUSAURUS_CURRENT_LOCALE
docusaurus.io/blog/releases/…
🧵 Sneak peek below 👇
2
6
32
9,514
💥 Docusaurus v2.3.1 is available! 💥
Little release fixing some 2.3.0 bugs, notably:
🐛 Tabs scroll position restoration, single tab items
🐛 Fix preset rejecting Google Tag Manager config
🐛 Fix infinite loop console error when switching theme
🔗 github.com/facebook/docusaur…
8
23
6,281
🧵 Many little improvements to UX, DX, a11y, translations...
Check the changelog for a more exhaustive list!
docusaurus.io/changelog/2.3.…
The Docusaurus team is working on the v3 release, which should include MDX 2 + React 18
👋
6
1,009