←
Docusaurus487 posts
Docusaurus avatar

Docusaurus

@docusaurus

Build optimized websites quickly, focus on your content. Part of @MetaOpenSource.

◷ Joined August 2017▧ 125 Photos and videos
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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!

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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!

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

Docusaurus v3 greatly improves TypeScript support - Config files support TS - New official base config - Normalized TS exports - Require TS 5.0+

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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!

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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!

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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!

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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…

Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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!

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

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/…

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·31 Oct 2023

💥 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 👇

Post attachment
Docusaurus avatar
Docusaurus@docusaurus·15 Jun 2023

💥 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…