Skip to content

Develop faster on Magento / Adobe Commerce with Mage Wizard

License

Notifications You must be signed in to change notification settings

ClickAndMortar/mage-wizard

Repository files navigation

Mage Wizard



Warning

Mage Wizard is currently in beta. Use carefully in a development environment. Always work on version-controlled code, or backup your code before making changes. Please report any issues you find, or any suggestions you have.

Mage Wizard is a web-based tool to help you developer faster on Magento / Adobe Commerce 2.4+:

  • Generate a new module
  • Generate / edit code:
    • System configs
    • Models
    • Patches
    • Commands
    • Crontab jobs
    • Admin grids (coming soon)
    • Plugins
    • Observers
    • Email templates
  • View configuration:
    • Modules
    • Tables (from db_schema.xml)
    • Crontab jobs
    • CLI commands
    • Plugins
    • Observers
    • Email templates
  • Analyse Composer dependencies

Local requirements

Usage

Using npx

npx mage-wizard@latest

Open http://localhost:3000 in your browser.

Using Docker

docker run -p 3000:3000 -v <path-to-magento-root>:/magento clickandmortar/mage-wizard

Replace <path-to-magento-root> with the path to your Magento / Adobe Commerce root directory.

Open http://localhost:3000 in your browser, and when prompted, use /magento as the Magento root path.

Note

Remember to frequently run docker pull clickandmortar/mage-wizard to get the latest version.

Installing globally using npm

npm install -g mage-wizard

mage-wizard

Open http://localhost:3000 in your browser.

Environment variables

Name Description Default value
PORT Port to listen on 3000
HOST Host to listen on 127.0.0.1

Development

Requirements

Setup

npm install

Development server

Start the development server on http://localhost:3000:

npm run dev

Build and deployment

# Bumps the version in package.json and creates a new commit with updated CHANGELOG.md
npm run release

git push --follow-tags origin main

When a tag is pushed, the GitHub Actions workflow will:

Documentation

The documentation (located under docs/) is written in Markdown and rendered using VitePress.

To start the documentation server locally, run:

npm run docs:dev

Publishing the documentation

The documentation is automatically published to mage-wizard.dev using GitHub Pages.

See the .github/workflows/docs.yaml workflow for more details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

This project is not affiliated with, endorsed by, or sponsored by Adobe Inc. "Magento" and "Adobe Commerce" are trademarks of Adobe Inc. All trademarks and registered trademarks are the property of their respective owners.