Skip to content

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.

  • 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.

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:
Terminal window
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.
  • 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: