Skip to content

🌈A simple nodejs boilerplate to speed-up your project.

License

Notifications You must be signed in to change notification settings

Programming-PH/nodejs-boilerplate

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

A NodeJs Project Kickstarter Biolerplate

Clean and minimalistic boilerplate to start your NodeJs project.

⭐ Good for

  • Building a worker scripts.
  • Building scripting and automation tool.
  • Stand-alone, fully customizable project.
  • Creating clean file structured project.
  • Following standard naming conventions so collaborators/team8s can understand easily your code.

πŸ“˜ Prerequisites

  • NodeJs Installed in your local environment.
  • .env file -- Yes you need this!

πŸ“ Usage

  1. Clone the repo to your local environment.
  • On the command prompt run the following commands: run git clone https://github.com/yortrosal/nodejs-boilerplate.git then cd nodejs-boilerplate
  1. run npm install to install initial dependencies.
  2. Make sure you have .env file available. Or generate one: cp .env.example .env (edit it with your secret keys and other credentials)
  3. Once you have the .env file setup in the main directory.
  4. run ▢️ npm start to start the program. It will run the script from the app.js file.
  5. Modify the package.json file. Edit the project name and other stuff.
  6. Finally, start and build your application scripts. Customize your project however you like.

πŸ“˜ Why is it important to use env file?

It has variety of usage. Find out more. But the sole purpose of using .env file for our project is to secure our credentials such as logins, api keys, and other important stuff. It is important not to include your .env file when you in our repository specially when your project is public. It's easy

Accessing your credentials from .env file.

πŸ— Project Structure

nodejs-boilerplate
  β”œβ”€β”€ core
  β”‚   β”œβ”€β”€ custom-subfolder-example
  β”‚   β”‚   β”œβ”€β”€ example1.js
  β”‚   β”‚   β”œβ”€β”€ example2.js
  β”‚   β”‚   └── example3.js
  β”‚   β”‚
  β”‚   β”œβ”€β”€ your-script.js
  β”‚   └── hello-world.js
  β”‚
  β”œβ”€β”€ .env.example
  β”œβ”€β”€ .env
  β”œβ”€β”€ .gitignore
  β”œβ”€β”€ package.json
  └── README.md

πŸ’¬ Tech Support

  • If things went wrong, google it first. People ahead of you have had similar issues in the past and solved it.
  • Last resort. -- Contact Jorge. He'd be happy to help you.

🎩 Authors

  • Jorge Rosal - GitHub
  • your name here...

πŸ“œ License

The MIT License (MIT) Jorge Rosal

Releases

No releases published

Packages

No packages published