npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

slicks-bee-angel-turner

v1.0.0

Published

A template repository to kickstart your Node.js projects with a clean and organized structure. This repository serves as a starting point for your new projects, helping you focus on building great applications right from the beginning.

Downloads

2

Readme

Quick Start Node

Welcome to Quick Start Node, a template repository to kickstart your Node.js projects with a solid foundation and best practices.

Project Overview

Quick Start Node provides a generic starting point for your Node.js projects, complete with a well-organized project structure, common dependencies, and essential configurations. It's designed to help you save time and ensure consistency across your projects.

Getting Started

Follow these steps to get your project up and running:

  1. Clone this repository to your local machine.
  2. Navigate to the cloned directory: cd quick-start-node.
  3. Install dependencies: npm install.
  4. Customize the env code or change it as needed. Copy example.json and paste the content in three files: development.json, production.json and test.json: cat ./env/example.json | tee ./env/development.json ./env/production.json ./env/test.json > /dev/null.
  5. Start the server: npm run start

Usage

This template covers the basic structure and setup of a Node.js project. You can adapt it for various types of applications:

  • Define your routes and controllers in the src/routes and src/controllers directories.
  • Model your data and schema in the src/models directory.
  • Utilize middleware functions in the src/middleware directory.
  • Expand your application logic in the index.js file.

Customization

  • Dependencies: Add or remove dependencies by modifying the package.json file.
  • Configuration: Adjust configuration settings in the env/ directory. Copy all code from example.json file to new files development.json, test.json and production.json in same directory and add or change the data. You can run this in in your package root also cat ./env/example.json | tee ./env/development.json ./env/production.json ./env/test.json > /dev/null.
  • Scripts: Customize scripts in the package.json file to match your development workflow.

Testing and Development

  • Start the development server: npm run dev.
  • Run unit tests: npm run test:unit
  • Run integration tests: npm run test:integration
  • Set up additional testing configurations in the tests directory.

Tech Stack and Dependencies Used.

  • Node Js
  • Express Js
  • Mongo DB

For other dependencies please check package.json file.

Project Structure

You can use these commands to print your project tress:

  • CMD: tree /A /F | findstr /V /C:"node_modules"

  • POWERSHELL: Get-ChildItem -Recurse | Where-Object { $_.FullName -notlike "*\node_modules\*" } | ForEach-Object { $_.FullName }

  • UBUNTU (WSL): tree --prune -I 'node_modules' --dirsfirst or tree -a -I 'node_modules|.git' --dirsfirst

quick-start-node/
├── .github
│   └── workflows
│       └── build-lint-test.yml
├── .vscode
│   ├── extensions.json
│   └── settings.json
├── env
│   ├── development.json
│   ├── example.json
│   ├── production.json
│   └── test.json
├── logs
│   ├── error.log
│   ├── uncaught-exceptions.log
│   └── unhandled-rejections.log
├── public
│   ├── data
│   │   ├── http-status-codes.js
│   │   └── programming-error-codes.js
│   ├── images
│   │   ├── avatar1.png
│   │   └── avatar2.png
│   └── styles
│       └── index.min.css
├── src
│   ├── assets
│   │   └── scss
│   │       ├── _about-us.scss
│   │       ├── _contact-us-email-template.scss
│   │       ├── _contact-us.scss
│   │       ├── _footer.scss
│   │       ├── _header.scss
│   │       ├── _home.scss
│   │       ├── _page-not-found.scss
│   │       ├── _variables.scss
│   │       └── index.scss
│   ├── configurations
│   │   ├── index.js
│   │   ├── logger.js
│   │   ├── mongo-atlas.js
│   │   ├── nodemailer.js
│   │   └── set-environment-config.js
│   ├── controllers
│   │   ├── auth-controller.js
│   │   ├── index.js
│   │   ├── pages-controller.js
│   │   ├── reset-password-controller.js
│   │   └── user-controller.js
│   ├── middlewares
│   │   ├── async-error-handler.js
│   │   ├── index.js
│   │   ├── is-authenticated-middleware.js
│   │   ├── is-valid-object-id-middleware.js
│   │   ├── log-request-info-middleware.js
│   │   ├── uncaught-errors-middleware.js
│   │   ├── use-middlewares.js
│   │   └── validate-and-sanitize-request-middleware.js
│   ├── models
│   │   ├── Temporary-Token.js
│   │   ├── User.js
│   │   └── index.js
│   ├── routes
│   │   ├── auth-route.js
│   │   ├── index.js
│   │   ├── pages-route.js
│   │   ├── reset-password-route.js
│   │   └── user-route.js
│   ├── utilities
│   │   ├── format-error.js
│   │   ├── format-response.js
│   │   ├── get-project-name.js
│   │   ├── index.js
│   │   └── string-utilities.js
│   ├── validators
│   │   ├── auth-validators.js
│   │   ├── index.js
│   │   ├── pages-validators.js
│   │   ├── reuseable-validators.js
│   │   └── user-validators.js
│   └── views
│       ├── components
│       │   ├── footer-mixin.pug
│       │   └── header-mixin.pug
│       ├── emails
│       │   └── email-template.pug
│       ├── about-us.pug
│       ├── contact-us.pug
│       ├── home.pug
│       └── page-not-found.pug
├── tests
│   ├── integration
│   │   └── routes
│   │       └── user.test.js
│   ├── unit
│   │   ├── configs
│   │   │   └── mongo-atlas.test.js
│   │   ├── middlewares
│   │   │   └── is-authenticated.test.js
│   │   └── models
│   │       └── User.test.js
│   └── setup.js
├── .eslintrc.json
├── .gitignore
├── LICENSE
├── README.md
├── index.js
├── package-lock.json
└── package.json

