This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

Web Application Boilerplate

v1.0.0 2016-12-06 11:41 UTC

This package is auto-updated.

Last update: 2021-05-29 01:03:20 UTC


README

A SaaS Boilerplate to speed up your SaaS Application Developement

Installation

Create new Splate project

composer create-project cleaniquecoders/splate

Update database connection and email configuration in .env.

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.

Get the client id and secret from Facebook for Developers by creating application.

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.

Login via API

API endpoint to login, using http method of POST. Login using email and password field.

http://domain.com/api/auth

You should get something like this once you're successfully logged in.

{"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.

Create a new theme

php artisan theme:create theme_name

Middleware

The teeplus/laravel-theme does not come with a middleware.

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

Usage

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

OR

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

Assets and Components

To include assets

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

To include partials or components

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

TODO

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