Local Development & Testing
This guide explains how to set up local path repositories for Capell and related packages, enabling rapid development and testing with symlinked sources.
When to Use
Section titled “When to Use”- Use these path repositories if you are actively developing Capell packages or want to test local changes before publishing.
- Not required for production or standard installs.
Composer Path Repositories Example
Section titled “Composer Path Repositories Example”Add the following to your composer.json under the repositories key:
"repositories": [ { "type": "path", "url": "../packages/capell-4/packages/*", "symlink": true },]- This will symlink all Capell packages from your local workspace into your Laravel project.
- After updating
composer.json, run:
composer update- Ensure your local paths are correct relative to your Laravel project root.
- If you are setting up the host and add-on repositories from scratch, follow Creating the Capell 4.x Monorepo Branches first.
- Symlinks allow instant reflection of code changes without reinstalling packages.
- For VCS repositories and other dependencies, see the main install guide in README.md.
Troubleshooting
Section titled “Troubleshooting”- If packages are not detected, check your path and symlink permissions.
- If you see autoload errors, run
composer dump-autoload. - For cache issues, see Server Configuration and the Frontend guide.
Further Reading: