PR-448199:

Adding Readme file.
This commit is contained in:
Alejandro Lembke Barrientos 2022-05-26 00:02:22 +00:00
parent 2b698e785a
commit 8652f52221
3 changed files with 75 additions and 2 deletions

73
README.md Normal file
View 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.

View File

@ -12,7 +12,7 @@ const runCommand = command => {
}
const repoName = process.argv[2];
const gitCheckoutCommand = `git clone --depth 1 https://github.com/aleleba/node-ts-graphql-server ${repoName}`;
const gitCheckoutCommand = `git clone --depth 1 https://github.com/aleleba/create-node-ts-graphql-server ${repoName}`;
const installDepsCommand = `cd ${repoName} && npm install`;
console.log(`Cloning the repository with name ${repoName}`);

View File

@ -1,6 +1,6 @@
{
"name": "ts-graphql-server",
"version": "0.0.1",
"version": "1.0.0",
"description": "Node with Typescript and GraphQL Server",
"bin": "./bin/cli.js",
"main": "index.js",