Skip to content

Commit 561f6e3

Browse files
committed
docs: ✏️ Types defintion for options
This commit includes changes to docs to better describe the different options that are available in fastify-typescript-generator
1 parent 23b3125 commit 561f6e3

File tree

2 files changed

+63
-18
lines changed

2 files changed

+63
-18
lines changed

README.md

Lines changed: 62 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,94 @@
1-
<h1 align="center">Welcome to fastify-typescript-generator 👋</h1>
1+
<h1 align="center">welcome to fastify-typescript-generator 👋</h1>
22
<p>
3-
<img alt="Version" src="https://img.shields.io/badge/version-0.0.1BETA-blue.svg?cacheSeconds=2592000" />
3+
<img alt="Version" src="https://img.shields.io/badge/version-0.0.3-blue.svg?cacheSeconds=2592000" />
44
<a href="https://github.com/open-devs/fastify-typescript-generator#readme" target="_blank">
5-
<img alt="Documentation" src="https://img.shields.io/badge/documentation-yes-brightgreen.svg" />
5+
<img alt="Documentation" src="https://img.shields.io/badge/documentation-yes-blue.svg" />
66
</a>
77
<a href="https://github.com/open-devs/fastify-typescript-generator/graphs/commit-activity" target="_blank">
8-
<img alt="Maintenance" src="https://img.shields.io/badge/Maintained%3F-yes-green.svg" />
8+
<img alt="Maintenance" src="https://img.shields.io/badge/Maintained-yes-blue.svg" />
99
</a>
1010
<a href="https://github.com/open-devs/fastify-typescript-generator/blob/master/LICENSE" target="_blank">
1111
<img alt="License: MIT" src="https://img.shields.io/github/license/open-devs/fastify-typescript-generator" />
1212
</a>
1313
</p>
1414

15-
> Generate new Fastify applications similar to express-generate which but sets it up to use TypeScript instead
15+
> generates new [fastify](https://www.fastify.io/) applications in everyone's favourite language [typescript](https://github.com/microsoft/TypeScript) with various options to choose from based on your project needs
1616
17-
### 🏠 [Homepage](https://github.com/open-devs/fastify-typescript-generator#readme)
17+
### 🏠 [homepage](https://github.com/open-devs/fastify-typescript-generator#readme)
1818

19-
## Install
19+
## install
2020

2121
```sh
2222
npm install
2323
```
2424

25-
## Usage
25+
## usage
2626

2727
```sh
2828
npm run start
2929
```
3030

31-
## Run tests
31+
## ❓ what is it
32+
33+
creates a new fastify application similar to the fastify-cli module. except this new application is configured to use typeScript instead of plain javascript and provides various options such as, kind of project structure to use with focus on plugin structure for fastify developers and express structure for developers with experience in developing with express, it also provides options for typeorm or mongoose.
34+
35+
## 🤔 why fastify-typescript-generator
36+
37+
nodejs is great for the rapid development of web-projects, but is often neglected because of the lack of type safety. typescript solves this issue and (along with its linter file) can even make your code more robust than some other static languages like java.
38+
39+
there are some other tools out there to generate fastify apps with javascript such as fastify-cli, but these either haven't been updated in a while or don't support typescript or don't support various development patterns.
40+
41+
in this application you have two options to setup a project in fastify plugin architecture or express architecture, we have setup mongoose/typeorm integration, routes, swagger (in plugin structure only) for you.
42+
43+
## 📜 different options available explained
44+
45+
<table>
46+
<caption>description of various options available</caption>
47+
<thead>
48+
<tr>
49+
<th>name</th>
50+
<th>description</th>
51+
</tr>
52+
</thead>
53+
<tbody>
54+
<tr>
55+
<td>plugin-structure-mongoose</td>
56+
<td>this type of structure includes fastify plugin structure which relies on modules described as reusable plugins that contain their own entities, routes & schemas, additionally paired with swagger and mongoose for connection with mongodb</td>
57+
</tr>
58+
<tr>
59+
<td>plugin-structure-typeorm</td>
60+
<td>this type of structure includes fastify plugin structure which relies on modules described as reusable plugins that contain their own entities, routes & schemas, additionally paired with swagger and typeorm for connection with various sql (like postgresql, mysql) and no-sql databases (like mongodb)</td>
61+
</tr>
62+
<tr>
63+
<td>express-structure-mongoose</td>
64+
<td>this type of structure includes express generator structure which relies on models, routes, dao, services, additionally paired with swagger and mongoose for connection with mongodb</td>
65+
</tr>
66+
<tr>
67+
<td>express-structure-typeorm</td>
68+
<td>this type of structure includes express generator structure which relies on models, routes, services, additionally paired with swagger and typeorm for connection with various sql (like postgresql, mysql) and no-sql databases (like mongodb)</td>
69+
</tr>
70+
</tbody>
71+
</table>
72+
<br>
73+
74+
Happy web-deving 😊
75+
76+
## author
3277

33-
```sh
34-
npm run test
35-
```
78+
👤 **open devs (open.devs.github@gmail.com)**
3679

37-
## Author
80+
* website: https://opendevs.in/
81+
* github: [@open-devs](https://github.com/open-devs)
3882

39-
👤 **open devs (open.devs.github@gmail.com)**
83+
## 🚀 future scope
4084

41-
* Website: https://opendevs.in/
42-
* Github: [@open-devs](https://github.com/open-devs)
85+
* adding docker & container configurations
86+
* adding template support
87+
* more template structures
4388

4489
## 🤝 Contributing
4590

46-
Contributions, issues and feature requests are welcome!<br />Feel free to check [issues page](https://github.com/open-devs/fastify-typescript-generator/issues). You can also take a look at the [contributing guide](https://github.com/open-devs/fastify-typescript-generator/blob/master/CONTRIBUTING.md).
91+
contributions, issues and feature requests are welcome!<br />feel free to check [issues page](https://github.com/open-devs/fastify-typescript-generator/issues). you can also take a look at the [contributing guide](https://github.com/open-devs/fastify-typescript-generator/blob/master/CONTRIBUTING.md).
4792

4893
## Show your support
4994

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "fastify-typescript-generator",
3-
"version": "0.0.2",
3+
"version": "0.0.3",
44
"description": "Generate new Fastify applications similar to express-generate which but sets it up to use TypeScript instead",
55
"scripts": {
66
"fastify-generator-typescript": "node cli.js",

0 commit comments

Comments
 (0)