Install Capell
Choose the route that matches where you are starting, then create and verify your first page.
Choose your setup path
Choose an option to see its instructions below.
Coming later: generate a site from a written brief. This is in a closed rollout.
A new project
A complete site to run, read and change
The starter kit is a Laravel application with Core, Admin and Frontend pinned to released versions. It needs PHP 8.4+, Composer, SQLite and the Laravel installer; no Node build or queue worker. Open http://localhost:8000 for the site and /admin for Admin. Sign in as [email protected] with the password saved in storage/app/private/starter-admin-password, then store it securely and delete that file.
laravel new my-studio --using=capell-app/starter-kit
cd my-studio
php artisan serve
Your existing Laravel application
Keep control of your Laravel application
Capell installs as Laravel packages. Start with the guided setup for a clear first pass, or use the manual guide when your team wants to review every Composer and Artisan step.
Guided setup
RecommendedInstall the browser-based guide, choose the foundation packages, run setup in order and remove the installer when the application is ready.
Use guided setupManual Composer install
Follow the package-by-package guide when an experienced Laravel team wants direct control of the application diff.
Read the manual install guidecomposer require capell-app/installer
php artisan capell:install
Your Laravel Cloud account
Capell prepares the deployment; you remain the owner
Laravel Cloud hosts and deploys the application. Capell prepares the app, database, environment values and initial deployment inside the Laravel Cloud account you connect.
- Your organisation owns the Laravel Cloud account and infrastructure.
- Capell prepares the application, database, environment and initial deployment.
- Your organisation controls billing, access and ongoing operation.
Compatibility and package access
Capell Foundation source is public, and its packages are available through public Packagist releases. Public MIT-licensed Composer packages. Foundation packages require no Capell credentials.
Paid Marketplace packages need authenticated Composer access and an active entitlement. For packages sold by Capell, an active entitlement provides protected downloads, installs, updates and support. Versions already downloaded or installed remain usable after expiry under the applicable terms. Check other sellers’ listing terms.
What Capell changes in the application
Core adds the shared content model, Admin adds the place editors work, and Frontend connects published content to the public site. Review migrations, providers, configuration and public render hooks like any other Laravel pull request.
Verification and production reference
Verify that an editor can change one page and that an anonymous visitor receives only public HTML. Confirm that the admin loads, an editor can save a Page, and an anonymous visitor receives the public page without editor controls. Elapsed time depends on your host and network. Use the current install guide for production commands and Laravel Cloud environment guidance for hosted deployments.
Compatibility at a glance
Check the environment that will run your site. The starter kit needs PHP, Composer, SQLite and the Laravel installer.
| Requirement | What to check |
|---|---|
| PHP 8.4+ | Check with php -v in the environment that will actually run the application. |
| Laravel 13.x | Included in the starter kit, or the application you already run. |
| Filament 5.7.6+ (5.x) | Composer resolves the supported release; you do not pin it yourself. |
| Database | MySQL 8+, MariaDB 10.5+, PostgreSQL 16+ or SQLite. |
| Composer 2.7+ | Required to install the packages. |
| Node.js 20+ | Needed for the application asset build when you add Capell to an existing app. The starter kit runs without it. |
For PHP extensions, hosting and the full current requirements, see the installation guide.
Adding Capell to an existing Laravel application
Require the installer, run the guided command, build the frontend, then verify the result.
-
Require the installer
composer require capell-app/installerComposer updates composer.json and composer.lock and installs the installer and its dependencies under vendor. Review those dependency changes; Capell configuration and database setup begin when you run the installer in the next step. -
Run the installer
php artisan capell:installPrompts for the site URL, which packages to include, the theme, and your first admin user. - Sign in Visit /admin, edit one page, then load the public route to see it rendered.
Review the installer plan before accepting changes. If a step fails, fix the reported issue and run the installer again.
You will know it worked when
Three checks, in the order you can make them.
- The admin opens /admin shows the Filament panel with Pages in the navigation.
- A page edits Change a heading, save, and see a revision recorded against the page.
- The public route renders clean An anonymous request returns plain HTML with no editor scripts and no authoring state.
If something did not
- Migrations fail part-way through
- Check the database connection the application actually uses, then re-run php artisan capell:install. The installer is safe to run again.
- /admin returns 404
- Check that Admin was selected and installed, then check for a stale route cache. See the installation troubleshooting guide.
- The public page renders unstyled
- Check the generated frontend assets and run the host application asset build as described in the installation guide.
Verify three outcomes: the admin loads, an editor can save a Page, and an anonymous visitor receives the public page without editor controls.
Foundation (£0) covers Pages and history. Add Publishing Studio (£59 for 12 months) when Pages need review, scheduling or an atomic release, then choose individual packages or suites as needed. Paid prices are GBP before applicable tax and include standard support during the active term.
Choose the installation route that matches who will operate the Laravel application. Start with Capell Foundation, verify one editor-to-public path, then add optional capability only when the project needs it.
Next step
Install the foundation your team can keep
Start a new project, add Capell to an application you already run, or look around first.
Want to see Capell before installing? Open the read-only demo, or follow the quickstart to build a disposable site.