Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/maijied/laravel8-angular15-boilerplate-using-jwt


https://github.com/maijied/laravel8-angular15-boilerplate-using-jwt

Last synced: 14 days ago
JSON representation

Awesome Lists containing this project

README

        

# Angular 15 & Laravel 8 Boilerplate

![Build Status](https://img.shields.io/badge/build-passing-brightgreen)
![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
![Version](https://img.shields.io/badge/version-1.0.0-blue)

This boilerplate provides a quick start for projects using Angular 15 as the front-end framework and Laravel 8 for the back-end API. This setup is crafted to accelerate the development process, ensuring that you have all essential configurations and libraries at your fingertips.

## Features

- **Angular 15**: Robust front-end framework for building client-side applications.
- **Laravel 8**: A PHP framework for web artisans, ideal for building robust APIs.
- **JWT Authentication**: Pre-configured JSON Web Token (JWT) for secure authentication.
- **Docker Support**: Easy deployment using Docker containers.
- **Code Splitting**: Improved performance with Angular lazy loading.
- **RESTful API**: Laravel-based back-end API following REST principles.

## Prerequisites

Ensure you have the following installed on your system:

- Node.js (14.x or higher)
- PHP (7.4 or higher)
- Composer
- Docker (optional)

## Installation

### Front-end (Angular)

1. Navigate to the `frontend` directory.
2. Run `npm install` to install the dependencies.
3. Run `ng serve` to start the development server.
4. Open `http://localhost:4200/` in your browser.

### Back-end (Laravel)

1. Navigate to the `backend` directory.
2. Run `composer install` to install the dependencies.
3. Configure your `.env` file for the database and other settings.
4. Run `php artisan migrate` to set up the database.
5. Run `php artisan serve` to start the development server.
6. The API will be available at `http://localhost:8000/api`.

## Usage

Describe how the boilerplate can be used, customized, or extended for various projects.

## Documentation

Provide links or references to the detailed documentation if available.

## Contributing

1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Make your changes.
4. Commit your changes (`git commit -am 'Add new feature'`).
5. Push to the branch (`git push origin feature-branch`).
6. Create a new Pull Request.

## Support

For questions or issues, please open an issue in the repository, and we will address it as soon as possible.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.