cleaniquecoders/splate

Web Application Boilerplate

Splate

A SaaS Boilerplate to speed up your SaaS Application Developement, _(*1)

Installation

Create new Splate project, _(*2)

composer create-project cleaniquecoders/splate

Update database connection and email configuration in .env., _(*3)

Login with Facebook

Configure Facebook App Details in the .env file and set the config/auth.php the oauth.facebook key to true to enable login with Facebook., _(*4)

Get the client id and secret from Facebook for Developers by creating application., _(*5)

FACEBOOK_CLIENT_ID=
FACEBOOK_SECRET=
FACEBOOK_REDIRECT=http://localhost:8000/auth/facebook/callback

You may want to refer to this tutorial if you have any issues with setting up the Facebook login., _(*6)

Login via API

API endpoint to login, using http method of POST. Login using email and password field., _(*7)

http://domain.com/api/auth

You should get something like this once you're successfully logged in., _(*8)

{"token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOjEsImlzcyI6Imh0dHA6XC9cL2xvY2FsaG9zdDo4MDAwXC9hcGlcL2F1dGgiLCJpYXQiOjE0NzY5NzMyOTAsImV4cCI6MTQ3Njk3Njg5MCwibmJmIjoxNDc2OTczMjkwLCJqdGkiOiJkYzY3NjMxOTQ3MzYzMmFjMjQ4ZDg0ODgzZTI1N2M3ZiJ9.k5b8ubtSTRi6T8_kqLbxzmN4atC2v4XKAvmyn4a2YEI"}

Themes

This web app boilerplate comes with pre-installed and configured with Laravel Theme by teeplus. Following are common commands can be use for theme development., _(*9)

Create a new theme

php artisan theme:create theme_name

Middleware

The teeplus/laravel-theme does not come with a middleware., _(*10)

With this middleware, you still can use return view('home.index') in your controller., _(*11)

Usage

Route::get('dashboard','HomeController@index')->middleware('theme');

OR, _(*12)

Route::get('dashboard','HomeController@index')->middleware('theme:theme_name,layout_name');

Assets and Components

To include assets, _(*13)

{{ Theme::asset()->container('footer')->add('delete-script', 'js/delete.js') }}

To include partials or components, _(*14)

{!! Theme::partial('components.checkboxes',['options' => $roles,'label' => 'Role', 'selected' => [], 'name' => 'role_id']) !!}

TODO

• [x] Require middleware to check if user not yet activate their account, redirect to resend activation account link
• [x] User Manager
• [x] Error pages - 403, 404, 500
• [ ] Laravel Passport, Consume Own API Middleware
• [ ] Migrate User Manager using VueJs
• [ ] Provide Installer for this boilerplate
• [x] Login with Facebook
• [x] JWT
• [x] Laravel Collective
• [ ] Support Themes