Skip to content

Latest commit

 

History

History
179 lines (119 loc) · 6.15 KB

README.md

File metadata and controls

179 lines (119 loc) · 6.15 KB

Laravel Starter - A CMS like modular starter project built with Laravel

Laravel Starter (based on Laravel 9.x)

Laravel Starter is a Laravel 9.x based simple starter project. Most of the commonly needed features of an application like Authentication, User and Role management Application Backend, Backup, Logviewer are available here. It is modular, so you can use this project as a base and build your own modules. You can use the same module in any of the Laravel Starter based projects.

Please let me know your feedback and comments.

Reporting a Vulnerability

If you discover any security related issues, please send an e-mail to Nasir Khan Saikat via [email protected] instead of using the issue tracker.

Appplication Demo

Check the following demo project. It is just a straight installation of the project without any modification.

Demo URL: http://laravel.nasirkhn.com

User: [email protected]
Pass: secret

User: [email protected]
Pass: secret

Demo Data

If you want to test the application on you local with additional demo data you may use the following command. By using this you can truncate the posts, categories, tags and comments table and insert new demo data.

--fresh option will truncate the tables, without this command new set to data will be inserted only.


php artisan starter:insert-demo-data --fresh

Custom Commands

We have created a number of custom commands for the project. The commands are listed below with a brief about the use of it.

Create New module

To create a project use the following command, you have repalce the MODULE_NAME with the name of the module.

php artisan module:build MODULE_NAME

You may want to use --force option to overwrite the existing module. if you use this option, it will replace all the exisitng files with the defalut stub files.

php artisan module:build MODULE_NAME --force

Clear All Cache

composer clear-all

this is a shortcut command clear all cache including config, route and more

Code Style Fix

composer pint

apply the code style fix by this command. This command uses the Laravel Pint package: https://laravel.com/docs/10.x/pint

Role - Permissiosn

A number of custom commands are available to add and update role-permissions. Please read the Role - Permission Wiki page, where you will find the list of commands with examples.

Features

The Laravel Starter comes with a number of features which are the most common in almost all the applications. It is a template project which means it is intended to build in a way that it can be used for other projects.

It is a modular application, and a number of modules are installed by default. It will be helpful to use it as a base for the future applications.

  • Admin feature and public views are completely separated as Backend and Frontend namespace.
  • Major feature are developed as Modules. Module like Posts, Comments, Tags are separated from the core features like User, Role, Permission

Core Features

  • User Authentication
  • Social Login
    • Google
    • Facebook
    • Github
    • Build in a way adding more is much easy now
  • User Profile with Avatar
    • Separate User Profile table
  • Role-Permissions for Users
  • Dynamic Menu System
  • Language Switcher
  • Localization enable across the porject
  • Backend Theme
    • Bootstrap 5, CoreUI
    • Fontawesome 6
  • Frontend Theme
    • Tailwind
    • Fontawesome 5
  • Article Module
    • Posts
    • Categories
    • Tags
    • Comments
    • wysiwyg editor
    • File browser
  • Application Settings
  • External Libraries
    • Bootstrap 5
    • Fontawesome 6
    • CoreUI
    • Tailwind
    • Datatables
    • Select2
    • Date Time Picker
  • Backup (Source, Files, Database as Zip)
  • Log Viewer
  • Notification
    • Dashboard and details view

User Guide

Installation

Follow the steps mentioned below to install and run the project. You may find more details about the installation in Installation Wiki.

  1. Clone or download the repository
  2. Go to the project directory and run composer install
  3. Create .env file by copying the .env.example. You may use the command to do that cp .env.example .env
  4. Update the database name and credentials in .env file
  5. Run the command php artisan migrate --seed
  6. Link storage directory: php artisan storage:link
  7. You may create a virtualhost entry to access the application or run php artisan serve from the project root and visit http://127.0.0.1:8000

After creating the new permissions use the following commands to update cashed permissions.

php artisan cache:forget spatie.permission.cache

Docker and Laravel Sail

This project is configured with Laravel Sail (https://laravel.com/docs/9.x/sail). You can use all the docker functionalities here.

Icons

FontAwesome & CoreUI Icons, two different font icon library is installed for the Backend theme and only FontAwesome for the Frontend. For both of the cases we used the free version. You may install the pro version separately for your own project.

Screenshots

Home Page

Laravel Starter Home

Login Page

Laravel Starter Login

Posts Page

Laravel Starter Posts Page

Backend Dashboard

Backend Dashboard


List-Posts-Laravel-Starter


Edit-Posts-Laravel-Starter