Conventions

Naming

  • Variables: Utilize camelCase when naming variables.
  • Files:
    • Apply kebab-case for file names (e.g., is-authenticated-user.js).
    • In cases of repetitive file names, consider appending the folder name to improve clarity and organization.
      • For example, if "user" appears in multiple places, name files as user-route.js, user-controller.js, user-middleware.js.
  • Classes:
    • Opt for PascalCase when naming classes (e.g., User).
    • The files containing classes should follow PascalCase + kebab-case (e.g. User-Class.js).

File Organization

The project employs a meticulous folder structure to uphold a neat and methodical codebase:

  • /public: Serves as the repository for static files.
  • /env: Hosts environment and confidential files, catering to various environments. Files such as development.json, test.json, and production.json are ignored; however, an illustrative example.json is included.
  • /tests: Houses test files, further categorized into:
    • /unit: Reflects the /src structure, housing unit tests.
    • /integration: Resonates with the /src layout and contains integration tests.
  • /src: The primary source folder, home to JavaScript files and a spectrum of subfolders encompassing distinct components:
    • /assets: Designated for assets, including SCSS and more.
    • /configurations: Houses assorted settings like MongoDB, logger, and nodemailer.
    • /controllers: Encompasses code pertinent to route handlers.
    • /middlewares: Hosts middleware modules catering to application logic.
    • /models: Encapsulates schemas and methods tailored for database models.
    • /routes: Holds handler functions for diverse API endpoints.
    • /utilities: Features utility functions and classes.
    • /validators: Contains validation logic dedicated to user data.
    • /views: Nurtures the creation of views and components via the Pug templating engine.

API Endpoints

Routes are created using Express.js routes. Some of them are:

  • /api/
  • /api/about-us
  • /api/contact-us
  • /api/users/
  • /api/users/me
  • /api/users/:userId
  • /api/auth/login
  • /api/auth/logout
  • /api/reset-password

HTTP Verbs Used

  • GET : Use this to fetch data from the DB to client
  • POST: Use this when creating new record in DB
  • PATCH: Use this when you partially update any entity
  • DELETE: Use this when you are performing delete operation

HTTP Status Codes

Some of the status codes used are see all here in a file:

  • 200 Used when you get data successfully.
  • 201 Used when your data created successfully.
  • 400 Used when there is bad request from the client.
  • 401 Used when user is not authenticated.
  • 403 Used when user is authenticated but do not have permissions to access resource.
  • 404 Used when data not found.
  • 422 Used when payload key(s) is valid but the data in the key(s) are unprocessable.
  • 500 is used for internal server error.

Contribution

Contributions are welcome! If you encounter issues or have improvements to suggest, please create a pull request.

Thank you for considering contributing to this project!

License

This project is licensed under the MIT License.