Quickstart your NodeBB theme development

[psychobunny]

Updated https://github.com/NodeBB/nodebb-theme-quickstart for the latest version of NodeBB.

Copy / fork that into your node_modules/nodebb-theme-yourtheme and then follow the instructions.

There are separate branches depending on if you'd like to base your theme as a child theme of Persona, Lavender, or Vanilla. Any templates created in a templates folder in the root directory will overwrite the template of its parent theme.

[Nicolas]

if you'd like to base your theme as a child theme of Persona

When you see such output in console, it overwhelms you...
My theme isn't a child theme, but in order to upgrade forum, you have to upgrade theme also, and incorporate changes from Persona.

Your branch is behind 'origin/master' by 240 commits, and can be fast-forwarded.

[glassdimly]

I created a tutorial for forking themes, versioning them, and getting them up on Heroku: http://glassdimly.com/blog/tech/nodebb-yarn-nodejs-javascript-yalc/how-fork-and-deploy-nodebb-custom-theme-heroku

[julian]

@glassdimly nice! Thanks for sharing

[jiqing]

This post is deleted!

[omega]

I used this to fork Harmony, but initially it would not load correctly, error message in ACP > Themes, missing templates.

I solved that by copying in the templates folder from the main Harmony theme into the new theme.

I forked persona a few years back but forget how I did that tbh (it wasn't a GitHub venture, I probably just duplicated the persona theme folder and renamed things, without issue iirc)

So what did I do wrong?

[julian]

@omega what was the error?

[nscr]

It looks like the discussion content in this topics has become outdated, so should I refer to the docs site directly instead?

I want to customize the default home page and post detail page, which involves layout and style customization, so, am I correct to develop a new theme for this?