{"id":22425063,"url":"https://github.com/openforgeproject/mageforge","last_synced_at":"2026-02-14T12:03:18.989Z","repository":{"id":254230917,"uuid":"845558727","full_name":"OpenForgeProject/mageforge","owner":"OpenForgeProject","description":"MageForge is a Magento 2 module designed to assist frontend developers in streamlining their workflow and enhancing productivity.","archived":false,"fork":false,"pushed_at":"2026-01-17T12:18:28.000Z","size":700,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-18T15:56:26.093Z","etag":null,"topics":["build-automation","build-automation-tool","cli-tool","developer-tools","development","frontend-development","hyva","hyva-community","hyva-module","hyva-themes","magento-development","magento-theme","magento2","magento2-module","magento2-module-free","theme-builder","workflow-enhancement"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenForgeProject.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["dermatz"]}},"created_at":"2024-08-21T13:34:44.000Z","updated_at":"2026-01-18T08:33:39.000Z","dependencies_parsed_at":"2024-08-22T07:22:26.699Z","dependency_job_id":"2e702af4-3043-4ed6-a13c-b0c2c815fcac","html_url":"https://github.com/OpenForgeProject/mageforge","commit_stats":null,"previous_names":["dermatz/mageforge","openforgeproject/mageforge"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/OpenForgeProject/mageforge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenForgeProject%2Fmageforge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenForgeProject%2Fmageforge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenForgeProject%2Fmageforge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenForgeProject%2Fmageforge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenForgeProject","download_url":"https://codeload.github.com/OpenForgeProject/mageforge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenForgeProject%2Fmageforge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28776951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-26T09:42:00.929Z","status":"ssl_error","status_checked_at":"2026-01-26T09:42:00.591Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["build-automation","build-automation-tool","cli-tool","developer-tools","development","frontend-development","hyva","hyva-community","hyva-module","hyva-themes","magento-development","magento-theme","magento2","magento2-module","magento2-module-free","theme-builder","workflow-enhancement"],"created_at":"2024-12-05T19:12:55.042Z","updated_at":"2026-02-14T12:03:18.983Z","avatar_url":"https://github.com/OpenForgeProject.png","language":"PHP","funding_links":["https://github.com/sponsors/dermatz"],"categories":[],"sub_categories":[],"readme":"# MageForge for Magento 2\n\n![Mageforge Hero](./.github/assets/mageforge-hero.jpg)\n\n[![Release](https://img.shields.io/github/v/release/OpenForgeProject/mageforge)](https://github.com/OpenForgeProject/mageforge/releases) [![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE) [![CodeFactor](https://www.codefactor.io/repository/github/openforgeproject/mageforge/badge)](https://www.codefactor.io/repository/github/openforgeproject/mageforge) [![Magento Compatibility Test](https://github.com/OpenForgeProject/mageforge/actions/workflows/magento-compatibility.yml/badge.svg)](https://github.com/OpenForgeProject/mageforge/actions/workflows/magento-compatibility.yml) [![Magento Functional Tests](https://github.com/OpenForgeProject/mageforge/actions/workflows/functional-tests.yml/badge.svg)](https://github.com/OpenForgeProject/mageforge/actions/workflows/functional-tests.yml)\n\n\nMageForge 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.\n\n## Supported Magento Versions\n\nMageForge requires Magento 2.4.7 or higher.\nPlease ensure that your Magento installation meets this requirement before installation.\n\n## Features\n\n### Supported Theme-Types 🎨\n\n![Mageforge Hero](./.github/assets/cli-chooser.png)\n\n| Theme Type                      | Support Status                                             |\n| ------------------------------- | ---------------------------------------------------------- |\n| 🎯 Magento Standard             | ✅ Fully Supported                                         |\n| 🚀 Hyvä (TailwindCSS 3.x / 4.x) | ✅ Fully Supported                                         |\n| 🔄 Hyvä Fallback                | ✅ Fully Supported                                         |\n| 🎨 Custom TailwindCSS (no Hyvä) | ✅ Fully Supported                                         |\n| 💼 Avanta B2B                   | ✅ Fully Supported                                         |\n| 🥰 Your Custom Theme (`css`, `sass`, `less`, ... )           | [Create your own Builder](./docs/custom_theme_builders.md) |\n\n---\n\n### Available Commands\n\n| Command                             | Description                                               | Aliases                   |\n| ----------------------------------- | --------------------------------------------------------- | ------------------------- |\n| `mageforge:theme:list`              | Lists all available themes                                | `frontend:list`           |\n| `mageforge:theme:build`             | Builds selected themes (CSS/TailwindCSS)                  | `frontend:build`          |\n| `mageforge:theme:watch`             | Starts watch mode for theme development                   | `frontend:watch`          |\n| `mageforge:theme:clean`             | Clean theme static files and cache directories            | `frontend:clean`          |\n| `mageforge:theme:inspector`         | Enable, disable or check status of Frontend Inspector     | -                         |\n| `mageforge:hyva:compatibility:check`| Check modules for Hyvä theme compatibility issues         | `hyva:check`              |\n| `mageforge:hyva:tokens`             | Generate Hyvä design tokens (Hyvä themes only)            | `hyva:tokens`             |\n| `mageforge:system:version`          | Shows current and latest version of the module            | `system:version`          |\n| `mageforge:system:check`            | Get system information (OS, PHP, Database, Node.js, etc.) | `system:check`            |\n\n## Getting Started\n\n### Installation\n\n1. Install the module via Composer:\n\n   ```bash\n   composer require openforgeproject/mageforge\n   ```\n\n2. Enable the module:\n   ```bash\n   bin/magento module:enable OpenForgeProject_MageForge\n   bin/magento setup:upgrade\n   ```\n\n### Quick Start Guide\n\n1. List available themes:\n\n   ```bash\n   bin/magento mageforge:theme:list\n   ```\n\n2. Build a theme:\n\n   ```bash\n   bin/magento mageforge:theme:build \u003ctheme-code\u003e\n   ```\n\n   Example: `bin/magento mageforge:theme:build Magento/luma`\n\n3. Start development watch mode:\n\n   ```bash\n   bin/magento mageforge:theme:watch \u003ctheme-code\u003e\n   ```\n\n4. Generate Hyvä design tokens (for Hyvä themes):\n\n   ```bash\n   bin/magento mageforge:hyva:tokens \u003ctheme-code\u003e\n   ```\n\n   This creates a `generated/hyva-tokens.css` file from your design tokens configuration.\n\n5. Enjoy automatic CSS rebuilding as you work on your theme files!\n\n---\n\n### Frontend Inspector 🕵️\n\nThe **MageForge Inspector** is a powerful developer tool that allows you to inspect Magento blocks, templates, and performance metrics directly in your browser.\n\n**Key Features:**\n- **Structure Analysis**: View template paths, block classes, and module names for any element.\n- **Performance Metrics**: See PHP render times and cache status (lifetime, tags).\n- **Web Vitals**: Monitor LCP, CLS, and INP metrics per element.\n- **Accessibility Checks**: Inspect ARIA roles, contrast ratios, and alt text.\n\n**How to use:**\n\n1. **Enable the Inspector in the CLI**:\n   ```bash\n   bin/magento mageforge:theme:inspector enable\n   ```\n   *(Note: Requires Magento Developer Mode)*\n\n\n2. **Enable the Inspector in Magento Admin Settings**\nYou can activate the Inspector in Magento Admin under `Stores \u003e Configuration \u003e MageForge \u003e Frontend Inspector`.\n\n3. **Usage in Browser**:\n   - **Toggle**: Press `Ctrl+Shift+I` (Windows/Linux) or `Cmd+Option+I` (macOS).\n   - **Inspect**: Hover over elements to see details. Click to lock the inspector on a specific block.\n\nTo disable the inspector:\n```bash\nbin/magento mageforge:theme:inspector disable\n```\n\n\n\n---\n\n## Additional Documentation\n\n- [Advanced Usage Guide](./docs/advanced_usage.md) - Tips, tricks and troubleshooting\n- [Custom Theme Builders Documentation](./docs/custom_theme_builders.md) - Extend MageForge for your custom themes\n- [Commands Documentation](./docs/commands.md) - Detailed command reference\n\n## Support\n\n- **Report Bugs/Features**: [GitHub Issues](https://github.com/OpenForgeProject/mageforge/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/OpenForgeProject/mageforge/discussions)\n- **Contributing**: See [Contributing Guidelines](./CONTRIBUTING.md)\n\n## Project Information\n\n- **License**: [LICENSE](LICENSE)\n- **Changelog**: [CHANGELOG](CHANGELOG.md)\n\n---\n\nThank you for using MageForge!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenforgeproject%2Fmageforge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenforgeproject%2Fmageforge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenforgeproject%2Fmageforge/lists"}