Is there a naming convention for theme component projects, so that they’re easily recognizable as such? When seeing the folder on disk, or the repo on GitHub or the project on GitLab or another code forge, it’d be useful to be able to see at one glance that this is to be used with Discourse it’s …

We don’t enforce any naming conventions… the Discourse team will often prefix themes and components with discourse- but it’s not universal. Beyond the directory name, hopefully the readme will include a little context that it’s for Discourse… otherwise themes and theme-components always have an abo…

I use discourse-tc- to signify a theme component because it’s good practice and handy to distinguish those from themes and plugins.

[image] merefield: because it’s good practice and handy to distinguish those from themes and plugins. I like that, because it’s short-ish, yet informative. What naming convention (if any) do you use for themes and plugins?

Same here discourse-foo for plugins discourse-theme-foo for full themes discourse-tc-foo for theme components

Is there a naming convention for theme component projects?

Development

RGJ (Richard - Communiteq) March 16, 2026, 10:40pm 5

Same here

discourse-foo for plugins
discourse-theme-foo for full themes
discourse-tc-foo for theme components

Topic		Replies	Views
"theme-component" should be a subcategory instead of a tag Site feedback	16	1595	July 19, 2022
Developing Discourse Themes & Theme Components Developer Guides tutorial , reference , theme-guides	15	107121	March 18, 2025
Beginner's guide to using Discourse Themes Site Management reference , customization	11	83572	March 26, 2025
When to use a plugin vs theme component? Development css	12	715	March 1, 2024
Why isn't the checklist plugin a Theme Component? Development checklist	4	98	September 4, 2025

Is there a naming convention for theme component projects?

Related topics