Skip to content

Commit 4dcf96d

Browse files
committed
docs: update README.md
1 parent ae8ee19 commit 4dcf96d

File tree

1 file changed

+68
-2
lines changed

1 file changed

+68
-2
lines changed

README.md

Lines changed: 68 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,30 @@
11
# Laravel Onion MVC Architecture
22

3+
This repository serves as a dedicated space for crafting Laravel Onion templates, adhering to the foundational principles of the Model-View-Controller (MVC) architecture. It is designed to streamline the process of creating organized and scalable web applications. The goal is to provide a focused environment that simplifies the development of well-structured projects within the Laravel framework. By offering this dedicated space, the aim is to enhance efficiency in the development process, resulting in robust and scalable web applications.
4+
35
# Prerequisites
46

57
- https://classic.yarnpkg.com/lang/en/docs/install/#mac-stable
68
- https://getcomposer.org/
79

810
```
9-
git clone ....
11+
git clone .... OR use the template
12+
13+
# Install dependencies
1014
composer install
1115
yarn
1216
```
1317

18+
### Setup configurations
19+
20+
```
21+
cp .env.example .env
22+
php artisan key:generate
23+
php artisan migrate
24+
25+
php artisan serve
26+
```
27+
1428
## Commit Message Convention
1529

1630
This website follows [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/)
@@ -37,7 +51,7 @@ Available types are:
3751
- revert → when reverting commits
3852
- perf → Fixing something regarding performance (deriving state, using memo, callback)
3953
- vercel → Blank commit to trigger vercel deployment. Ex: `vercel: trigger deployment`
40-
- trigger → Using trigger actions
54+
- trigger → Using trigger actions
4155

4256
### 2. Optional Scope
4357

@@ -58,3 +72,55 @@ Add BREAKING CHANGE in the description if there is a significant change.
5872
- Use imperative, and present tense: "change" not "changed" or "changes"
5973
- Don't use capitals in front of the sentence
6074
- Don't add full stop (.) at the end of the sentence
75+
76+
### 4. Before Commit
77+
78+
to clean code and setup spaces you can see `.prettierrc` for all file except php and `.editorconfig` for php.
79+
80+
on `.prettierrc` -> **all files**
81+
82+
```
83+
{
84+
"semi": false,
85+
"singleQuote": true,
86+
"printWidth": 80,
87+
"tabWidth": 2, # change it according to your wishes
88+
"trailingComma": "all",
89+
"endOfLine": "auto"
90+
}
91+
```
92+
93+
on `.editorconfig` -> **php**
94+
95+
```
96+
root = true
97+
98+
[*]
99+
charset = utf-8
100+
end_of_line = lf
101+
indent_size = 2 # change it according to your wishes
102+
indent_style = space
103+
insert_final_newline = true
104+
trim_trailing_whitespace = true
105+
106+
[*.md]
107+
trim_trailing_whitespace = false
108+
109+
[*.{yml,yaml}]
110+
indent_size = 2
111+
112+
[docker-compose.yml]
113+
indent_size = 4
114+
```
115+
116+
#### Run prettier
117+
118+
```
119+
yarn prettierrc
120+
```
121+
122+
#### Run editorconfig
123+
124+
```
125+
composer format
126+
```

0 commit comments

Comments
 (0)