You may have noticed things look a tad different around here these days – that is because the Faust.js team has completed migrating the previous version of the project’s documentation to a headless WordPress stack! 🎉

Previously, the project was hosted with Docusaurus – an open source project for building, deploying, and maintaining websites with markdown. It does a lot of things really well, however Faust.js empowers both developers and publishers with building headless WordPress sites, so it felt natural to have Faust.js’ documentation be supported by the framework itself, and hosted on WP Engine’s Atlas platform.

The Blueprint

The following WordPress plugins were leveraged to make this happen.

• Faust.js WordPress Plugin
• WPGraphQL
• WPGraphQL Smart Cache
• WPGraphQL Content Blocks
• Advanced Custom Fields
• WPGraphQL for Advanced Custom Fields
• WP Engine Smart Search

Menus

All of the menus on this site are now utilizing WordPress menu locations.

Content Structure

This latest iteration of the site adopts the Divio Documentation framework, structuring content into 4 distinct types.

Four custom post types were registered for each of these types:

• Tutorials
• How-To Guides
• Reference
• Explanation

These can be seen in the sidebar for each of those custom post types.

Although the repository for the current site design is not public, the team plans on providing a more detailed case study on how this new site was built in the future.

Additional Updates ✨

The team has been working on getting additional WordPress core blocks included within the @faustwp/blocks package.

As always, feel free to test out Faust.js nightly releases by using the `canary` tag.