|
1 | | -<h1 align="center">Welcome to fastify-typescript-generator 👋</h1> |
| 1 | +<h1 align="center">welcome to fastify-typescript-generator 👋</h1> |
2 | 2 | <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" /> |
4 | 4 | <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" /> |
6 | 6 | </a> |
7 | 7 | <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" /> |
9 | 9 | </a> |
10 | 10 | <a href="https://github.com/open-devs/fastify-typescript-generator/blob/master/LICENSE" target="_blank"> |
11 | 11 | <img alt="License: MIT" src="https://img.shields.io/github/license/open-devs/fastify-typescript-generator" /> |
12 | 12 | </a> |
13 | 13 | </p> |
14 | 14 |
|
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 |
16 | 16 |
|
17 | | -### 🏠 [Homepage](https://github.com/open-devs/fastify-typescript-generator#readme) |
| 17 | +### 🏠 [homepage](https://github.com/open-devs/fastify-typescript-generator#readme) |
18 | 18 |
|
19 | | -## Install |
| 19 | +## install |
20 | 20 |
|
21 | 21 | ```sh |
22 | 22 | npm install |
23 | 23 | ``` |
24 | 24 |
|
25 | | -## Usage |
| 25 | +## usage |
26 | 26 |
|
27 | 27 | ```sh |
28 | 28 | npm run start |
29 | 29 | ``` |
30 | 30 |
|
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 |
32 | 77 |
|
33 | | -```sh |
34 | | -npm run test |
35 | | -``` |
| 78 | +👤 **open devs (open.devs.github@gmail.com)** |
36 | 79 |
|
37 | | -## Author |
| 80 | +* website: https://opendevs.in/ |
| 81 | +* github: [@open-devs](https://github.com/open-devs) |
38 | 82 |
|
39 | | -👤 **open devs (open.devs.github@gmail.com)** |
| 83 | +## 🚀 future scope |
40 | 84 |
|
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 |
43 | 88 |
|
44 | 89 | ## 🤝 Contributing |
45 | 90 |
|
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). |
47 | 92 |
|
48 | 93 | ## Show your support |
49 | 94 |
|
|
0 commit comments