ninjaninja140's Templates - Node.js

Hello and welcome! This is a template repository made for convenience to others by ninjaninja140!

As the title suggests, this is a Node.js based JavaScript Template. If you would like to use the TypeScript version of this template, please go to https://github.com/ninjaninja140/nodejs-template-ts This Template has been pre-configured with docker so you can go straight into your Dockerized project with little configuration required!

Getting a copy

To begin on your own project, you can either fork this repository and begin your project or you could select this repository at ninjaninja140/nodejs-template-js as a template when creating a new repository or you could just clone it and work locally!

Setup & Install

If you aren't using Docker

Just remove the compose.yml and Dockerfile files and you should be good to go! You may also need to remove the validate.yml file as this uses Docker to check if the project can be compiled with Docker. You can also remove the "up": "docker compose -f compose.yml up -d" line from your package.json's scripts JSON array.

For using NPM instead of Yarn

If you are using npm, please remove the yarn.lock and .yarnrc.yml files along with the .yarn directory. Please also remove the COPY --chown=node:node .yarnrc.yml . line in the Dockerfile if you are using Docker. You also need to change all the command scripts in package.json that start with yarn to npx.

If you are using Prettier

This project is pre-configured with prettier, if you do not like the configuration in .prettierrc, just remove it! WARNING: If you are using the prettier VSCode extension, my config will automatically apply for this directory. if you want to use ESLint with this project, please do try and port it yourself as I don't use ESLint.

Install using Yarn

This project is pre-configured with yarn so if you haven't removed yarn's dependencies if you are using NPM in the For using NPM instead of Yarn section above, you should be fine to run the command below. If you encounter any errors while running it that are not your own computer's errors, please feel free to open an issue so I can fix it. Running yarn install should install all the necessary development dependencies, after its finished you should be good to go!

Install using NPM

If you wish to use NPM in this project, please follow the instructions in the For using NPM instead of Yarn section above before running any commands. Running npm install after following the section referenced above, you should be ready to start coding!

Usage

Testing

If you have a different file structure than the one that is currently set up where index.js is your main file please make sure to set up the test script in the package.json file to point to the file you wish to run.

To test your application run either of the two commands:

• NPM: npm run test
• Yarn: yarn run test or yarn test

Use CTRL or COMMAND + C to exit.

Running

To run your application, run either of the two commands:

• NPM: npm run start
• Yarn: yarn run start or yarn start

Use CTRL or COMMAND + C to exit.

Linting & Validating

This project has been pre-configured to use prettier. I have left four commands in the package.json file for your convenience. Each command and its purpose will be listed below:

• lint - Lints or "formats" the src directory
• validate - Checks or "validates" the src directory
• lint:all - Lints or "formats" the whole directory
• validate:all - Checks or "validates" the whole directory

Each command can be configured in its own way in the scripts section of the package.json file.

You can change my current prettier config in the .prettierrc file, or you can delete it to use another linter or use the VSCode plugin version of prettier.

Docker

This project was set up with Docker for convenience to others and myself. If you do not wish to use Docker in this project, ignore this and go to the If you aren't using Docker sub-section of the Setup & Install section. If you are using Docker in this project, I have pre-prepared a Dockerfile, change this to your best suit if necessary. I have also included a compose.yml file (this is just the docker-compose.yml file but renamed, I'll explain how to use it momentarily) for convenience of the stack users, again change this to your best suit if necessary.

Building

If you don't already, install Docker Engine or Docker Desktop onto the device you are using to test locally or deploy on. You can run your own docker build command or use my pre-configured command in package.json. This can be used in either way:

• NPM: npm run build
• Yarn: yarn build or yarn run build

If this fails for whatever reason, please try troubleshoot it yourself before opening an issue.

Running

If you haven't already, please build your project before running. Refer to the Building sub-section that should be just above on how to build your project.

To run as a Docker Container

Run docker run {IMAGE NAME HERE} --name {CONTAINER NAME HERE} --restart {RESTART POLICY} - this should start the built Docker Image that you made before. If the image fails to run because of an issue, again, please try to troubleshoot it yourself before opening an issue.

To run as a Docker Stack

For those fancy fellows who want to run your application in a Docker Stack, I've got you! You can run it using my pre-configured commands here:

• NPM: npm run up
• Yarn: yarn up or yarn run up

I have configured the docker compose up -d command in package.json to run from compose.yml. If the image fails to run because of an issue, again, please try to troubleshoot it yourself before opening an issue.

Thank you!

Thank you for using my templates! If you like to use them frequently, why not consider sponsoring or tipping me! My GitHub Sponsors profile is at https://github.com/sponsors/ninjaninja140!