Announcing Frontity v1 Release Candidate + New Documentation

Frontity v1 Release Candidate shipped

We are really happy to announce that today we shipped the release candidate for Frontity 1.0!

This release brings many improvements and bug fixes for issues in Frontity's beta release, stabilizes the APIs and paves the way for the version 1.0, expected on June 20.

Frontity is an open source framework that allows you to easily build a React frontend for a headless or decoupled WordPress site. Check out the introductory post here.

Improvements

• Added code-splitting example in mars-theme list.
• Added 404 page in mars-theme.
• Added pagination to mars-theme lists.
• State from packages is now cloned on each request.
• Packages are now allowed to export a function that returns the config.
• Added menu to mars-theme.
• Added prefetching examples to mars-theme.
• Added featured media component in mars-theme.
• Added support for images in Webpack.
• Added support for author lists in mars-theme.
• Added loading components in mars-theme.
• Added support for WP align classes in mars-theme.
• Expose utils to get path & page from a link and viceversa in source libraries.
• Expose util to normalize links in source libraries.
• Added autoFetch featured in tiny-router to automatically fetch data on each actions.router.set.

Bug fixes

• Fixed bug with some post permalink configurations.
• Fixed bug with publicPath final slash in production mode scripts.
• Use compat mode in Babel.
• Support for React hooks in connected components.
• Added fixes to improve accessibility score in LightHouse reports.
• Improved TypeScript support of connected components.
• Source now removes the domain from links before saving them in the state.
• Added custom scheduler to better deal with async events in connected components.
• Fixed a bug in taxonomy urls containing searches (?s=...).

Breaking changes

• state.source.data() is now state.source.get().
• The three main APIs devs need to learn (actions.router.set, actions.source.fetch & state.source.get) now only accept a string.
• state.router.path is now state.router.link.
• state.router.page is gone, use state.router.link instead.
• state.source.apiUrl is now state.source.api.
• Entry-points now default to index.js if client.js or server.js are not found.
• Default mode is now "default" instead of "html" and doesn't need a folder.
• Lists now have a data entry for each page instead of having all pages in the same data entry.
• state.frontity.initial is now state.frontity.initialLink and it's a string (like state.router.link).

No breaking changes are planned from now on.

New and improved documentation

These last few weeks, we have mostly focused our resources on getting the release candidate ready. However, we spent some time on improving the documentation too. One of the most important guides that we recently published is the Learning Frontity docs.

The Learning Frontity docs explain all the core concepts around the framework (one by one) to help you understand not only how to get started with Frontity but also how it works. Beside this, we added other new guides and this Deployment section.

Despite these improvements, we know that the documentation is still way smaller than what is needed to understand the concepts and APIs of Frontity and we would like to apologize for that.

Before releasing Frontity 1.0, we will swift more resources to the docs to try to get them up to the task as soon as possible.

In the meantime, please feel free to open a new topic in the community forum to suggest improvements, fix mistakes or help us fill in any gaps in the documentation.

Help test the release candidate

Obviously, the final 1.0 release is our top priority. We expect it to be launched the 20th of June if everything goes as planned.

As you begin to test the release candidate, please report any bugs you find so they can be fixed. For those who have already tested the beta version, we recommend you start over and create a new Frontity project from scratch.

If you have any questions or feedback, please feel free to share it in the community forum. Your input and help is highly appreciated.

For other ways to get involved with Frontity, please take a look at this guide.

Thank you!

Last but not least, big thanks to all the folks who tested Frontity's beta version, provided us with feedback, asked questions, and helped spread the word about Frontity. And specially to those who have actively contributed:

• Marika Könönen for writing this guide on How to Add a Featured Image to the Post Component in Frontity.
• Imran Sayed for making an introduction video of Frontity Framework.
• Smit Patadiya for creating a guide on how to add support for comments.

Thank you for your support and time!

We can’t wait to hear what you think about this release!

Originally published at frontity.org/blog.