(WIP) Kickstart - A SaaS Laravel Boilerplate

Introduction

A very opinionated Laravel SPA boiletplate using Laravel 7.x + Sanctum / Typescript / Vue (VueRouter - Vuex) / TailwindCSS / Pest & Cypress

Features / ToDo:

Check the .todo file for the current feature set.

Prerequisites

• PHP 7.3
• Composer
• Node
• A laravel developer: You must be familiar with laravel. This distribution is intended for developers only.

Installation

• Clone the repository
• Installer back dependencies with composer install
• Install front dependencies with yarn
• Copy file .env.example in .env and add following informations:
  • Database credentials (DB_HOST, DB_PORT, ...)
  • Application url (APP_URL). Either virtual host address if you configure one, either address form the command php artisan serve
• Generate application key with php artisan key:generate
• Launch migrations with php artisan migrate.
• Build front with yarn dev

If you didn't set a virtual host, launch application with the php artisan serve command. By default, application will be served at http://127.0.0.1:8000

Configuration

Testing

Pest

Cypress

Docker

Standalone

CapRover Ready

CI / CD

Github Actions

Issues

If you come across any issues please report them here.

Contributing

Thank you for considering contributing to this project! Please feel free to make any pull requests, or e-mail me a feature request you would like to see in the future to anas.mazouni@stormix.co

Security Vulnerabilities

If you discover a security vulnerability within this boilerplate, please send an e-mail to anas.mazouni@stormix.co, or create a pull request if possible. All security vulnerabilities will be promptly addressed.