PHPackages o3-shop/shop-ce - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. o3-shop/shop-ce ActiveOxideshop[Framework](/categories/framework) o3-shop/shop-ce =============== This package contains O3-Shop CE source code. v1.6.1(1mo ago)44.8k↓30.7%7[1 issues](https://github.com/o3-shop/shop-ce/issues)[1 PRs](https://github.com/o3-shop/shop-ce/pulls)14GPL-3.0-onlyPHPPHP ^7.4 || ^8.0CI passing Since Mar 6Pushed 1w ago5 watchersCompare [ Source](https://github.com/o3-shop/shop-ce)[ Packagist](https://packagist.org/packages/o3-shop/shop-ce)[ Docs](https://www.o3-shop.com/)[ RSS](/packages/o3-shop-shop-ce/feed)WikiDiscussions b-1.6 Synced 4d ago READMEChangelog (10)Dependencies (119)Versions (116)Used By (14) O3-Shop ======= [](#o3-shop) [![O3-Shop logo](https://raw.githubusercontent.com/o3-shop/o3-documentation/refs/heads/main/source/assets/logo.png "O3-Shop")](https://raw.githubusercontent.com/o3-shop/o3-documentation/refs/heads/main/source/assets/logo.png) Shop core package ----------------- [](#shop-core-package) This package is part of the O3 Shop. For more information, consult the [documentation](https://docs.o3-shop.com) - License: GNU General Public License 3 - Website: Contribute ---------- [](#contribute) If you want to contribute — or just play around with O3 Shop — here's the how-to. Setting up an environment to work on the O3 core ------------------------------------------------ [](#setting-up-an-environment-to-work-on-the-o3-core) You need an up-and-running Docker environment. Anything like [Docker Desktop ](https://www.docker.com/products/docker-desktop/) or [Colima](https://formulae.brew.sh/formula/colima) will work. We mostly work with Colima, so this setup is the most tested one. ### How to set up the environment for working on O3 Shop [](#how-to-set-up-the-environment-for-working-on-o3-shop) Follow these three simple steps: - Clone this [repository](https://github.com/o3-shop/shop-ce) - Run `./docker.sh start` and it should be up and running. Aaand: You're ready to go. Just open . And in case you missed the Docker log message: - Shop URL: - Admin URL: - Admin login: - Admin Password: admin123 ### What else comes with this package [](#what-else-comes-with-this-package) #### Mailpit [](#mailpit) Once the setup is complete, all emails are sent to Mailpit. You reach it at . #### Adminer [](#adminer) Adminer is included in the standard installation. Try . ### Local bootstrap overrides [](#local-bootstrap-overrides) Need local-only or environment-specific initialization (custom DI bindings, a Whoops error page, Debugbar, `ini_set()` tweaks) without patching tracked core files? Copy the committed example and edit your copy: ``` cp source/bootstrap.custom.php.dist source/bootstrap.custom.php ``` `source/bootstrap.custom.php` is gitignored, so it never ends up in a commit or a diff. It is `require`d at the very end of `source/bootstrap.php`, after the autoloaders, the shop configuration, the `ExitHandler` and `oxNew()` are all available — so it is the right place for overrides. If the file is absent (the default), bootstrap proceeds with no warning. See `source/bootstrap.custom.php.dist` for documented examples. ### Working on the storefront theme [](#working-on-the-storefront-theme) The first `./docker.sh start` clones the storefront themes directly into the served paths via `git`: - `source/Application/views/wave/` ← - `source/Application/views/o3-theme/` ← So those directories ARE the upstream working trees. `git pull`, `git status`, and commits work in place — no out-of-tree clone or symlink dance. Apache serves theme assets through symlinks pointing back into each working tree: - `source/out/wave` → `../Application/views/wave/out/wave` - `source/out/o3-theme` → `../Application/views/o3-theme/out/o3-theme` This means asset edits show up live without re-copying anything. #### Pushing theme changes upstream [](#pushing-theme-changes-upstream) The clone uses HTTPS so anonymous read works without SSH keys. To push back, switch the remote once: ``` cd source/Application/views/wave git remote set-url origin git@github.com:o3-shop/wave-theme.git ``` Same for `source/Application/views/o3-theme/` ↔ `git@github.com:o3-shop/o3-Theme.git`. #### Migrating from the old detached snapshot [](#migrating-from-the-old-detached-snapshot) If you set up shop-ce before this change, your `source/Application/views/wave/` is a detached snapshot from the old `wget`+`unzip` bootstrap with no `.git/` subdirectory. The next `./docker.sh start` will detect this, abort with a loud warning, and tell you exactly what to do. The one-liner is: ``` ./docker.sh stop && rm -rf source/Application/views/wave source/out/wave && ./docker.sh start ``` The entrypoint deliberately refuses to delete those paths itself — they're gitignored, so any in-progress theme edits there are not version-controlled by anything else and would be silently destroyed. If you have uncommitted edits, copy them out of the directory first, then run the cleanup, then replay them onto the fresh working tree (where you can commit and push them). #### Windows host caveat [](#windows-host-caveat) The bootstrap symlinks `source/out/` into the cloned tree. Apache runs in the Linux container and follows the symlink fine on any host OS, so the storefront renders normally everywhere. On Windows hosts where shop-ce is checked out under `C:\...` (Windows-native FS via Docker Desktop's bridge), Windows-side tooling (IDE indexing, `git status` from PowerShell against the `out/` path) may show the symlink as broken — that's a host-side cosmetic issue only; the shop runs. WSL2-native FS (`\\wsl$\...`) and Mac/Linux hosts have no issue. ### AI Development with Claude Code [](#ai-development-with-claude-code) This repository ships with the [Superpowers](superpowers.md) skill set for Claude Code — no plugin installation required. Just open the repo in Claude Code and the skills activate automatically. Superpowers gives Claude a structured workflow: brainstorming → planning → subagent-driven development → code review → quality gate. See **[superpowers.md](superpowers.md)** for the full guide on what's included and how to use it. ### Testing [](#testing) To run the tests, you have two choices. 1. Just run `./docker.sh test` in your terminal. or 2. Run `./run-tests.sh` inside the Docker container This will run all tests in the shop core package. #### Coverage HTML report [](#coverage-html-report) The code coverage report is located in `coverage/html/index.html`. You can open it in your browser to see the results. #### Coverage PhpStorm report [](#coverage-phpstorm-report) To view your coverage report directly in PhpStorm: 1. Open the Coverage tab in PhpStorm 2. Select “Import a report collected in CI from disk” 3. Choose `coverage/coverage.xml`Your coverage report will now display within the IDE. Bugs and issues =============== [](#bugs-and-issues) If you experience any bugs or issues, please report them in the section **O3-Shop (all versions)** of . Even better: Fix them on your own and open a pull request 🥳 Disclaimer ========== [](#disclaimer) We all work on this amazing product [pro bono](https://en.wikipedia.org/wiki/Pro_bono). There is no sophisticated "runs on every conceivable environment" thing. What we use - and what works for us as developers working on O3 Shop: - Mac OS - [PhpStorm](https://www.jetbrains.com/de-de/phpstorm/) - [Colima](https://formulae.brew.sh/formula/colima) - GitHub -- of course Which means: Other environments most likely will work as well. Maybe they don't. We're happy if you want to join us to expand the developer's universe to more than what we use on a daily basis. Just drop us a note — or even better: open a pull request. The latter did not work very well in the past. That will change! ### Health Score 57 — FairBetter than 98% of packages Maintenance91 Actively maintained with recent releases Popularity30 Limited adoption so far Community32 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor2 2 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~24 days Recently: every ~6 days Total 50 Last Release 5d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/53b105106ade5f151851db1839b344f7be04f17d881c49ca0f4da0867d5b2d82?d=identicon)[o3-shop](/maintainers/o3-shop) --- Top Contributors [![nlo-tronet](https://avatars.githubusercontent.com/u/206915827?v=4)](https://github.com/nlo-tronet "nlo-tronet (184 commits)")[![o3-shop-user](https://avatars.githubusercontent.com/u/115017537?v=4)](https://github.com/o3-shop-user "o3-shop-user (99 commits)")[![ralftrapp](https://avatars.githubusercontent.com/u/74130839?v=4)](https://github.com/ralftrapp "ralftrapp (60 commits)")[![mketronet](https://avatars.githubusercontent.com/u/74709653?v=4)](https://github.com/mketronet "mketronet (23 commits)")[![OzoneMolecule](https://avatars.githubusercontent.com/u/127029014?v=4)](https://github.com/OzoneMolecule "OzoneMolecule (8 commits)")[![egate-media-Frank](https://avatars.githubusercontent.com/u/9710002?v=4)](https://github.com/egate-media-Frank "egate-media-Frank (3 commits)")[![egate-media-user](https://avatars.githubusercontent.com/u/23426088?v=4)](https://github.com/egate-media-user "egate-media-user (2 commits)")[![maexware-daniel](https://avatars.githubusercontent.com/u/59417594?v=4)](https://github.com/maexware-daniel "maexware-daniel (1 commits)") --- Tags moduleseshopO3-Shop ### Code Quality Static AnalysisRector Code StylePHP\_CodeSniffer ### Embed Badge ![Health badge](/badges/o3-shop-shop-ce/health.svg) ``` [![Health](https://phpackages.com/badges/o3-shop-shop-ce/health.svg)](https://phpackages.com/packages/o3-shop-shop-ce) ``` ### Alternatives [open-dxp/opendxp Content & Product Management Framework (CMS/PIM) 9421.6k62](/packages/open-dxp-opendxp)[oro/platform Business Application Platform (BAP) 645143.5k115](/packages/oro-platform)[chameleon-system/chameleon-base The Chameleon System core. 1028.6k5](/packages/chameleon-system-chameleon-base)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 585.6M578](/packages/shopware-core)[contao/core-bundle Contao Open Source CMS 1231.6M2.8k](/packages/contao-core-bundle)[pimcore/pimcore Content & Product Management Framework (CMS/PIM/E-Commerce) 3.8k3.8M508](/packages/pimcore-pimcore) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)