Gutenberg Hub Launches a Block-Based WordPress Theme Directory

In the dawn of the block theme era, the WordPress theme directory could use a reimagining. That is what Munir Kamal set out to do before WordPress 5.9 launches later this month. He announced an alternative theme directory on the Gutenberg Hub website earlier today. It lists all the block themes that are officially hosted on WordPress.org.

Screenshot of the Gutenberg Hub theme directory, which lists theme screenshots in a three-column grid.
Gutenberg Hub’s theme directory.

The interface and experience are similar to the official theme directory and for a good reason. Kamal is pushing for changes on WordPress.org.

“I noticed the lack of info the official theme directory provides,” he said. “I want to initiate a discussion around this to fix it, and thus created this as a concept/experiment. Now that it’s an era of the new generation of WP themes (Block Themes), the themes directory needs to be reimagined. Block themes are all about colors, typography, block styles, patterns, and templates. As a WP user, I wish to see all that info related to a theme when I explore themes in the directory. I need to choose without installing and testing multiple themes.”

Single theme pages in this reimagined directory include more data than the official directory. Instead of merely a screenshot and description, each page displays the theme’s color palette, provides typography examples and info, and previews several content blocks.

Screenshot of the Octane WordPress theme page on Gutenberg Hub. Includes theme description, screenshot, colors, and typography sections.
Octane theme page.

One thing that makes modern themes unique is their included theme.json file. This file allows theme authors to register settings and add styles that work in both the editor and the front-end. This level of standardization did not exist until WordPress 5.8 rolled around last year.

It also allows developers like Kamal to build new tools on top of it. When nearly all the data related to a theme is in a standard format, it is easy to pull out and experiment with it.

For example, because there is a specific key in the theme.json file for colors, anyone can grab and display them via code. Gutenberg Hub’s directory displays these as a palette alongside each theme. Users can even click to copy them.

Homepage of the Gutenberg Hub theme directory. Mouse cursor is hovering a specific color from a theme's palette. It's hex code appears in a tooltip.
Copying a theme color.

This would have been practically impossible in the past because WordPress did not have a way for themes to define something as simple as a color palette.

The directory also auto-generates social images for each of the themes. The following for Mebae and Pacer both show their description, fonts, colors, and screenshot.

For years, WordPress.org theme previews have been plagued by sub-par demo system. Today, the live demo can show starter content if a theme provides it. However, there is no current FSE support for the feature. Gutenberg Hub displays the same live preview as shown in the official directory.

Kamal has partially addressed this issue by adding a “Content” button. Clicking it allows users to see dozens of blocks in action.

Preview/demo of the Tove theme with faux content. The content displays 1-6 headers, a horizontal rule, and paragraph.
Tove theme content preview.

This provides a general overview of what the theme looks like, but the preview experience is still lacking. A handful of featured images would add some visual oomph to the home/blog and archive pages.

Kamal has plans to incorporate theme templates and patterns into the preview in the future. Those additions would make theme demos more useful.

He does not plan on stopping there. “Other plans include providing a super useful search and filter functionality that makes it easier to trim down the result to the closest needs of a user,” he said. “And maybe a comparison tool that a user can use to compare two themes side-by-side with practical elements to decide between the two, rather than reviews, downloads, etc.”

The work Kamal has put in so far looks promising. There is still much that could be improved if we had an entire community effort behind this. With the block theming feature launching with WordPress 5.9, there is no reason to stick to the old theme preview system when so much more is possible.


If I had one extra wish for Gutenberg Hub or WordPress.org, it would be for all child themes to be listed on their parent theme’s page. But, I will take this redesigned directory first.

8

8 responses to “Gutenberg Hub Launches a Block-Based WordPress Theme Directory”

  1. Josh Pollock says:

    This looks really neat. Would be cool if you could add your own theme.json to the previews.

    Report

    • Munir Kamal says:

      It Would be cool if you could add your own theme.json to the previews.

      Hey Josh, thanks for the feedback. Do you mean to enable it to preview any custom theme (theme.json)?

      Report

  2. Jonas says:

    In any case, it’s a fresh, modern design. That would certainly do the theme directory very well.

    Report

  3. Munir Kamal says:

    Thank you, Justin, for featuring it at WPTavern. This is built using NextJS and is a fully automated directory that fetches and adds newly published themes from WP org.

    Report

  4. Herb Miller says:

    If I had one extra wish for Gutenberg Hub or WordPress.org, it would be for all child themes to be listed on their parent theme’s page.

    That’s a good idea. I’ve prototyped it in my effort to catalogue FSE themes.

    https://blocks.wp-a2z.org/oik-themes/blockbase/

    Report

  5. This looks cool but how is it different from filtering the theme directory on the .org site using the fse filter or https://wordpress.org/themes/tags/full-site-editing/ ?

    I have bookmarked the gutenberghub.com site.

    It appears also we are still challenged by the difference between Gutenberg (plugin) vs the released WordPress Block Editor in terms of branding.

    All in good time I guess. ;-)

    Report

    • There are only 30 or so block themes right now. In the future, there will be 1,000s, so a simple tag won’t cut it for filtering. Kamal has not implemented his own filtering system yet either.

      This custom directory has a lot of other features that would be useful for showing more about a theme, such as its full color palette and typography options, without installing it. You can also view many of the blocks in action. The proposal is about bringing these features over to the .ORG system.

      As far as branding, I think he’s stuck with the Gutenberg Hub name. He created the site at least a couple of years ago. :)

      Report

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Newsletter

Subscribe Via Email

Enter your email address to subscribe to this blog and receive notifications of new posts by email.

%d bloggers like this: