Larasonic Installation Guide

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

First-time Setup

1. Clone the Repository:

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

2. 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
   

3. Set Up Environment Variables:

   cp .env.example .env
   

4. Start Laravel Sail:

   ./vendor/bin/sail up -d
   

5. 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'

Laravel Herd provides a lightweight local environment for PHP development.

Steps for Herd Installation

1. Clone the Repository in Herd Sites Directory:

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

2. Visit in Browser: Open your browser and navigate to:

   larasonic.test
   

Follow the manual installation steps below to complete the setup.

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

Steps for Manual Setup

1. Clone the Repository:

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

2. Install Composer Dependencies:

   composer install
   

3. Set Up Environment Variables:

   cp .env.example .env
   

4. Setup Application:

   • You need to change the database credentials in the .env file.

   composer run setup
   

5. 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.