An open API service indexing awesome lists of open source software.

https://github.com/OpenForgeProject/mageforge

MageForge is a Magento 2 module designed to assist frontend developers in streamlining their workflow and enhancing productivity.
https://github.com/OpenForgeProject/mageforge

build-automation build-automation-tool cli-tool developer-tools development frontend-development hyva-themes magento-development magento-theme magento2 magento2-module magento2-module-free theme-builder workflow-enhancement

Last synced: 4 months ago
JSON representation

MageForge is a Magento 2 module designed to assist frontend developers in streamlining their workflow and enhancing productivity.

Awesome Lists containing this project

README

          

# MageForge for Magento 2

![Mageforge Hero](./.github/assets/mageforge-hero.jpg)

[![Codacy Badge](https://app.codacy.com/project/badge/Grade/7d7c46d7492043c7ada514ed1d4a4c05)](https://app.codacy.com/gh/OpenForgeProject/mageforge/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade) [![CodeFactor](https://www.codefactor.io/repository/github/openforgeproject/mageforge/badge)](https://www.codefactor.io/repository/github/openforgeproject/mageforge)

MageForge is a powerful CLI front-end development toolkit for Magento 2 that simplifies theme development workflows. It provides tools for many types of Magento themes and can be easily extended for your custom theme. With MageForge, themes can be built lightning fast, without your developers having to worry about the details. MageForge eliminates complex configuration requirements and significantly reduces setup time, allowing Magento developers to focus on creative aspects instead of struggling with build processes.

[![Join our OpenForgeProject Discord community](./.github/assets/small_logo_blurple_RGB.png)](https://discord.gg/H5CjMXQQHn)

## Supported Magento Versions

MageForge requires Magento 2.4.7 or higher.
Please ensure that your Magento installation meets this requirement before installation.

## Features

### Supported Theme-Types 🎨

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

| Theme Type | Support Status |
|------------|----------------|
| 🎯 Magento Standard | ✅ Fully Supported |
| 🚀 Hyvä | ✅ Fully Supported |
| 🔄 Hyvä Fallback | ✅ Fully Supported |
| 🎨 Custom TailwindCSS (no Hyvä) | ✅ Fully Supported |
| 💼 Avanta B2B | ✅ Fully Supported |
| 🥰 Your Custom Theme | [Create your own Builder](./docs/custom_theme_builders.md) |

---

### Available Commands

| Command | Description | Shortcodes |
|---------------------------|-------------------------------------------------------------|-----------------------------------|
| `mageforge:system:version` | Shows current and latest version of the module | `m:s:v` |
| `mageforge:system:check` | Get system information (OS, PHP, Database, Node.js, etc.) | `m:s:c` |
| `mageforge:theme:list` | Lists all available themes | `m:t:l` |
| `mageforge:theme:build` | Builds selected themes (CSS/TailwindCSS) | `m:t:b`, `frontend:build` |
| `mageforge:theme:watch` | Starts watch mode for theme development | `m:t:w`, `frontend:watch` |

---

## Getting Started

### Installation

1. Install the module via Composer:
```bash
composer require openforgeproject/mageforge
```

2. Enable the module:
```bash
bin/magento module:enable OpenForgeProject_MageForge
bin/magento setup:upgrade
```

### Quick Start Guide

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

2. Build a theme:
```bash
bin/magento mageforge:theme:build
```
Example: `bin/magento mageforge:theme:build Magento/luma`

3. Start development watch mode:
```bash
bin/magento mageforge:theme:watch
```

4. Enjoy automatic CSS rebuilding you work on your theme files!

## Additional Documentation

- [Advanced Usage Guide](./docs/advanced_usage.md) - Tips, tricks and troubleshooting
- [Custom Theme Builders Documentation](./docs/custom_theme_builders.md) - Extend MageForge for your custom themes
- [Commands Documentation](./docs/commands.md) - Detailed command reference

## Community & Support

- **Report Bugs/Features**: [GitHub Issues](https://github.com/OpenForgeProject/mageforge/issues)
- **Get Help**: [Discord Community](https://discord.gg/H5CjMXQQHn)
- **Contributing**: See [Contributing Guidelines](./CONTRIBUTING.md)

## Project Information

- **License**: [LICENSE](LICENSE)
- **Changelog**: [CHANGELOG](CHANGELOG.md)

---

Thank you for using MageForge!