An open API service indexing awesome lists of open source software.

https://github.com/faisalfjri/breeze-react-api

An application / authentication starter kit frontend in React.js for Laravel Breeze.
https://github.com/faisalfjri/breeze-react-api

authentication breeze laravel reactjs

Last synced: 17 days ago
JSON representation

An application / authentication starter kit frontend in React.js for Laravel Breeze.

Awesome Lists containing this project

README

        

# Laravel Breeze - React.js Edition 🏝️

## Inspiration

This project was inspired by the [Breeze Next.js](https://github.com/laravel/breeze-next) project. 🏝️

## Introduction

This repository is an implementing of the [Laravel Breeze](https://laravel.com/docs/starter-kits) application / authentication starter kit frontend in [React.js](https://reactjs.org). All of the authentication boilerplate is already written for you - powered by [Laravel Sanctum](https://laravel.com/docs/sanctum), allowing you to quickly begin pairing your beautiful React.js frontend with a powerful Laravel backend.

## Documentation

### Installation

First, create a React.js compatible Laravel backend by installing Laravel Breeze into a [fresh Laravel application](https://laravel.com/docs/installation) and installing Breeze's API scaffolding:

```bash
# Create the Laravel application...
laravel new breeze-backend

cd breeze-backend

# Install Breeze and dependencies...
composer require laravel/breeze --dev

php artisan breeze:install api
```

Next, ensure that your application's `APP_URL` and `FRONTEND_URL` environment variables are set to `http://localhost:8000` and `http://localhost:3000`, respectively.

After defining the appropriate environment variables, you may serve the Laravel application using the `serve` Artisan command:

```bash
# Serve the application...
php artisan serve
```

Next, clone this repository and install its dependencies with `yarn install` or `npm install`. Then, copy the `.env.example` file to `.env` and supply the URL of your backend:

```
VITE_APP_BACKEND_URL=http://localhost:8000
```

Finally, run the application via `npm run dev`. The application will be available at `http://localhost:3000`:

```
npm run dev
```

> Note: Currently, we recommend using `localhost` during local development of your backend and frontend to avoid CORS "Same-Origin" issues.

## License

Laravel Breeze React is open-sourced software licensed under the [MIT license](LICENSE.md).