Skip to content

NodeBB v3 and Harmony Theme

Discussion
  • And now, something of a quandary. Given the imminent (well, Q2 2023) release of NodeBB v3 and the timed release of the Harmony theme that will ship with it - considering the hundreds of hours in terms of development I’ve invested in this new engine, do I

    I’m also looking for indications as to how many will jump onto the v3 train when it arrives - for example, I fully expect there to be a transition period, but is there any point in keeping the v2 theming engine afloat when v3 will render support for it obsolete at some point in future? I know v2 will be around for some time, but it can’t be infinite for obvious reasons - at some point, NodeBB will want to pull the plug on this as it will be considered legacy.

    Very interested in thoughts…

  • I’m also interested to understand migration timelines if you have (or have even thought about) them. What would be the amount of work and effort involved for you own sites? I expect a torrent of new CSS at the very least…

  • phenomlabundefined phenomlab referenced this topic on
  • For me, you have to abandon V2 or else you have to choose to stay on something that will be obsolete after a while or that will stabilize without major updates. Why not ? It’s a choice.

    For my part, I would like to upgrade to V3 either with persona on bootstrap5 which won’t change a lot in terms of design or switch to the Harmony theme which I find very beautiful and modern at first sight. I must see the theme in live and test it before take a decision.

    On the other hand, I already know that a lot of users will be disconcerted or even very surprised or will stop coming to the forum.
    There too it is a choice.

    – Personna or Harmony in V3, in both cases, it’s going to be a crazy job (less for Personna):

    • First of all, we will of course have to be sure that all the plugins we use work correctly with this version (or wait until they do, which would leave time to worry about other things)

    • That all the JavaScript and functions developed with Mark @phenomlab work like the Theme Switcher, the footerbar, the welcome message with change of the logo etc.) I will surely have to modify the code of all these functionalities according to Personna/Harmony/Bootsrap5 and I know @phenomlab will be there to help me. It is especially him who has the knowledge of the JS. I prefer CSS even though I’m not stupid

    • You will then have to code from scratch (if Harmony) or adapt (persona) all the CSS themes already present with the Switcher theme. In my opinion the ideal will be to start from scratch because a good part of the CSS classes will no longer exist and there will be new ones

    –> Anyway I would wait at least for the first stable release before coding anything in CSS or functionality.
    –> So by the time all the plugin devs update, harmony is fine-tuned and everything said above is coded correctly, it won’t be before the end of 2023 in my opinion that it will be in production without bugs.
    –> Of course all this will have to be done on a development VM. I just installed mine with nodeBB 3.0.0 alpha 3

    I expect a lot on the improvement of the chat system or the global chat plugin.
    It is a very appreciated function and not badly used on our forum (we like to discuss without going through other platforms)

  • @DownPW this is a great response, and it sounds very much like you’ve thought things though. I agree - it makes more sense to cease development of the v2 theming engine, and focus on v3.

    However, it’s worth noting that v3 (particularly with Harmony if I understood correctly) will also have the capability of switching themes - or at least, colour swatches, which is where I was originally heading with v2. It will be interesting to see how this materialises over time, given that the version in Persona seems to be something of an afterthought that doesn’t work very well either.

    The new Swatch capabilities skates for inclusion into Harmony may well render the custom theme switcher we developed obsolete if it offers a hook meaning it can be extended.

    From my perspective, all of my custom scripts will be updated to work with, and be fully supported in, v3. This is inclusive of the theme switcher (if applicable) and the custom footer etc.

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    his is a great response, and it sounds very much like you’ve thought things though. I agree - it makes more sense to cease development of the v2 theming engine, and focus on v3.
    However, it’s worth noting that v3 (particularly with Harmony if I understood correctly) will also have the capability of switching themes - or at least, colour swatches, which is where I was originally heading with v2. It will be interesting to see how this materialises over time, given that the version in Persona seems to be something of an afterthought that doesn’t work very well either.
    The new Swatch capabilities skates for inclusion into Harmony may well render the custom theme switcher we developed obsolete if it offers a hook meaning it can be extended.
    From my perspective, all of my custom scripts will be updated to work with, and be fully supported in, v3. This is inclusive of the theme switcher (if applicable) and the custom footer etc.

    Personally, if the new swatch on harmony theme is just a color change, that wouldn’t suit me at all. Switching with CSS is just huge and much more functional
    We should also offer integration officially to NodeBB. that would be awesome 😉

  • @DownPW I’m running Harmony now on https://sudonix.dev 🙂 There is no swatch functionality from what I can see, so the code we developed is still up for the taking.

  • @DownPW I missed this - there is a skin switcher

    9f54e2bc-e717-4cae-a642-49c3d41d5238-image.png

  • @phenomlab Yep but that don’t work with css File ?

    I had tried in the past to create a theme with the official nodebb doc and I never succeeded

  • @DownPW I’ll need to look at the structure, but I can’t see why not.

  • @phenomlab

    I also see another problem with this selector : he display all the default themes.
    We should be able to remove all those present by default and display only those we need

    in addition as soon as you do a CTRL + F5 or refresh web page with F5, it removes the theme lol

  • @DownPW yes, I noticed that also. Looks like session data isn’t being retained.

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    @DownPW I’m running Harmony now on https://sudonix.dev 🙂 There is no swatch functionality from what I can see, so the code we developed is still up for the taking.

    thanks for this one 👍
    I could check it more seriously…

  • Just looking through my code here, and provided that Persona as a NodeBB theme continues to be maintained, then the conversion of my code to v3 is a relatively simple affair meaning I could continue with my Swatch code without too much effort.

    Essentially, the move from v2 to v3 is basically the migration of bootstrap from v3 to v5. I suppose much of this depends on the future of Persona…

    EDIT - I’ll just leave this here
    https://community.nodebb.org/topic/16908/january-2023-developer-update/15?_=1673947070798

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    Just looking through my code here, and provided that Persona as a NodeBB theme continues to be maintained, then the conversion of my code to v3 is a relatively simple affair meaning I could continue with my Swatch code without too much effort.
    Essentially, the move from v2 to v3 is basically the migration of bootstrap from v3 to v5. I suppose much of this depends on the future of Persona…
    EDIT - I’ll just leave this here

    Do you think I could go through your swatch rather than the one I have?

    Because I don’t believe you released your code here. Whether ?

    Either way, I know I’ll have to start all over again in these 2 cases

  • @DownPW Yes, of course. However, because of the change of elements, I have to re-write most of it. In addition, only one theme will be supported - either Persona, or Harmony. If we go the Harmony route (which is highly likely) then virtually all of the swatch needs to be re-written including LESS etc.

    I don’t want to support more than one theme and would ideally stick to Harmony.

  • @phenomlab said in NodeBB v3 and Harmony Theme:

    Yes, of course. However, because of the change of elements, I have to re-write most of it. In addition, only one theme will be supported - either Persona, or Harmony. If we go the Harmony route (which is highly likely) then virtually all of the swatch needs to be re-written including LESS etc.
    I don’t want to support more than one theme and would ideally stick to Harmony.

    Yes indeed, we have to focus on one main theme and not two. (Persona or Harmony)

    I don’t yet have the opinions of the other members of my team but since it’s I who will then develop the themes compatible with Harmony, I think that we will go towards the road of Harmony

    If you are ready to share your codes once finished and explain how to use it, it’s really a good thing and I already thank you in advance 😉

  • @DownPW said in NodeBB v3 and Harmony Theme:

    If you are ready to share your codes once finished and explain how to use it, it’s really a good thing and I already thank you in advance

    More than happy to do so. In fact, BS5 makes it so much easier as LESS variables are being used, which we simply target and change. Far LESS (pun intended) work !

  • @DownPW I’ve started development work on Harmony in v3 and should have some beta code for you to test soon. Stay tuned!

  • @phenomlab Oh yeah very good news 😉

  • phenomlabundefined phenomlab forked this topic on
  • hello mark

    here is my tutorial for install V3.00 but it’s for alpha3.0 like you see in command.

    cd /path/to/your/nodebb
    git rev-parse HEAD  # save this value in case you need to roll back  
    git fetch && git checkout bootstrap5
    git reset --hard v3.0.0-alpha.3
    npm config set legacy-peer-deps true
    ./nodebb upgrade -mi
    ./nodebb build
    ./nodebb start
    

    – My questions :

    • How to know the name of the last version for V3 for install it (here is alpha.3) and adapt cli command above ?

    • How to upgrade the dev environment ? I know when Harmony it’s upgrade, we must upgrade boottrap 5

    – Here the command to upgrade bootstrap5 :

    git fetch && git checkout bootstrap5
    

    Many thanks


  • Composer Zen icon?

    Solved Configure
    8
    2 Votes
    8 Posts
    198 Views

    @DownPW exactly. Not really a new concept, and in all honesty, not something I’ve ever used.

    If you consider the need to add links and references, or citations, you’d need to be able to see other parts of the screen!

  • 6 Votes
    25 Posts
    2k Views

    @phenomlab said in Q&A Plugin Changes NodeBB:

    float: right;
    left: 10px;
    }

    worked thank you 🙂

  • NodeBB Theme/Skin Switcher

    Solved Customisation
    38
    7 Votes
    38 Posts
    2k Views

    @Teemberland great spot ! You should create a PR for that so they can include it in the official repository.

    Just be aware that any subsequent releases will overwrite your fix without the PR.

  • Rotating homepage icons, gifs?

    Solved Configure
    2
    3 Votes
    2 Posts
    186 Views

    @eveh It’s not a GIF, no. It’s actually a webp file so made much smaller, and uses keyframes to control the rotation on hover. You can easily make your own though 🙂

    The CSS for that is as below

    @keyframes rotate180 { from { transform: rotate(0deg); } to { transform: rotate(180deg); } } @keyframes rotate0 { from { transform: rotate(180deg); } to { transform: rotate(0deg); } }

    Your milage may vary on the CSS below, as it’s custom for Sudonix, but this is the class that is used to control the rotate

    .header .forum-logo, img.forum-logo.head { max-height: 50px; width: auto; height: 30px; margin-top: 9px; max-width: 150px; min-width: 32px; display: inline-block; animation-name: rotate180, rotate0; animation-duration: 1000ms; animation-delay: 0s, 1000ms; animation-iteration-count: 1; animation-timing-function: linear; transition: transform 1000ms ease-in-out; }
  • 0 Votes
    5 Posts
    384 Views

    @qwinter this particular site uses the code I wrote if you want to see it in action. It’s a information and intelligence gatherer I designed for collecting various information security articles from around the globe and consolidating them in one place.

    Essentially, each “post” is in fact generated by the script, and the NodeBB API.

    https://hostrisk.com/

  • [NODEBB] Welcome Message

    Solved Customisation
    18
    13 Votes
    18 Posts
    2k Views

    For anyone reviewing this post, there’s an updated version here that also includes an sunrise / sun / moon icon depending on the time of day

    https://sudonix.com/topic/233/nodebb-welcome-message-with-logo-footer-change/3?_=1645445273209

  • 6 Votes
    25 Posts
    2k Views

    @phenomlab said in NodeBB vs Discourse:

    Hetzner eh ? I use them also. In fact, Sudonix is hosted in Nuremberg 👍

    yes i’m also at hetzner, i have been a customer there for years with a reseller account for domains. My VPS that I host there are also in Nuremberg 🙂

  • nodebb-plugin-customize error

    Solved Customisation
    25
    2 Votes
    25 Posts
    2k Views

    @phenomlab it work, thanks 🙂