LaravelFS was born from the idea of "Laravel Full Starter Kits" (or Full Stack) LOL – a way to bring back the legacy starter kits like Breeze and Jetstream that were removed from the official Laravel Installer, while still supporting the new Laravel 12 starter kits and custom solutions via Composer.
🚨 Disclaimer: This installer is not officially supported by the Laravel team. It's a community-driven alternative that extends the Laravel Installer by supporting abandoned starter kits like Breeze and Jetstream, as well as allowing custom starter kits via Composer.
We strive to keep it up-to-date with Laravel's official installer while offering extended flexibility. 🚀
LaravelFS functions similarly to the Laravel Installer but with extra capabilities.
✅ Install Laravel projects just like the official installer.
✅ Support for Breeze and Jetstream, even if they are abandoned.
✅ Install custom starter kits from Packagist.
✅ Save and reuse project setups with Templates.
✅ Easily remove saved templates when no longer needed.
✅ Ensure that provided starter kits are Composer packages of type project.
✅ CLI command to fetch additional details about a starter kit package.
📖 For Laravel's official installation guide, refer to the Laravel documentation.
To install LaravelFS globally, run:
composer global require hichemtab-tech/laravelfsMake sure ~/.composer/vendor/bin (Mac/Linux) or %USERPROFILE%/AppData/Roaming/Composer/vendor/bin (Windows) is in your system's PATH to use the laravelfs command globally.
LaravelFS works similarly to the Laravel Installer. You can create a new project using:
laravelfs new my-projectTo create a Laravel project with Breeze or Jetstream, use:
laravelfs new my-project --breeze
laravelfs new my-project --jetEven if these starter kits are abandoned, LaravelFS ensures they remain available for installation.
Tired of typing the same options for every new Laravel project? With LaravelFS Templates, you can save your preferred project setup and reuse it anytime!
To create a reusable template, use:
laravelfs template:new my-templateThis will prompt you the same way as laravelfs new, but instead of creating a project, it saves your setup as a template.
📝 Templates include:
- Selected starter kits (Breeze, Jetstream, Vue, React, Livewire)
- Custom starter-kit options
- Extra flags like
--typescript,--ssr,--api, etc.
List all saved templates:
laravelfs templatesOr view a specific template:
laravelfs template:show my-templateOnce saved, you can use your template anytime:
laravelfs use my-template my-projectThis runs the exact same command as if you typed everything manually!
Need to clean up your templates? You can easily remove them.
To delete a single template:
laravelfs template:remove my-templateTo remove all saved templates at once:
laravelfs template:remove --all
⚠️ This action is irreversible! Make sure you want to delete all templates before running this command.
LaravelFS allows you to install custom Laravel starter kits from Packagist by providing the package name:
laravelfs new my-project --custom-starter=hichemtab-tech/forked-from-react-starter-kit🔹 What qualifies as a Laravel starter kit?
A starter kit must meet the following requirements:
- It must be a Composer package of type
project. - It must be published on Packagist (Submit your package here).
- It should provide a full Laravel project setup.
- Check this repo for a reference Forked from React Starter Kit
If you installed LaravelFS but can’t run the laravelfs command,
it might be because Composer's global bin folder is not in your system's PATH.
1️⃣ Open your terminal and edit the ~/.bashrc file:
nano ~/.bashrc(If needed, use sudo nano ~/.bashrc)
2️⃣ Add this line at the bottom of the file:
export PATH="$PATH:$HOME/.config/composer/vendor/bin"3️⃣ Save the file (CTRL + X, then Y, then Enter).
4️⃣ Apply the changes:
source ~/.bashrc✅ Now, try running laravelfs again—it should work! 🚀
Thank you for considering contributing to LaravelFS! We welcome contributions to improve the installer and keep it updated. Please submit issues and pull requests to the GitHub repository.
To ensure LaravelFS remains a welcoming project, please review and abide by our Code of Conduct.
If you discover a security vulnerability, please open an issue or contact the maintainers.
LaravelFS is open-source software licensed under the MIT license.
