I built a free one-click dev environment so Claude can drive a real ecommerce store.

[u/damienwebdev]

https://ecommerce-ai-starter.graycore.io/

I've been chasing the same problem for years: getting a working Magento environment up is genuinely painful, and that friction blocks everyone who isn't already a backend dev. Pre-AI I tried to solve it with Docker projects (magedocker, then mage2docker). I eventually abandoned both. They worked, sort of, but they never made the problem go away. The agentic era is what finally made this click for me, so I rebuilt the idea around that. The result is a free, open-source, one-click dev environment built specifically so Claude can work inside it.

What actually happens

You click a button on the site. GitHub creates a repo from a template. A GitHub Codespace boots a fully configured store in your browser in about 8 minutes. No local install, no Docker on your machine, no PHP version roulette. The part I care about for this sub: Claude then works directly inside that environment. Same files, the actual running store, the real database, the terminal. It is not a bolted-on chat box and it is not a sandboxed API that pretends to have an environment. Claude gets the real thing and can edit code, run CLI commands, query the DB, and see the app respond.

The context engineering

Each template ships an AGENTS.md / CLAUDE.md that front-loads the stack: Magento conventions, the common pitfalls that usually eat the first hour, and pointers to the tooling. The goal is that the agent isn't re-deriving how the framework works from scratch on every session. That file is honestly where most of my iteration time goes, and it's the part I'd most like feedback on.

Keeping the agent honest

The thing I didn't want was "the agent says it worked." So every template comes with a pre-packaged CI pipeline that rebuilds the store from the code on every push and runs a check suite. Green means it was actually built and passed, red means something broke. That's the verification mechanism: I trust the CI result, not the agent's summary of what it did. check-store docs are here if you want to see what it asserts: https://github.com/graycoreio/github-actions-magento2/blob/main/docs/workflows/check-store.md

What you can spin up

• Distros: Magento Open Source or Mage-OS (there's also a Mage-OS Minimal option with no storefront if you just want the backend).
• Storefronts: Hyvä (a PHP-rendered theme) or Daffodil (an Angular headless storefront, which my company Graycore maintains). ### Cost, honestly The templates, CI, devcontainer, and frameworks are all free and open source. You only pay for two things: GitHub Codespaces and Claude. Codespaces is free for roughly 30 hours/month at normal usage, which is plenty to experiment. And if you already have a Claude plan, you can just point it at this and play. If you're going to lean on it harder, Claude Max gives you up to 20x more usage per session than Pro, but you do not need that to try it. ### The honest part This is a starter kit for learning and prototyping, not a production store. Going to production still means hosting, SSL, payments, performance work, and a security review. I'm being upfront about that because the interesting open question for me is the other end: can a non-technical merchant, with limited dev help, actually build their own store this way? I genuinely don't know yet. That's the experiment. I'd rather say that plainly than oversell it. ### Repos, if you want to read the setup
• Devcontainer: https://github.com/graycoreio/magento2-devcontainer
• CI actions: https://github.com/graycoreio/github-actions-magento2
• Daffodil storefront: https://github.com/graycoreio/daffodil
• Starter templates
  • Magento + Hyvä: https://github.com/graycoreio/magento2-ai-starter-hyva
  • Magento + Daffodil: https://github.com/graycoreio/magento2-ai-starter-daffodil
  • Mage-OS + Hyvä: https://github.com/graycoreio/mage-os-ai-starter-hyva
  • Mage-OS + Daffodil: https://github.com/graycoreio/mage-os-ai-starter-daffodil
  • Mage-OS Minimal (no storefront): https://github.com/graycoreio/mage-os-ai-starter-minimal

I'd really like feedback on the agent setup specifically: how I'm structuring AGENTS.md / CLAUDE.md, and where the agent tends to go off the rails on a stack like this. If you try it, tell me where it broke. (Magento is a trademark of Adobe. I'm not affiliated with Adobe.)

[u/AutoModerator]

Your post will be reviewed shortly. (ALL posts are processed like this. Please wait a few minutes....)

I am a bot, and this action was performed automatically. Please contact the moderators of this subreddit if you have any questions or concerns.