base on A CMS like modular starter application project built with Laravel 11.x. <p align="center"><img src="https://user-images.githubusercontent.com/396987/82162573-6940f500-98c7-11ea-974e-888b4f866c74.jpg" alt="Laravel Starter - A CMS like modular starter project built with the latest Laravel framework."></p> # Laravel Starter (based on Laravel 11.x) **Laravel Starter** is a Laravel 11.x based simple starter project. Most of the commonly needed features of an application like `Authentication`, `Authorisation`, `Users` and `Role management`, `Application Backend`, `Backup`, `Log viewer` are available here. It is modular, so you may use this project as a base and build your own modules. A module can be used in any `Laravel Starter` based project. Here Frontend and Backend are completely separated with separate routes, controllers, and themes as well. ***Please let me know your feedback and comments.*** [](https://packagist.org/packages/nasirkhan/laravel-starter) [](https://packagist.org/packages/nasirkhan/laravel-starter) [](https://packagist.org/packages/nasirkhan/laravel-starter) [](https://packagist.org/packages/nasirkhan/laravel-starter) # 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: https://laravel.nasirkhn.com You may use the following account credentials to access the application backend. ``` User: [email protected] Pass: secret User: [email protected] Pass: secret ``` ## Demo Data If you want to test the application on your local machine with additional demo data you may use the following command. ```php php artisan laravel-starter:insert-demo-data ``` There are options to truncate the `posts, categories, tags, and comments` tables and insert new demo data. `--fresh` option will truncate the tables, without this command a new set of data will be inserted. ```php php artisan laravel-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 their use of it. ## Create New module To create a project use the following command, you have to replace the MODULE_NAME with the name of the module. ```php 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 existing files with the default stub files. ```php php artisan module:build MODULE_NAME --force ``` ## Clear All Cache ```bash composer clear-all ``` this is a shortcut command to clear all cache including config, route, and more ## Code Style Fix We are now using `Laravel Pint` to make the code style stay as clean and consistent as the Laravel Framework. Use the following command to apply CS-Fix. ```bash composer pint ``` Along with Laravel Pint, we are using `prettier` to format the blade templates. You can install the `prettier` extension in your favorite editor. The following command will format the blade templates. ```bash npm run format ``` or if you are using `yarn` then you can use the following command. ```bash yarn format ``` ## Role - Permissions Several custom commands are available to add and update `role-permissions`. Please read the [Role - Permission Wiki page](https://github.com/nasirkhan/laravel-starter/wiki/Role-Permission), where you will find the list of commands with examples. # Features The `Laravel Starter` comes with several features which are the most common in almost all applications. It is a template project which means it is intended to be built in a way that it can be used for other projects. It is a modular application, and some modules are installed by default. It will be helpful to use it as a base for future applications. * Admin feature and public views are completely separated as `Backend` and `Frontend` namespace. * Major features are developed as `Modules`. A module like Posts, Comments, and 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 easier now * User Profile with Avatar * Role-Permissions for Users * Dynamic Menu System * Language Switcher * Localization enabled across the project * Backend Theme * Bootstrap 5, CoreUI * Fontawesome 6 * Dark Mode * Frontend Theme * Tailwind * Fontawesome 6 * Dark Mode * 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](https://github.com/nasirkhan/laravel-starter/wiki/Installation). 1. Open the terminal and run the following command, this will download and install the `Laravel Starter` and run the post-installation commands. ```bash composer create-project nasirkhan/laravel-starter ``` 2. The default database is `sqlite`, if you want to change please update the database settings at `.env` file 3. To create a link from the storage directory, run the following command from the project root: ```php php artisan storage:link ``` 4. If you run the `create-project` command from `Laravel Hard` then the site will be available at [http://laravel-starter.test](http://laravel-starter.test). 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/sail). You can use all the docker functionalities here. To install using docker and sail: 1. Clone or download the repository 2. Go to the project directory and run `composer install` 3. Create `.env` file by copying the `.env-sail`. You may use the command to do that `cp .env-sail .env` 4. Update the database name and credentials in `.env` file 5. Run the command `sail up` (consider adding this to your alias: `alias sail='[ -f sail ] && sh sail || sh vendor/bin/sail'`) 6. Run the command `sail artisan migrate --seed` 7. Link storage directory: `sail artisan storage:link` 8. Since Sail is already up, you can just visit http://localhost:80 # Screenshots __Home Page__   __Login Page__  __Posts Page__  __Backend Dashboard__   ---  ---  ", Assign "at most 3 tags" to the expected json: {"id":"9701","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"