Skip to content

Quickstart Guide

Follow this guide to get up and running with the workshop environment in the fastest way possible.

Prerequisites

Before you begin, ensure you have the following installed:

You can install the necessary PHP and Laravel components on MacOS with the following command

Terminal window
/bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"

Additionally, you’ll need a Sentry account to follow along with the error monitoring portions of this workshop:

Setup Instructions

  1. Clone the repository

    Terminal window
    git clone https://github.com/nikolovlazar/errorfix-laravel
  2. Navigate to the project directory

    Terminal window
    cd errorfix-laravel
  3. Install PHP dependencies

    Terminal window
    composer install
  4. Install Node dependencies

    Terminal window
    npm install
  5. Set up environment

    Terminal window
    cp .env.example .env
    php artisan key:generate
  6. Prepare the database

    Terminal window
    touch database/database.sqlite
    php artisan migrate:fresh
    php artisan db:seed
  7. Build frontend assets

    Terminal window
    npm run build
  8. Start the development server (SSR mode)

    Terminal window
    composer dev:ssr

What’s Available After Setup

Once you’ve completed the setup, you’ll have access to:

  • Unborked - A React frontend with Laravel/PHP backend
  • Local development environment running at http://localhost:8000
  • A seeded database that has all the items from the store

This setup will allow you to progress in the workshop and start digging into the issues in the application.

Next Steps

Once your environment is running, head to the Code Breaks module to start learning how to identify and fix errors using Sentry.