mirror of
https://github.com/aleleba/create-node-ts-graphql-server.git
synced 2025-06-21 21:38:25 -06:00
PR-448199:
Adding Readme file.
This commit is contained in:
73
README.md
Normal file
73
README.md
Normal file
@ -0,0 +1,73 @@
|
||||
# Create Node TS GraphQL Server
|
||||
|
||||
This project aims to have a starter kit for creating a new Node with typescript, GraphQl server and tools that generally go along with it.
|
||||
|
||||
Tech(Library or Framework) | Version |
|
||||
--- | --- |
|
||||
Jest (Testing) | 28.1.0
|
||||
Typescript | 4.7.2
|
||||
|
||||
## Setup
|
||||
To create a new project run in the terminal:
|
||||
```
|
||||
npx @aleleba/create-node-ts-graphql-server server-app-name
|
||||
```
|
||||
Then run:
|
||||
```
|
||||
cd server-app-name
|
||||
```
|
||||
You will need to create a new .env file at the root of the project for global config.
|
||||
This is an example of config.
|
||||
```
|
||||
#ENVIRONMENT Defauld production
|
||||
ENVIRONMENT=development
|
||||
#WHITELIST URLS Default to http://localhost
|
||||
WHITELIST_URLS=https://dev-back-end.p-lao.com
|
||||
#GRAPHIQL Default to "false"
|
||||
GRAPHIQL=true
|
||||
# PORT EXPOSE APP Default to 4000
|
||||
PORT=4000
|
||||
```
|
||||
The default environment is production, the server-app port defauld is 4000, the default whitelist is http://localhost and the default graphiql is false.
|
||||
|
||||
### For Development
|
||||
In the terminal run:
|
||||
```
|
||||
npm run start:dev
|
||||
```
|
||||
The ENV enviroment variable should be "development" and choose the port of your preference with the enviroment variable PORT.
|
||||
|
||||
You will find the controllers on:
|
||||
```
|
||||
scr/controllers/
|
||||
```
|
||||
You will find the models on:
|
||||
```
|
||||
scr/models
|
||||
```
|
||||
You will find the GraphQL server, resolvers and schema definition on:
|
||||
```
|
||||
scr/GraphQL
|
||||
```
|
||||
|
||||
The manage of the routes for custom API you should find on:
|
||||
```
|
||||
scr/routes
|
||||
```
|
||||
|
||||
This will start the app in development mode, also use nodemon and webpack to real time coding!
|
||||
Enjoy coding!
|
||||
|
||||
### For Production
|
||||
In the terminal run:
|
||||
```
|
||||
npm run build
|
||||
```
|
||||
It will create a build folder and run:
|
||||
```
|
||||
npm start
|
||||
```
|
||||
This will start the app.
|
||||
|
||||
## Cheers
|
||||
Hope you enjoy this proyect! Sincerely Alejandro Lembke Barrientos.
|
Reference in New Issue
Block a user