SaasForgeKit Docs

Appearance

Installing SaasForgeKit on macOS ​

This guide walks you through setting up SaasForgeKit on macOS 12+.

We recommend using Laravel Herd for macOS. It bundles PHP, Composer, and a zero-config local server for Laravel applications.

WARNING

Complete Tenancy Mode setup before running migrations.

Laravel Herd ​

Download and install Herd from the official Herd website.

After installation, complete the onboarding flow. Herd parks projects under ~/Herd by default, and apps inside this directory are served automatically on the .test domain.

Install SaasForgeKit ​

  1. Locate the saasforgekit.zip archive from your CodeCanyon download.
  2. Extract the archive (for example to SaasForgeKit-main).
  3. Rename the extracted folder to saasforgekit.
  4. Move it into your Herd directory.
  5. Open Terminal and navigate to the project folder:
bash
cd ~/Herd/saasforgekit

Run the built-in setup script:

bash
composer run setup

This command installs PHP dependencies, creates .env, generates an app key, runs migrations, installs npm dependencies, and builds frontend assets.

Optional: manual setup steps ​

If you prefer to run each step manually:

bash
composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
npm install
npm run build

Start development ​

bash
composer run dev

This starts the app server, queue worker, log stream, and Vite dev server.

Visit the site ​

Open:

text
http://saasforgekit.test

Default admin login ​

If you seeded the database, the default admin account is:

Email:

text
[email protected]

Password:

text
password

Database notes ​

For tenancy mode configuration, see Tenancy Mode (Required). For local development, SQLite or MySQL are both valid options. Configure your database connection in .env as needed.