Why am I finding Discourse so difficult to customize?

[bloomexperiment (Tracey)]

@P_O

Now if I add another component for example ‘Discourse Topic Cards’ and then go back to the custom css file, apply the changes, click save and then refresh the page, the custom css does not apply.

@P_O

If I want to edit the ‘Discourse Topic Cards’ templates I have to ssh into the discourse docker and edit what to make changes?

If you want to add changes on top of the the Discourse Topic Cards theme component, you can do this:

1. Install Discourse Topic Cards and add it to your active theme
2. Make a new theme component
3. Add the new theme component to the active theme too

You don’t have to ssh into the server or change anything in the source code, or fork the repo.

For an example, here is what I did to make some changes to Discourse Topic Cards for the theme Minima:

@bloomexperiment

Instructions

1. Install Discourse Minima
2. Install Discourse Topic Cards and add as a theme component to Discourse Minima
3. Install this theme component and add as a theme component to Discourse Minima

This way, you still get new updates from the theme, and all the theme components are organised and separated (so you can easily disable/enable for debugging)

But yes I do think this process could be explained a bit better for admins.