PHPackages                             openforgeproject/mageforge - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. openforgeproject/mageforge

ActiveMagento2-module[Utility &amp; Helpers](/categories/utility)

openforgeproject/mageforge
==========================

Magento 2 module for frontend workflow automation

0.24.0(3d ago)206691[1 issues](https://github.com/OpenForgeProject/mageforge/issues)[2 PRs](https://github.com/OpenForgeProject/mageforge/pulls)GPL-3.0PHPPHP ~8.3.0||~8.4.0||~8.5.0CI passing

Since Apr 4Pushed 2w ago2 watchersCompare

[ Source](https://github.com/OpenForgeProject/mageforge)[ Packagist](https://packagist.org/packages/openforgeproject/mageforge)[ GitHub Sponsors](https://github.com/dermatz)[ RSS](/packages/openforgeproject-mageforge/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (11)Versions (59)Used By (0)

MageForge for Magento 2
=======================

[](#mageforge-for-magento-2)

[![Mageforge Hero](./.github/assets/MageForge-Header.png)](./.github/assets/MageForge-Header.png)

[![Release](https://camo.githubusercontent.com/9a60f4fed678879d9320da8b848994840b93a317a9a6ab6ce6443bdd54ed8612/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f4f70656e466f72676550726f6a6563742f6d616765666f726765)](https://github.com/OpenForgeProject/mageforge/releases) [![License](https://camo.githubusercontent.com/a8f839e5e0d6bc584a8c8bd13dedd9134b8ec7897907d51f7741182d744f3b81/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d47504c2d2d332e302d626c7565)](LICENSE)

MageForge is a powerful CLI toolkit for Magento 2 front-end development. It simplifies theme building workflows, supports multiple theme types (Magento Standard, Hyvä, TailwindCSS, custom), and includes developer tools like the Frontend Inspector.

Table of Contents
-----------------

[](#table-of-contents)

- [Requirements](#requirements)
- [Supported Theme Types](#supported-theme-types)
- [Installation](#installation)
- [Quick Start](#quick-start)
- [Frontend Inspector](#frontend-inspector)
- [Commands Reference](#commands-reference)
- [Documentation](#documentation)
- [Get your Merch](#get-your-merch)
- [Credits](#credits)

> **Contributor?** Jump to the [Development Guide](./docs/development.md).

Requirements
------------

[](#requirements)

- Magento 2.4.7+ (tested on 2.4.7-p10, 2.4.8-p5, 2.4.9)
- PHP 8.3+
- Node.js (LTS recommended)
- Composer

Supported Theme Types
---------------------

[](#supported-theme-types)

[![Mageforge Hero](./.github/assets/MageForge-cli-chooser.png)](./.github/assets/MageForge-cli-chooser.png)

Theme TypeSupport StatusMagento Standard✅ SupportedHyvä (TailwindCSS 3.x / 4.x)✅ SupportedHyvä Checkout✅ SupportedHyvä Fallback✅ SupportedCustom TailwindCSS (no Hyvä)✅ SupportedAvanta B2B✅ SupportedYour Custom Theme[Create your own Builder](./docs/custom_theme_builders.md)Installation
------------

[](#installation)

1. Install via Composer:

    ```
    composer require openforgeproject/mageforge
    ```
2. Enable the module:

    ```
    bin/magento module:enable OpenForgeProject_MageForge
    bin/magento setup:upgrade
    ```

Quick Start
-----------

[](#quick-start)

```
# 1. List available themes
bin/magento mageforge:theme:list

# 2. Build a theme
bin/magento mageforge:theme:build Magento/luma

# 3. Watch for changes (development mode)
bin/magento mageforge:theme:watch Magento/luma
```

See [Commands Reference](./docs/commands_reference.md) for the full command list with options and examples.

Frontend Inspector
------------------

[](#frontend-inspector)

The MageForge Inspector lets you inspect Magento blocks, templates, and performance metrics directly in your browser.

**Features:**

- Template paths, block classes, and module names
- PHP render times and cache status (lifetime, tags)
- Web Vitals: LCP, CLS, INP per element
- Accessibility checks: ARIA roles, contrast ratios, alt text

### Screenshot

[](#screenshot)

[![Mageforge Toolbar](./.github/assets/MageForge-Toolbar.jpeg)](./.github/assets/MageForge-Toolbar.jpeg)

**Enable:**

```
bin/magento mageforge:theme:inspector enable
```

The Inspector can also be enabled in Admin: `Stores > Configuration > MageForge > Frontend Inspector`)

**Use in Browser:**

- Toggle: `Ctrl+Shift+I` (Windows/Linux) or `Cmd+Option+I` (macOS)
- Hover over elements to inspect; click to lock on a specific block

> **Note:** Requires Developer Mode. If not already active, run `bin/magento deploy:mode:set developer`.

Commands Reference
------------------

[](#commands-reference)

See the dedicated [Commands Reference](./docs/commands_reference.md) for complete documentation of all MageForge commands, including:

- Theme commands (`list`, `build`, `watch`, `clean`, `inspector`)
- Hyvä commands (`tokens`, `compatibility:check`)
- System commands (`version`, `check`)
- Options, arguments, and usage examples

Documentation
-------------

[](#documentation)

- [Commands Reference](./docs/commands_reference.md) — Full command documentation
- [Custom Theme Builders](./docs/custom_theme_builders.md) — Extend MageForge for custom themes
- [Development Guide](./docs/development.md) — Local dev setup, workflow, and contribution guide

Get your Merch
--------------

[](#get-your-merch)

[![Mageforge Hero](./.github/assets/MageForge-Merch.jpg)](https://mageforge.myspreadshop.de/)

Support
-------

[](#support)

- **Bugs / Features:** [GitHub Issues](https://github.com/OpenForgeProject/mageforge/issues)
- **Discussions:** [GitHub Discussions](https://github.com/OpenForgeProject/mageforge/discussions)
- **Contributing:** See [Contributing Guidelines](./CONTRIBUTING.md)

Credits
-------

[](#credits)

MageForge uses the following third-party libraries:

LibraryAuthorLicense[Tabler Icons](https://tabler.io/icons)codecalm[MIT](https://github.com/tabler/tabler-icons/blob/main/LICENSE)---

Special Thanks
--------------

[](#special-thanks)

A big thank you to **[e3n-team](https://github.com/e3n-team)** for their continuous support and collaboration in the further development of MageForge.

Your contributions have been invaluable!

---

Thank you for using MageForge!

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance97

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 82.7% of commits — single point of failure

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 ~11 days

Total

40

Last Release

3d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e60d20c0bfd0922c8b42cb3d72da983c87cfda0cde927099ced900dd8a56a0c3?d=identicon)[dermatz](/maintainers/dermatz)

---

Top Contributors

[![dermatz](https://avatars.githubusercontent.com/u/6103201?v=4)](https://github.com/dermatz "dermatz (334 commits)")[![Morgy93](https://avatars.githubusercontent.com/u/7961978?v=4)](https://github.com/Morgy93 "Morgy93 (33 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (27 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (10 commits)")

---

Tags

build-automationbuild-automation-toolcli-tooldeveloper-toolsdevelopmentfrontend-developmenthyvahyva-communityhyva-modulehyva-themesmagento-developmentmagento-thememagento2magento2-modulemagento2-module-freetheme-builderworkflow-enhancement

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/openforgeproject-mageforge/health.svg)

```
[![Health](https://phpackages.com/badges/openforgeproject-mageforge/health.svg)](https://phpackages.com/packages/openforgeproject-mageforge)
```

###  Alternatives

[livewire/flux

The official UI component library for Livewire.

9527.8M128](/packages/livewire-flux)[nativephp/mobile

NativePHP for Mobile

1.1k75.1k91](/packages/nativephp-mobile)[elgentos/regenerate-catalog-urls

Regenerate Catalog URL Rewrites (products, categories, cms pages)

2842.6M](/packages/elgentos-regenerate-catalog-urls)[nativephp/desktop

NativePHP for Desktop

39742.4k8](/packages/nativephp-desktop)[nosto/module-nostotagging

Increase your conversion rate and average order value by delivering your customers personalized product recommendations throughout their shopping journey.

27703.7k4](/packages/nosto-module-nostotagging)[myparcelnl/magento

A Magento 2 module that creates MyParcel labels

1860.2k](/packages/myparcelnl-magento)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
