Ressonance API

This project is the backend API for the Ressonance application, built with the Laravel framework.

Getting Started

You can run this project using either Laravel Sail (our recommended Docker-based environment) or by setting up a local development environment on your machine.

Prerequisites

Before you begin, ensure you have the following installed:

For Laravel Sail (Docker):

• Docker Desktop

For Local Environment:

• PHP 8.3 or higher
• Composer
• Node.js & npm
• A database server (MySQL)

---

Option 1: Running the Project with Laravel Sail (Recommended)

Laravel Sail provides a simple command-line interface for interacting with Laravel's default Docker development environment.

1. Clone the Project

git clone https://github.com/ressonancia/api ressonance-api
cd ressonance-api

2. Install Composer Dependencies This command runs a temporary Docker container to install the required PHP packages.

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. Build and Run the Sail Containers This will build the necessary Docker images and start the services in the background.

./vendor/bin/sail up -d

Note: You can create a shell alias to make sail easier to use: alias sail='[ -f sail ] && bash sail || bash vendor/bin/sail'

4. Set Up Environment File Copy the example environment file and generate the application key.

cp .env.example .env
sail artisan key:generate

5. Install Laravel Passport Keys This command creates the encryption keys needed for generating access tokens.

sail artisan passport:keys --force

6. Run Database Migrations This will create the necessary tables in your database.

sail artisan migrate

7. Run the Development Server The API will be available at http://localhost.

---

Option 2: Running the Project on Your Local Machine (macOS, Windows, or Linux)

If you prefer not to use Docker, you can set up the project directly on your machine.

1. Clone the Project

git clone https://github.com/ressonancia/api ressonance-api
cd ressonance-api

2. Install Composer Dependencies

composer install

3. Set Up Environment File Copy the example .env file.

cp .env.example .env

Next, open the .env file and configure your database connection details (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD).

4. Generate Application Key

php artisan key:generate

5. Install Laravel Passport Keys

php artisan passport:keys --force

6. Run Database Migrations

php artisan migrate

7. Start the Development Server This command starts the local PHP server. By default, it will be available at http://localhost:8000.

php artisan serve

In a separate terminal, run the Vite development server for frontend assets:

npm run dev

Now your API is up and running! You can access it at the local server address.