mirror of
				https://github.com/aleleba/create-node-ts-graphql-server.git
				synced 2025-11-03 15:40:20 -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.
 | 
				
			||||||
@@ -12,7 +12,7 @@ const runCommand = command => {
 | 
				
			|||||||
}
 | 
					}
 | 
				
			||||||
 | 
					
 | 
				
			||||||
const repoName = process.argv[2];
 | 
					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`;
 | 
					const installDepsCommand = `cd ${repoName} && npm install`;
 | 
				
			||||||
 | 
					
 | 
				
			||||||
console.log(`Cloning the repository with name ${repoName}`);
 | 
					console.log(`Cloning the repository with name ${repoName}`);
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -1,6 +1,6 @@
 | 
				
			|||||||
{
 | 
					{
 | 
				
			||||||
  "name": "ts-graphql-server",
 | 
					  "name": "ts-graphql-server",
 | 
				
			||||||
  "version": "0.0.1",
 | 
					  "version": "1.0.0",
 | 
				
			||||||
  "description": "Node with Typescript and GraphQL Server",
 | 
					  "description": "Node with Typescript and GraphQL Server",
 | 
				
			||||||
  "bin": "./bin/cli.js",
 | 
					  "bin": "./bin/cli.js",
 | 
				
			||||||
  "main": "index.js",
 | 
					  "main": "index.js",
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user