Skip to content
This repository was archived by the owner on Oct 8, 2024. It is now read-only.

Commit 2ccc2ef

Browse files
committed
chore: update readme
1 parent e07035d commit 2ccc2ef

File tree

1 file changed

+21
-89
lines changed

1 file changed

+21
-89
lines changed

README.MD

Lines changed: 21 additions & 89 deletions
Original file line numberDiff line numberDiff line change
@@ -10,47 +10,51 @@
1010
[![Total Downloads](https://poser.pugx.org/leafs/api/downloads)](https://packagist.org/packages/leafs/api)
1111
[![License](https://poser.pugx.org/leafs/api/license)](https://packagist.org/packages/leafs/api)
1212

13-
Leaf API is a minimal API wrapper built on top of [Leaf PHP](https://leafphp.dev) which allows you to build APIs with Leaf, faster and simpler than ever before. Leaf API provides an simple and opinionated structure with a tons of functionality built in.
14-
15-
It is built on Leaf 3 which makes it even more lightweight and faster than earlier versions, but comes with a ton of upgrades and security fixes.
13+
Leaf API is a lightweight but feature-rich MVC framework built on top of [leaf php](https://leafphp.dev). It provides everything you need to build APIs with Leaf, faster and simpler than ever before.
1614

1715
## 📦 Installation
1816

1917
You can install Leaf API v3 with the [Leaf CLI](https://cli.leafphp.dev)
2018

2119
```sh
22-
leaf create <project-name> --v3 --api
20+
leaf create <project-name> --api
2321
```
2422

25-
`<project-name>` is your project name
23+
Or for a more personalized installation, you can add `--custom` to the command
24+
25+
```sh
26+
leaf create <project-name> --api --custom
27+
```
2628

27-
You can also use [Composer](https://getcomposer.org/) to install Leaf API quickly.
29+
You can also use [Composer](https://getcomposer.org/) if you don't want to use the Leaf CLI, although we recommend using the CLI for a better experience:
2830

2931
```bash
3032
composer create-project leafs/api <project-name>
3133
```
3234

33-
This will start a new Leaf API app.
35+
Note that `<project-name>` is the name of the project you want to create, and that will be your folder name. You can also use `.` to install in the current directory.
3436

3537
## 🗂 Directory Structure
3638

39+
```bash
3740
```bash
3841
C:.
3942
├───app
4043
│ ├───console
4144
│ ├───controllers
42-
│ │ └───Auth
4345
│ ├───database
4446
│ │ ├───factories
4547
│ │ ├───migrations
48+
│ │ ├───schema
4649
│ │ └───seeds
4750
│ ├───helpers
4851
│ ├───models
4952
│ ├───routes
5053
│ └───views
5154
├───config
52-
│ └───command
55+
───lib
5356
├───public
57+
│ └───assets
5458
├───storage
5559
│ ├───app
5660
│ │ └───public
@@ -70,9 +74,13 @@ php leaf serve
7074

7175
## 📓 Learning Leaf API
7276

73-
Leaf API has a very easy to understand [documentation](https://api.leafphp.dev) which contains information on all operations in Leaf API.
77+
- Leaf API has a very easy to understand [documentation](https://api.leafphp.dev) which contains information on all operations in Leaf API.
78+
79+
- Since Leaf API runs on Leaf, you should check out the Leaf PHP Framework documentation [here](https://leafphp.dev).
7480

75-
Since Leaf API runs on Leaf, you should check out the Leaf PHP Framework documentation [here](https://leafphp.dev).
81+
- You can also check out our [youtube channel](https://www.youtube.com/channel/UCllE-GsYy10RkxBUK0HIffw) which has video tutorials on different topics
82+
83+
- We are also working on [codelabs](https://codelabs.leafphp.dev) which will bring hands-on tutorials you can follow and contribute to.
7684

7785
## 😇 Contributing
7886

@@ -86,91 +94,15 @@ Your cash contributions go a long way to help us make Leaf even better for you.
8694
8795
We will furthermore like to thank our existing supporters, we love you all ❤️
8896
89-
## 📃 License
90-
91-
The Leaf API framework is open-source software licensed under the [MIT license](https://opensource.org/licenses/MIT).
92-
93-
9497
## 💬 Stay In Touch
9598
9699
- [Twitter](https://twitter.com/leafphp)
97100
- [Join the forum](https://github.com/leafsphp/leaf/discussions/37)
98101
- [Chat on discord](https://discord.com/invite/Pkrm9NJPE3)
99102
100-
## 📓 Learning Leaf 3
101-
102-
- Leaf has a very easy to understand [documentation](https://leafphp.dev) which contains information on all operations in Leaf.
103-
- You can also check out our [youtube channel](https://www.youtube.com/channel/UCllE-GsYy10RkxBUK0HIffw) which has video tutorials on different topics
104-
- We are also working on codelabs which will bring hands-on tutorials you can follow and contribute to.
105-
106-
## 😇 Contributing
107-
108-
We are glad to have you. All contributions are welcome! To get started, familiarize yourself with our [contribution guide](https://leafphp.dev/community/contributing.html) and you'll be ready to make your first pull request 🚀.
109-
110-
To report a security vulnerability, you can reach out to [@mychidarko](https://twitter.com/mychidarko) or [@leafphp](https://twitter.com/leafphp) on twitter. We will coordinate the fix and eventually commit the solution in this project.
111-
112-
### Code contributors
113-
114-
<table>
115-
<tr>
116-
<td align="center">
117-
<a href="https://github.com/mychidarko">
118-
<img src="https://avatars.githubusercontent.com/u/26604242?v=4" width="120px" alt=""/>
119-
<br />
120-
<sub>
121-
<b>Michael Darko</b>
122-
</sub>
123-
</a>
124-
</td>
125-
<td align="center">
126-
<a href="https://github.com/MauMaxxa">
127-
<img src="https://avatars.githubusercontent.com/u/10811652?v=4" width="120px" alt=""/>
128-
<br />
129-
<sub>
130-
<b>Mauro Callegari</b>
131-
</sub>
132-
</a>
133-
</td>
134-
</tr>
135-
</table>
136-
137-
## 🤩 Sponsoring Leaf
138-
139-
Your cash contributions go a long way to help us make Leaf even better for you. You can sponsor Leaf and any of our packages on [open collective](https://opencollective.com/leaf) or check the [contribution page](https://leafphp.dev/support/) for a list of ways to contribute.
140-
141-
And to all our existing cash/code contributors, we love you all ❤️
142-
143-
### Cash contributors
144-
145-
<table>
146-
<tr>
147-
<td align="center">
148-
<a href="https://opencollective.com/aaron-smith3">
149-
<img src="https://images.opencollective.com/aaron-smith3/08ee620/avatar/256.png" width="120px" alt=""/>
150-
<br />
151-
<sub><b>Aaron Smith</b></sub>
152-
</a>
153-
</td>
154-
<td align="center">
155-
<a href="https://opencollective.com/peter-bogner">
156-
<img src="https://images.opencollective.com/peter-bogner/avatar/256.png" width="120px" alt=""/>
157-
<br />
158-
<sub><b>Peter Bogner</b></sub>
159-
</a>
160-
</td>
161-
<td align="center">
162-
<a href="#">
163-
<img src="https://images.opencollective.com/guest-32634fda/avatar.png" width="120px" alt=""/>
164-
<br />
165-
<sub><b>Vano</b></sub>
166-
</a>
167-
</td>
168-
</tr>
169-
</table>
170-
171-
## 🤯 Links/Projects
103+
## 🎨 Links/Projects
172104
173105
- [Leaf Docs](https://leafphp.dev)
174-
- [Leaf API Docs](https://api.leafphp.dev)
106+
- [Leaf MVC Docs](https://mvc.leafphp.dev)
175107
- [Leaf CLI Docs](https://cli.leafphp.dev)
176108
- [Aloe CLI Docs](https://leafphp.dev/aloe-cli/)

0 commit comments

Comments
 (0)