PHPackages prestashop/hummingbird - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. prestashop/hummingbird ActivePrestashop-theme prestashop/hummingbird ====================== Hummingbird development theme for PrestaShop v2.0.0(3mo ago)1172.9M—3.5%118[6 PRs](https://github.com/PrestaShop/hummingbird/pulls)1AFL-3.0SmartyCI passing Since Nov 29Pushed 1mo ago37 watchersCompare [ Source](https://github.com/PrestaShop/hummingbird)[ Packagist](https://packagist.org/packages/prestashop/hummingbird)[ RSS](/packages/prestashop-hummingbird/feed)WikiDiscussions develop Synced 1mo ago READMEChangelog (10)Dependencies (2)Versions (12)Used By (1) Hummingbird Theme for PrestaShop ================================ [](#hummingbird-theme-for-prestashop) [![CI](https://github.com/PrestaShop/hummingbird/actions/workflows/lint.yml/badge.svg)](https://github.com/PrestaShop/hummingbird/actions/workflows/lint.yml/badge.svg)[![PrestaShop 9.1+](https://camo.githubusercontent.com/389df7ba7f6bdc8f94693f6b9178c7a731dc19d0ac4121af0bd37dbd7067e861/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70726573746173686f702d392e312532422d627269676874677265656e2e737667)](https://camo.githubusercontent.com/389df7ba7f6bdc8f94693f6b9178c7a731dc19d0ac4121af0bd37dbd7067e861/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f70726573746173686f702d392e312532422d627269676874677265656e2e737667)[![Docker Ready](https://camo.githubusercontent.com/7aa3db3a76815f8fcf908306a6362b4d888fb1666e3ca528782576d6da67b986/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f636b65722d72656164792d626c75652e737667)](https://camo.githubusercontent.com/7aa3db3a76815f8fcf908306a6362b4d888fb1666e3ca528782576d6da67b986/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f636b65722d72656164792d626c75652e737667)[![Node.js v20](https://camo.githubusercontent.com/523d11c94d1fe5bac56448430a6668606b9148c5eac305ccd7dabc0382c462e0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6e6f64652e6a732d32302e782d626c75652e737667)](https://camo.githubusercontent.com/523d11c94d1fe5bac56448430a6668606b9148c5eac305ccd7dabc0382c462e0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6e6f64652e6a732d32302e782d626c75652e737667)[![License](https://camo.githubusercontent.com/fda9bf5ff26592fcbee112b1b6c3d0cc718816607edda6777deb7888c3ce0fee/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d41464c253230332e302d6c69676874677261792e737667)](https://camo.githubusercontent.com/fda9bf5ff26592fcbee112b1b6c3d0cc718816607edda6777deb7888c3ce0fee/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d41464c253230332e302d6c69676874677261792e737667) Hummingbird is a modern, in-development theme for PrestaShop built to be compatible with versions `9.1.x` and above. 🔍 Theme Previews ---------------- [](#-theme-previews) [![](docs/thumb-homepage.png)](docs/homepage.png)[![](docs/thumb-category.png)](docs/category.png)[![](docs/thumb-product.png)](docs/product.png)HomepageCategoryProduct⚠️ Requirements --------------- [](#️-requirements) To work on Hummingbird, you'll need: - Node.js **v20.x**. - npm **v8**. 📑 Table of Contents ------------------- [](#-table-of-contents) - Want to help develop the theme? Start with [🔨 Develop on Hummingbird](#-develop-on-hummingbird). - Want to preview or test it? Jump to [🐳 Run Hummingbird with Docker](#-run-hummingbird-with-docker). - Having issues with caching during development? Jump to [🥵 Troubleshooting](#-troubleshooting). 🔨 Develop on Hummingbird ------------------------ [](#-develop-on-hummingbird) ### 🧰 Installation / Setup [](#-installation--setup) #### 👀 Watch Mode Setup [](#-watch-mode-setup) From the **project root** run the following commands if you want to: 1. Install dependencies: `npm ci`. 2. Run watch mode to build assets: `npm run watch`. 3. You can now go to [🐳 Run Hummingbird with Docker](#-run-hummingbird-with-docker) section to run PrestaShop embedding Hummingbird. #### 🔥 Hot Module Reload (HMR) Setup [](#-hot-module-reload-hmr-setup) 1. From the **project root** run: `npm ci`. 2. Navigate to the `webpack/` directory. 3. Run `cp .env-docker-example .env` or `cp .env-vhost-example .env` (depending on how you want to run your PrestaShop environment). 4. Edit `.env` with your local environment settings and ensure you use a free TCP port. 5. From the **project root** run `npm run dev`. 6. You can now go to [🐳 Run Hummingbird with Docker](#-run-hummingbird-with-docker) section to run PrestaShop embedding Hummingbird. ### 🖌️ Code Quality [](#️-code-quality) To ensure code quality and consistency, run the following commands from the **project root**: - Lint & auto-fix SCSS files: `npm run stylelint` or `npm run stylelint:fix`. - Format & auto-format SCSS with Prettier: `npm run prettier` or `npm run prettier:fix`. - Lint & auto-fix JS/TS files: `npm run lint` or `npm run lint:fix`. 🐳 Run Hummingbird with Docker ----------------------------- [](#-run-hummingbird-with-docker) This theme includes Docker configurations for both **PrestaShop** and **PrestaShop Flashlight** development environments. ### 🛠️ Getting Started [](#️-getting-started) **Note:** If you've already set up your development environment using `Watch Mode` or `Hot Module Reload (HMR)`, you can skip ahead to **step 3**. 1. From the **project root** run: `npm ci`. 2. Then run: `npm run build`. 3. Navigate to the `docker/` directory: `cd docker`. 4. Copy the example environment file: `cp .env-example .env`. 5. Edit `.env` to configure the following variables: - `PS_TAG`: PrestaShop or Flashlight version tag. - [PrestaShop tags](https://hub.docker.com/r/prestashop/prestashop/tags). - [Flashlight tags](https://hub.docker.com/r/prestashop/prestashop-flashlight/tags). - `PLATFORM`: Platform architecture (e.g., linux/amd64, linux/arm64). - `ADMIN_EMAIL`: Back office admin email. - `ADMIN_PASSWORD`: Back office admin password. ### 📦 Available Configurations [](#-available-configurations) - `docker-compose-prestashop.yml`: for standard PrestaShop development environment. - `docker-compose-flashlight.yml`: for PrestaShop Flashlight development environment. ### ▶️ Starting the Environment [](#️-starting-the-environment) From the **project root**, run one of the following commands: ``` # For PrestaShop environment docker compose -f docker/docker-compose-prestashop.yml up -d # For Flashlight environment docker compose -f docker/docker-compose-flashlight.yml up -d ``` ### 👀 After Starting the Environment [](#-after-starting-the-environment) - PrestaShop/Flashlight will be available at and BO at . - phpMyAdmin will be available at . ### ⏹️ Stopping the Environment [](#️-stopping-the-environment) From the **project root**, run one of the following commands: ``` # For PrestaShop environment docker compose -f docker/docker-compose-prestashop.yml down -v # For Flashlight environment docker compose -f docker/docker-compose-flashlight.yml down ``` 🥵 Troubleshooting ----------------- [](#-troubleshooting) Warning If you're experiencing issues with styles or assets not updating while using HMR mode, follow these steps to avoid browser and PrestaShop caching problems: 1. Disable browser cache during development: - Open your browser's DevTools. - Go to the `Network` tab. - Enable `Disable cache` (⚠️ this only works while DevTools stays open). 2. Disable PrestaShop caching: - In the back office, go to: `Advanced Parameters` → `Performance`. - Under the Smarty section: - Set Force compilation to `Yes`. - Set Cache to `No`. - Under the CCC (Combine, Compress and Cache) section: - Disable all options. 📚 Storybook ----------- [](#-storybook) Storybook is used to document and preview the theme's UI components during development. You can view the [live documentation here](https://build.prestashop.com/hummingbird/). Since the theme is still in progress, contributions to improve or expand the documentation are welcome and encouraged. ### ▶️ Run Storybook Locally [](#️-run-storybook-locally) To run Storybook on your machine: 1. Make sure project dependencies are installed, if not, from the **project root** run: `npm ci`. 2. Then run: `npm run storybook`. 3. Storybook will be available at . 🤝 Contributing -------------- [](#-contributing) Please refer to the [contributing guide](CONTRIBUTING.md). ✅ Continuous Integration ------------------------ [](#-continuous-integration) The CI runs include Stylelint, Prettier, ESLint, and TypeScript type checks. 🚀 Continuous Deployment ----------------------- [](#-continuous-deployment) Whenever the `develop` branch is merged into `master`, the Storybook documentation is automatically deployed to GitHub Pages and becomes publicly accessible within minutes. 📄 License --------- [](#-license) This theme is released under the [Academic Free License 3.0](https://opensource.org/licenses/AFL-3.0). ### Health Score 59 — FairBetter than 99% of packages Maintenance86 Actively maintained with recent releases Popularity61 Solid adoption and visibility Community37 Small or concentrated contributor base Maturity45 Maturing project, gaining track record Bus Factor3 3 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~53 days Recently: every ~16 days Total 10 Last Release 52d ago Major Versions 1.x-dev → v2.0.0-beta.12025-11-25 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/15106407?v=4)[Jarvis](/maintainers/ps-jarvis)[@ps-jarvis](https://github.com/ps-jarvis) --- Top Contributors [![tblivet](https://avatars.githubusercontent.com/u/110676325?v=4)](https://github.com/tblivet "tblivet (452 commits)")[![mparvazi](https://avatars.githubusercontent.com/u/85633460?v=4)](https://github.com/mparvazi "mparvazi (208 commits)")[![Hlavtox](https://avatars.githubusercontent.com/u/6097524?v=4)](https://github.com/Hlavtox "Hlavtox (162 commits)")[![ga-devfront](https://avatars.githubusercontent.com/u/52718717?v=4)](https://github.com/ga-devfront "ga-devfront (95 commits)")[![rodriciru](https://avatars.githubusercontent.com/u/10741347?v=4)](https://github.com/rodriciru "rodriciru (53 commits)")[![mattgoud](https://avatars.githubusercontent.com/u/99822883?v=4)](https://github.com/mattgoud "mattgoud (52 commits)")[![JBLach](https://avatars.githubusercontent.com/u/48727835?v=4)](https://github.com/JBLach "JBLach (51 commits)")[![kpodemski](https://avatars.githubusercontent.com/u/2137763?v=4)](https://github.com/kpodemski "kpodemski (42 commits)")[![nicosomb](https://avatars.githubusercontent.com/u/121870?v=4)](https://github.com/nicosomb "nicosomb (39 commits)")[![Oksydan](https://avatars.githubusercontent.com/u/25306716?v=4)](https://github.com/Oksydan "Oksydan (29 commits)")[![yannicka](https://avatars.githubusercontent.com/u/22885898?v=4)](https://github.com/yannicka "yannicka (17 commits)")[![mgielecinski](https://avatars.githubusercontent.com/u/70368592?v=4)](https://github.com/mgielecinski "mgielecinski (15 commits)")[![tswfi](https://avatars.githubusercontent.com/u/1352132?v=4)](https://github.com/tswfi "tswfi (15 commits)")[![jolelievre](https://avatars.githubusercontent.com/u/13801017?v=4)](https://github.com/jolelievre "jolelievre (14 commits)")[![Nakahiru](https://avatars.githubusercontent.com/u/16980315?v=4)](https://github.com/Nakahiru "Nakahiru (12 commits)")[![GytisZum](https://avatars.githubusercontent.com/u/96050852?v=4)](https://github.com/GytisZum "GytisZum (11 commits)")[![SharakPL](https://avatars.githubusercontent.com/u/5007456?v=4)](https://github.com/SharakPL "SharakPL (10 commits)")[![boherm](https://avatars.githubusercontent.com/u/18699562?v=4)](https://github.com/boherm "boherm (10 commits)")[![jf-viguier](https://avatars.githubusercontent.com/u/16720275?v=4)](https://github.com/jf-viguier "jf-viguier (9 commits)")[![matks](https://avatars.githubusercontent.com/u/3830050?v=4)](https://github.com/matks "matks (8 commits)") --- Tags ecommercefront-officemodernprestashopprestashop-themeresponsivetheme ### Embed Badge ![Health badge](/badges/prestashop-hummingbird/health.svg) ``` [![Health](https://phpackages.com/badges/prestashop-hummingbird/health.svg)](https://phpackages.com/packages/prestashop-hummingbird) ``` PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)