Category: General request

General questions, feature enhancements and discussions.

  • Bootstrap Starter 3.5.1 development with Local y Flywheel – how to get live reload/browsersync working?

    Hi there,
    I’m trying to migrate from the 3.4.1 version of the Bootstrap Starter theme, but haven’t been able to figure out how to get it working, at least in the way I expect it to.
    In the previous version, we could set the localHost value to what our local install is, but I’m not seeing how to do that with 3.5.1.
    When I ‘run npm watch’ I get:
    [webpack-dev-server] Project is running at:
    [webpack-dev-server] Loopback: http://localhost:8080/
    But no URL for where to load the site and have liveReload work.
    I do see anything in the documentation/readme for how to make this work.
    I’m set up on Windows 11, node 14.21.3, using the latest version of Local with my install being nginx, PHP 8.2.10, MariaDB 10.4.10 and a local site domain of https://kmstarter351.local
    Have looked through the webpack devserver documentation but haven’t had any luck getting something to work here.
    Is there a trick? Is this possible?
    I can see that webpack is working, as when I manually refresh my local domain in the browser it does pick up the updates.
    Thanks in advance.

    Unresolved Resolved

    1. Avatar

      Hi @kmeronuk,

      this is a known issue (at least on some environments) and has been reported by other users as well. But it should be possible to achieve what you want with a bit of trial-and-error.

      You could start by adding the following settings to the webpack devServer config:

      devServer: { open: [ 'http://kmstarter351.local' ], ... }

      If you see errors you may have to deactivate SSL in Local. Otherwise you’d have to tinker with the proxy settings

      Hope this helps or at least points you to the right direction.

      If you do find a solution it would be appreciated if you could post it here for others who are struggling with a similar issue. And maybe our webpack config can be updated safely then to make it work for more environments?

    2. Avatar

      Update: The following GitHub thread may be helpful for anyone experiencing this issue with Local

    Leave a Reply

  • Banner Top overlaps navbar

    Using the starter wp bootstrap theme, I’ve incorporated a banner to remain above the navbar. However, there is an issue where it overlaps with the navbar when the Fixed Top header option is selected. I’m seeking assistance to resolve this matter. Your help is greatly appreciated.

    Here is my code:

                    <p class="phone-number" style="color: ">
                    <p class="address" style="color: ">
                                " target="_blank">">
    Unresolved Resolved

    1. Avatar

      The code you shared seems to be broken and uses invalid HTML. In general, if an element overlaps the header you may be able to solve the issue by increasing or decreasing the z-index value or by changing the top value so that the header will be placed below the top-bar. Another possibility would be to try adding position: sticky to your header and to the top banner.

      Since this issue is not related to the theme code, I’m going to mark it as resolved. If you still have questions you should consult a frontend developer.

    2. bethesda Avatar

      My problem is that top bar that I put above the navbar overlaps the navbar by 50% and it happens only when fixed to top header is selected.
      I need to have a div above header that will not overlap the header when “fixed to Top” is selected in header customize section. If the header is selected as static it does not show any issue. Only when the “fixed to top” is sleceted it overlaps the header half way down.

    Leave a Reply

  • Production site editing scss

    I’ve just deployed a page to the production server where npm is not present, and I prefer not to have it there. I’m wondering how to address the issue when making changes locally and uploading those changes (main.scss) doesn’t reflect any modifications on the production server. Is there a specific workaround or something I need to do to resolve this?

    Unresolved Resolved

    1. Avatar

      If you have a basic understanding of frontend development, which is mandatory when working with a WP Starter theme, you should know that only the locally created build/dist files are relevant on production. main.scss is never touched or enqueued via the website:

    Leave a Reply

  • WebSocket/[webpack-dev-server] connection errors in the console

    I’ve integrated the theme as instructed, but I’m getting these errors in the console. It doesn’t appear to be affecting the “watch” script as changes are taking place, but any thoughts on how I can fix this to keep it from flooding my console? I’m not too familiar w/ WebPack. Any direction is most appreciated. Thanks.

    Unresolved Resolved

    1. Avatar

      Thanks for the detailed information including relevant screenshots.

      A similar issue has never been reported and it seems to be related to the webpack DevServer config. Here you can find all possible configuration settings:
      To fix it, I would start tinkering with the one’s related to “WebSocket”.

      Maybe explicitly defining webSocketTransport ws works (

      client: {
            webSocketTransport: 'ws',
      webSocketServer: 'ws',

      Alternatively you could try defining your webSocketURL (

      client: {
            webSocketURL: '{ADD YOUR LOCAL WS URL HERE}',

      Maybe unrelated, but I noticed that you’re using a wss:// protocol (= WebSocket SSL connection) which is unusual on localhost systems as you’d have to provide a valid SSL certificate.

      Please let me know if any of this helped.

    2. munzi89 Avatar

      I’ve tried different combinations of the config settings, as well as your above recommendations without success.
      You may be on to something regarding the SSL certificate. When inspecting in Safari, the console expresses an “An SSL error has occurred and a secure connections to the server cannot be made.” regarding the WebSocket connection – while in Chrome, it just says the connection failed seen in the OG screenshots.
      I spun up another host following your instructions in case I missed anything:

      Uploaded and activated the new theme in WordPress
      “npm install” in the console
      “npm run watch” to start webpack
      The instance uses wss:// protocol to begin with without me changing anything. Is there a way to start using just the ws:// protocol and potentially avoiding that error?

      I’m using MAMP Pro to spin up the WordPress instance, which installs an SSL certificate for the site, but not sure that has anything to do with the WebSocket SSL.

    3. munzi89 Avatar

      When disabling the SSL certificate for WordPress, the WebSocket errors resolve, but then I get I get “[webpack-dev-server] Invalid Host/Origin header” errors in both browsers.

        1. munzi89 Avatar

          I’ve implemented the allowedHosts option and targeted my local.mopqc host, which removes the Invalid Host/Origin error, but now causes an infinite “App Updated. reloading…” loop. I haven’t found a solution when combing the web, so at this point I’m keen to just ignore it or switch starter themes altogether. I appreciate your help regardless, but this remains unresolved.

          1. Avatar

            Sorry about that and good luck anyway.
            Maybe the MAMP support team has experience in setting up a working webpack-dev-server config?
            Otherwise you’d have to consult a webpack expert who could help you fix the infinite reloading issue. One last try: Try to add your IP address, incl./excl. the port, instead of your local URL (in your case probably via the webSocketURL configuration), as stated here:

    Leave a Reply

  • What happened?

    Your Bootstrap theme, simple and straightforward, used to work like a charm. Now it’s a pain in the **s to install and configure, it’s clunky as hell and takes hours to debug in VScode and Flywheel. Why guys?!

    Unresolved Resolved

    1. Avatar

      We’re always open to constructive feedback – even if it’s negative – but without further details your complaint can’t be taken seriously.

      • Are you really sure that the clunkiness you notice is related to the theme?
      • Which theme version worked well and when did the problems you assume first occur?
      • Is your software (OS, PHP, database, NPM, webpack, etc.) up-to-date?
      • Are you using the latest WordPress version?
      • Which plugins are installed?
      • Did you try it on a fresh and clean WordPress installation?
      • Could you share your server logs?

      So many questions 🤨

    2. zabzabzab64 Avatar

      theme is the latest Bootstrap theme available on your site
      MacOS Sonoma, Flywheel local Version 8.1.0+6514, PHP 8, Apache, MySQL 8.0.16, npm 10.2.4, webpack 5.89.0
      Wordpress 6.4.1
      No plugin yet, project is blank
      Our main problem is it worked well… with Gulp. It’s much more complicated to have it work between flywheel & webpack, the whole process is quite confusing to say the least

      1. Avatar

        Well, we don’t force you to use the new webpack config which, by the way, is much leaner and at the same time more future proof because it makes use of a WordPress internal configuration file.
        Feel free to implement the old Gulp setup if it better suits your specific needs.

        Here you can download the legacy Gulpfile:
        And here is the legacy webpack config:

        The weird thing is that webpack already has been implemented in the past for bundling the JS files. And webpack or any frontend assets are completely independent from the server setup (i.e. Local “Flywheel”).

        You could play around with the webpack config and for instance change the mode setting to "development". This should speed up compile time but you would have to rebuild the assets for production before deploying them live.
        Probably there is always room for improvements in the current webpack configuration. Pull requests are welcome!

    Leave a Reply

  • Lightbox for Bootstrap 5

    I was using Ekko Lightbox with the Bootstrap 4* theme, but since updating to Bootstrap 5 it is no longer supported.

    I’ve tried using the Lightbox for Bootstrap 5, but I can’t seem to get it to work. I tried on a clean them install with no other plug ins and still nada….

    Installed using npm i bs5-lightbox and import ‘bs5-lightbox’; as per the instructions on this page:

    Thanks in advance for any clues!

    Unresolved Resolved

    1. Avatar

      Hi leebaz,
      sorry to read that you’re having trouble with your site but please understand that we can’t provide support for third-party tools.
      You could ask for help in the Github repo you referred to:
      As an alternative solution there are several ready-to-use Lightbox plugins in the WordPress Plugins directory which may be worth a try:

    Leave a Reply

  • Hi, i have error on…

    Hi, i have error on my console and I have error in my terminal when I run npm run watch
    “WARNING in asset size limit: The following asset(s) exceed the recommended size limit (244 KiB).
    This can impact web performance.
    main.css (284 KiB)

    WARNING in entrypoint size limit: The following entrypoint(s) combined asset size exceeds the recommended limit (244 KiB). This can impact web performance.
    main (484 KiB)

    WARNING in webpack performance recommendations:
    You can limit the size of your bundles by using import() or require.ensure to lazy load some parts of your application.
    For more info visit

    How to solve this error

    Unresolved Resolved

    1. Avatar

      This warning doesn’t produce an error and can be considered a recommendation. If you want to reduce the file size you can try to deactivate unneeded modules in main.scss ( but if this is not possible you can hide the warning via your webpack config: See and

    Leave a Reply

  • Starter Themes with a new build workflow

    We’ve received feedback from our community that the now retired build workflow (using Gulp and/or webpack to generate the CSS/JS assets) included several package vulnerabilities that have not been fixed for quite a while and obviously have become unmaintained by the creators.

    One could argue that this should not be problematic, as these dependencies only affect the local development system – and as long as the build process still works, there’s no need to change a running system.
    But using obsolete and unsupported software can be dangerous and can break things “overnight”. Not to mention potential security risks that may arise in the web development stack.

    So it was necessary to find a new simple, modern and future-proof build process for SASS-CSS compilation and JS-bundling
    Fortunately the research did not take too long. The @wordpress/scripts package from the awesome Gutenberg community already comes with a proven and tested webpack configuration specific to WordPress development, which made it a perfect candidate to try out.

    After some trial-and-error, the new build workflow worked pretty well and that’s why we decided to roll it out to all our Starter Themes (Full Site Editing, Bootstrap and Material Design) and include this new setup exclusively, meaning that Gulp (including its internal dependencies) is not needed anymore.

    Start the development process:
    $ npm run watch
    Build and minify the assets:
    $ npm run build

    👆 Breaking change: Theme build directories have been moved from /assets/css and /assets/js to /build which aligns with the @wordpress configuration. If you want to include the new workflow in an existing theme, please have a look at the source code in the Github repositories of the Starter Theme and adjust the paths of the JS/CSS assets in functions.php accordingly. On the other hand, if you want to keep the old workflow, feel free to keep it as long as it works on your side.


    Leave a Reply

  • WordPress Playground

    Would you like to play around with an instant WordPress installation that runs in your browser?

    Visit [🪄 powered by] and give it a try.

    Quickly demonstrate the WordPress dashboard to interested people or temporarily test Themes and Plugins without the need of an entire web server:


    Leave a Reply

  • Hi,

    When my site is loading, this link is running in the background.
    I use this start theme for two my projects, now i have problems.

    Unresolved Resolved


    Leave a Reply