Skip to content

dermatz/ddev-woodoo-buildtools-magento

Repository files navigation

[DDEV] Woodoo Frontend Buildtools for Magento & Hyvä

tests License Badge (MIT-License) Last commit date Badge


This ddev add-on helps you to manage your theme build processes in Magento total easy. You can run a build command to build all your themes or a specific theme. Don't matter if the theme is a Magento Standard or Custom Theme, or maybe a Hyva theme. It automatically takes care which type of theme you use and will build it for you. If a dependency is missing, Woodoo will install it.

>> Build all your Magento themes at once, with Magic, build with Woodoo!


Special thanks to e3n GmbH for your Support!

Logo of e3n GmbH & Co.KG in Mainz

Supported Versions Status
Magento 2 Supported project is maintained
All Hyvä Versions supported project is maintained
Hyvä Fallback is supported project is maintained
MageOS is supported project is maintained

Getting Started

Installation

1 . Get the latest Version with following command in your ddev project root

Latest stable version (recommended)
ddev get https://github.com/dermatz/ddev-woodoo-buildtools-magento/archive/refs/tags/1.6.2.tar.gz
Latest Developer-version (Main-Branch) - can be instable!
ddev get https://github.com/dermatz/ddev-woodoo-buildtools-magento/archive/refs/heads/main.tar.gz

2. Start Woodoo Init to update your ./ddev/config.yaml

ddev frontend init
  • Add all themes you want to build or watch

3. Edit .ddev/config.yaml Open and edit .ddev/config.yaml and specify pathes to the themes based on your project structure. (E.g. src/vendor/... or app/design/frontend/Vendor/...)

Update Woodoo

Specific Versions If a newer Release is available you can install the specific version in the same way how your installed. Just repeat the Install-Step with ddev get ... (see Install instructions).

Usage

Usage: ddev frontend [command] [option, theme]

Command:
  init, install           Initial Woodoo Setup to read all themes from dataabase and write to .ddev/config.yaml
  help                    Show a help page
  version, --version, -v  Show version
  check, selftest, test   Woodoo Self Test
  frontend-update         Update to the latest stable Version
  frontend-update -dev    Update to the latest development Version (can be buggy!)
  themes                  List all available themes that are configured in .ddev/config.yaml
  build                   Build all themes that are configured in .ddev/config.yaml
  build -f                Builds all themes without yes/no question (force)
  build Vendor/theme      Build a specific theme
  watch Vendor/theme      Watch for CSS and JS changes in a specific theme

Option:
  -f                      Builds all themes without yes/no question (force)
  themecode               Theme-Code from .ddev/config.yaml

Feature request

Submit your Feature Request by adding a new issue and add a label with feature-request.


Contributing

Contributions are welcome! Please read the Contributing Guidelines first. Feel free to send your improvements as Pull-Request.


Watch out our Contributers, Tester & Supporter


License

MIT License | by Mathias Elle