Larasonic - Modern Laravel SaaS Starter Kit (Docs)

✨ Prerequisites

Ensure the following tools are installed on your system before starting:

🚀 Installation

Install with Laravel Sail + Docker (Recommended)

Laravel Sail provides an easy way to start your Larasonic development environment with Docker.

First-time Setup

Clone the Repository:

git clone git@github.com:pushpak1300/Larasonic.git
cd Larasonic

Install Composer Dependencies:

docker run --rm \
    -u "$(id -u):$(id -g)" \
    -v "$(pwd):/var/www/html" \
    -w /var/www/html \
    laravelsail/php83-composer:latest \
    composer install --ignore-platform-reqs

Set Up Environment Variables:
```
cp .env.example .env
```
Start Laravel Sail:
```
./vendor/bin/sail up -d
```
Run Setup Script:
```
./vendor/bin/sail composer run setup
```

For detailed documentation on Laravel Sail, visit: Laravel Sail Documentation

Optional: Shell Alias for Sail

Add this alias to ~/.bashrc or ~/.zshrc for convenience:

alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'

Install with Laravel Herd

Laravel Herd provides a lightweight local environment for PHP development.

Steps for Herd Installation

Clone the Repository in Herd Sites Directory:

git clone git@github.com:pushpak1300/Larasonic.git ~/Herd/larasonic

Visit in Browser: Open your browser and navigate to:
```
larasonic.test
```

Follow the manual installation steps below to complete the setup.

Manual Installation (Advanced)

If you prefer not to use Docker or Herd, you can set up Larasonic manually.

Steps for Manual Setup

Clone the Repository:

git clone git@github.com:pushpak1300/Larasonic.git
cd Larasonic

Install Composer Dependencies:
```
composer install
```
Set Up Environment Variables:
```
cp .env.example .env
```
Setup Application:
- You need to change the database credentials in the .env file.
```
composer run setup
```
Serve the Application:
- Using Octane:
  php artisan octane:start --watch
- Using the built-in PHP server:
  composer run dev

Your application will now be available at http://127.0.0.1:8010.

Once you’ve installed Larasonic using your preferred method, you’re ready to start building! For additional configuration and advanced features, explore the rest of the documentation.

🔒 Logging into your Application

After installing Larasonic, you can use the following credentials:

email: test@example.com
password: password

Get Started

Features

Deployment Guides

Larasonic Installation Guide

✨ Prerequisites

🚀 Installation

First-time Setup

Optional: Shell Alias for Sail

Steps for Herd Installation

Steps for Manual Setup

🔒 Logging into your Application

Get Started

Features

Deployment Guides

​✨ Prerequisites

​🚀 Installation

​🔒 Logging into your Application

✨ Prerequisites

🚀 Installation

🔒 Logging into your Application