Skip to content

Commit 4f42d44

Browse files
- Update composer details and readme for the project configuration
1 parent 5e879d9 commit 4f42d44

File tree

2 files changed

+35
-8
lines changed

2 files changed

+35
-8
lines changed

composer.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
{
2-
"name": "ftx/laravel-starter",
2+
"name": "ftx/laravel-adminpanel",
33
"type": "project",
4-
"description": "The Laravel Starter Project.",
4+
"description": "The Laravel AdminPanel with API Boilerplate.",
55
"keywords": [
66
"framework",
77
"laravel",
88
"boilerplate"
99
],
1010
"license": "MIT",
1111
"require": {
12-
"php": "^7.2",
12+
"php": "^7.3",
1313
"albertcht/invisible-recaptcha": "^1.9",
1414
"altek/accountant": "^1.2",
1515
"altek/eventually": "^1.0",

readme.md

Lines changed: 32 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,13 @@
99
![GitHub stars](https://img.shields.io/github/stars/rappasoft/laravel-boilerplate.svg?style=social)
1010

1111
### Introduction
12-
12+
---
1313
Laravel Starter provides you with a massive head start on any size web application. It comes with a full featured access control system out of the box with an easy to learn API and is built on a Bootstrap foundation with a front and backend architecture. We have put a lot of work into it and we hope it serves you well and saves you time!
1414

15-
MIT: [http://anthony.mit-license.org](http://anthony.mit-license.org)
15+
*MIT: [http://anthony.mit-license.org](http://anthony.mit-license.org)*
1616

1717
### Setup
18+
---
1819
Clone the repo and follow below steps.
1920
1. Run `composer install`
2021
2. Copy `.env.example` to `.env` Example for linux users : `cp .env.example .env`
@@ -28,11 +29,29 @@ Clone the repo and follow below steps.
2829

2930
Thats it... Run the command `php artisan serve` and cheers, you are good to go with your new **Laravel Starter** application.
3031

32+
33+
### Using docker to run the application
34+
---
35+
1. `docker-compose build`
36+
2. `docker/cli composer install`
37+
3. `docker/cli php artisan key:generate`
38+
4. `docker/cli php artisan migrate`
39+
5. `docker/cli php artisan passport:install`
40+
6. `docker/cli php artisan db:seed`
41+
7. `docker/npm i`
42+
8. `docker/npm run dev`
43+
9. `docker-compose up -d`
44+
45+
You can login to docker cli using the command `docker exec -ti ls-www /bin/bash`
46+
47+
*Note: Please make sure that you have proper permissions when setting up the project via docker.*
48+
49+
---
3150
The application uses [GrumPHP](https://github.com/phpro/grumphp) for the git pre-commit hook and [PHPCSFixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer) for the code standards. You can also bypass the `GrumPHP` pre-commit hook by hitting `git commit -n` or `git commit --no-verify`
3251

3352
### Demo Credentials
34-
35-
Make sure you have run the command `php artisan db:seed --class UserTableSeeder` before you use these credentials.
53+
---
54+
*Make sure you have run the command `php artisan db:seed --class UserTableSeeder` before you use these credentials.*
3655

3756
**User:** admin@admin.com\
3857
**Password:** 1234
@@ -41,4 +60,12 @@ Make sure you have run the command `php artisan db:seed --class UserTableSeeder`
4160
**Password:** 1234
4261

4362
**User:** user@user.com\
44-
**Password:** 1234
63+
**Password:** 1234
64+
65+
### Useful Commands
66+
---
67+
+ To format your code: `composer format`
68+
+ To run the test cases: `./vendor/bin/phpunit`
69+
+ The test cases report will be placed in the `reports` directory
70+
+ To generate scribe API documentation: `php artisan scribe:generate`
71+
+ Documentation will be generated and placed in the `public/docs` directory

0 commit comments

Comments
 (0)