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	15	1680	July 18, 2022
Developing Discourse Themes & Theme Components Developer Guides reference , tutorial , theme-guides	14	107863	March 18, 2025
When to use a plugin vs theme component? Development css	12	769	March 1, 2024
Beginner's guide to using Discourse Themes Site Management reference , customization	12	84654	July 9, 2026
Why isn't the checklist plugin a Theme Component? Development checklist	4	135	September 4, 2025

Is there a naming convention for theme component projects?

Related topics