Installation
This page gets the code onto your machine. For the full first run (database, seeding, tenants, dev server), Local development goes into more detail.
Repository access → clone → composer install + .env → migrate and seed → npm install → open APP_URL1. Get repository access
Once you've bought a kit, your GitHub account gets an automatic invite to its repository. See Repository access.
2. Clone the kit
git clone https://github.com/the-erag/saas-laravel-starter-kit-vue.git vue
cd vuegit clone https://github.com/the-erag/saas-laravel-starter-kit-react.git react
cd reactgit clone https://github.com/the-erag/saas-laravel-starter-kit-svelte.git svelte
cd sveltegit clone https://github.com/the-erag/saas-laravel-starter-kit-livewire.git livewire
cd livewireKeep updates easy
Rename the kit remote to upstream straight away and push to your own repository as origin. Weekly updates then come down to a simple merge. See Updates.
git remote rename origin upstream
git remote add origin git@github.com:your-org/my-saas.git3. Install and configure
composer install
cp .env.example .env
php artisan key:generateEdit .env (at least APP_URL, APP_DOMAIN and the DB_* keys) and create the database. Then run:
php artisan migrate --seed
npm installLocal development walks through each of these steps.
One-command setup
composer setup handles most of the steps above in one go:
| Step | Command |
|---|---|
| Install PHP dependencies | composer install |
Create .env (only if it does not exist) | copies .env.example |
| App key | php artisan key:generate |
| Central migrations | php artisan migrate --force |
| Frontend | npm install, npm run build |
No seeding
composer setup does not seed the database, and it migrates with whatever is in .env at the time. So create and edit .env first, create the database, run composer setup, and then run php artisan db:seed.
Open the app
If you use Herd, link the project to the domain you set in APP_DOMAIN:
herd link vue # serves this folder as vue.test and *.vue.testNow open APP_URL (for example http://vue.test) and sign in as a seeded user.