A repository of Claude Code skills for building Discourse themes and block components: https://github.com/discourse/discourse-theme-skills :toolbox: What’s included Theme Authoring Skill — covers a comprehensive scope of building a Discourse theme: scaffolding with the discourse_theme CLI, SCSS ar…

Will there be a dedicated Blocks topic or is that this? If it’s the latter, maybe some code snippets could help? Or is what is in the plugin-api.gjs file the current docs? Thanks.

[image] NateDhaliwal: Will there be a dedicated Blocks topic or is that this? There’ll still be documentation that covers the full Blocks API, including implementation in core and plugins. For theming with Blocks, the SKILL.md should already touch on all relevant aspects. It’s compact and ver…

Having some actual fun with this :winking_face_with_tongue: … As other AI design tools it’s really performant for quickly prototyping ideas that would have been too costly to sketch out manually. Asked for a very brutalist style editorial homepage, with highly unconventional content featured from t…

[image] manuel: And more fun when it’s all moving :carp_streamer: Theme Creator [image] flushy

Finally!!! Will try it asap to update my experimental theme components :smiley: [Elmo Surrounded by Intense Fire]

This is great work and very creative. If we fork and build off this theme are there considerations for the parent not staying updated with Discourse over time? Trying to think how this should be approached. Thanks for the resources!

Thanks @BrianC ! On the parent staying updated: the skills track Discourse’s theme and Blocks APIs, so as long as we actively use them, they will be kept in sync as the APIs evolve. The example theme is more of a snapshot to demonstrate patterns. If you fork it, you own your fork. But you can refer …

I’m just starting to mess around with this (without agentic coding). I get the impression that it wouldn’t take too much to convert this into a Theme Component which controls just the Homepage of a site - for example, one already using the Horizon Theme. Would that be stupid? Also, I’ve noticed a …

Thanks for giving it a try @nathank ! It’s still considered experimental and we will make changes to the API, so I wouldn’t build a homepage-builder-type theme component on top of it for now. The demo blocks are just basic examples. We also have some API changes coming up that will improve how we ca…

Finally I took the step and started to play a little with this. Thank you very much for sharing it. I wonder how possible could be to generate a custom block that displays the user’s avatar and name (which I’ve already achieved) along with their topic and posts count, likes, cheer points, and somet…

Skills for authoring themes and blocks

Development

nickdb (Nick) August 31, 2026, 3:54pm 23

I have managed to plagiarise some of the meta look and feel with blocks. Works well and looks great in initial preview.

What is the timeline for something production worthy?

Topic		Replies	Views
Designer's Guide to getting started with themes in Discourse Developer Guides tutorial , theme-guides	9	12531	April 8, 2024
Creating a 'Blocks' API for injecting content Projects	0	33	August 27, 2026
Rebuilding the Meta Branded theme: New icons, a custom homepage, and a first look at the Blocks API Site feedback meta-redesign-2026	27	1311	August 14, 2026
Canvas Theme Template Theme	20	6002	February 25, 2026
Theme-Component v Plugin: What's the difference Development	22	5937	June 9, 2020

Skills for authoring themes and blocks

Related topics