Open Source Project

MageForge

MageForge ist ein mächtiges CLI-Toolkit für Magento 2 Frontend-Entwicklung. Es vereinfacht Theme-Builds, unterstützt Magento Standard, Hyvä, Tailwind CSS und individuelle Themes — und liefert mit dem Frontend Inspector leistungsstarke Debug-Tools direkt in den Browser.

Das Problem

Magento-Frontend-Workflows sind komplex

Theme-Builds manuell starten, verschiedene Theme-Typen mit unterschiedlichen Build-Prozessen, Debug-Informationen mühsam zusammensuchen — das kostet Zeit und Nerven. MageForge bündelt diese Aufgaben in einem einheitlichen, erweiterbaren Kommandozeilen-Tool.

Die Lösung

Ein Toolkit für den ganzen Stack

Von der Installation über Theme-Builds bis zum Live-Debugging im Browser — MageForge deckt den kompletten Magento-Frontend-Lifecycle ab. Modular aufgebaut, gut getestet und offen für Erweiterungen.

Tech Stack

Auf solider Basis gebaut

Magento

2.4.7+

Getestet bis 2.4.9

PHP

8.3+

Modernes Typing

Node.js

LTS

Für Build-Tools

Lizenz

GPL-3.0

Open Source

CI

GitHub Actions

PHPUnit, Functional, Static Analysis

QA

PHPCS & Lint

Code Style & Mutation Testing

PK

Composer/Packagist

Einfache Installation

Kompatibilität

Unterstützte Theme-Typen

Egal ob klassisches Magento-Luma, Hyvä mit Tailwind CSS oder eine vollkommen eigene Lösung — MageForge passt sich an.

Theme TypStatus
Magento Standard (Luma)✓ Unterstützt
Hyvä (Tailwind CSS 3.x / 4.x)✓ Unterstützt
Hyvä Checkout✓ Unterstützt
Hyvä Fallback✓ Unterstützt
Custom Tailwind CSS (ohne Hyvä)✓ Unterstützt
Avanta B2B✓ Unterstützt
Eigene Themes✓ Über Custom Builder erweiterbar

Schnellstart

In wenigen Minuten einsatzbereit

1. Installation

composer require openforgeproject/mageforge

2. Modul aktivieren

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

3. Themes auflisten

bin/magento mageforge:theme:list

4. Theme bauen

bin/magento mageforge:theme:build Magento/luma

5. Im Watch-Modus entwickeln

bin/magento mageforge:theme:watch Magento/luma

Features

Werkzeuge, die den Alltag erleichtern

Theme Build & Watch

Einheitliche Befehle für Build, Watch und Clean — unabhängig vom jeweiligen Theme-Typ.

Multi-Theme-Support

Magento Standard, Hyvä, Tailwind CSS, Avanta B2B und eigene Custom Builder aus einer Hand.

Frontend Inspector

Template-Pfade, Block-Klassen, Render-Zeiten, Cache-Status, Web Vitals und Accessibility-Checks direkt im Browser.

Hyvä-Tools

Befehle für Tokens, Compatibility-Checks und den spezifischen Hyvä-Build-Workflow.

Erweiterbar

Eigene Theme Builder lassen sich nahtlos integrieren — dokumentiert und mit klaren Schnittstellen.

Open Source

GPL-3.0 lizenziert, frei nutzbar und offen für Contributions, Issues und Diskussionen.

Debug-Tool

Frontend Inspector

Der Frontend Inspector bringt Debug-Informationen direkt ins Browser-Fenster. Aktivierbar per CLI oder im Magento Admin unter Stores > Configuration > MageForge > Frontend Inspector.

  • Template-Pfade, Block-Klassen und Modulnamen auf einen Blick
  • PHP Render-Zeiten und Cache-Status inklusive Lifetime und Tags
  • Web Vitals pro Element: LCP, CLS, INP
  • Accessibility-Checks: ARIA-Rollen, Kontrastverhältnisse, Alt-Texte
bin/magento mageforge:theme:inspector enable Toggle: Cmd + Option + I (macOS) / Ctrl + Shift + I (Win/Linux)
MageForge Frontend Inspector
Frontend Inspector Toolbar

Commands

Wichtige Befehle

mageforge:theme:list

Alle verfügbaren Themes auflisten

Theme

mageforge:theme:build <theme>

Theme-Assets bauen

Theme

mageforge:theme:watch <theme>

Dateiänderungen überwachen und neu bauen

Theme

mageforge:theme:inspector enable|disable

Frontend Inspector aktivieren/deaktivieren

Debug

mageforge:hyva:tokens

Hyvä Design Tokens verwalten

Hyvä

mageforge:hyva:compatibility:check

Hyvä-Kompatibilität prüfen

Hyvä

Die vollständige Command-Referenz findest du in der Dokumentation auf GitHub.

Qualität

Getestet und überprüft

MageForge wird durch eine umfassende CI-Pipeline begleitet: Unit-Tests, funktionale Tests, statische Analyse, Code-Style-Checks und Mutation Testing.

PHPUnit

Unit Tests

Functional

Integration

PHPStan

Level 9 — Maximum Strictness

Infection

Mutation

PHPStan Level 9

Das höchste Strictness-Level in PHPStan. Level 9 erzwingt rigorose Typ-Sicherheit, erkennt potenzielle Laufzeitfehler frühzeitig und garantiert eine extrem solide Codebasis — weit über typische Magento-Module hinaus.

Top Tier

Impressionen

MageForge in Aktion

MageForge Toolbar
Toolbar Integration
MageForge CLI Chooser
CLI Chooser

Mitmachen

Lust, mitzugestalten?

MageForge lebt von der Community. Feedback, Bug Reports, Feature Requests und Pull Requests sind jederzeit willkommen.

Unterstütze meine Projekte