Laravel Inertia ReactJs Starter

This is a starter template/project for an admin dashboard with built-in user authentication.

Table of Contents

1. About The Project
   • Built With
2. Screenshot
3. Roadmap
4. Getting Started
   • Prerequisites
   • Installation
5. Usage
6. Contributing
7. License
8. Contact
9. Acknowledgments

About The Project

Built With

• Laravel 9
• React.js
• Bootstrap 5
• Inertia
• Argon Dashboard 2
• Laravel Socialite

Screenshoot

Login	Register	Landing Page

Dashboard	Manage User	Profile Page

Roadmap

• Integrations Argon Dashboard 2 HTML template to ReactJs
• Multiple layout (Guest, Base, Auth)
• Authentication
  • Sign in
  • Register
  • Google Sign in
• User Management
• Profile
• Activity Log
• Roles and Permissions

See the open issues for a full list of proposed features (and known issues).

Getting Started

Get a local copy (clone the repo)

Prerequisites

install Composer & NodeJs

• Composer
• Node Js

Installation

1. Clone the repo

   git clone https://github.com/jbratcher/laravel9-inertiajs-reactjs-starter.git

2. Install dependency Laravel

   composer install

3. Install NPM packages

   npm install
   npm run dev

4. Run php artisan key:generate

5. Copy .env.example to .env

   cp .env.example .env

6. Add your database table information

   DB_DATABASE=yourdatabase_name
   DB_USERNAME=your_username
   DB_PASSWORD=your_password

7. Run migration & Seeder

   php artisan migrate --seed

8. Add your Google Oauth credentials | Guide

    GOOGLE_CLIENT_ID='your_client_id'
    GOOGLE_CLIENT_SECRET='your_client_secret'
    GOOGLE_REDIRECT='your_callback_url'

Usage

1. run server-side (Laravel)

   php artisan serve

2. See webpack.min js

   mix.browserSync('your_url.test'); //if using Laravel Valet
   mix.browserSync('127.0.0.1:8000'); //if using artisan serve

3. run client-side (ReactJs)

   npm run hot

4. Default login credentials (database\factories\UserFactory.php)

   email: admin@example.com
   password: 12345

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Acknowledgments

This project is an extention of the work of agungksidik