/matterhorn

An API boilerplate project built on Node.js and TypeScript 🏔

Primary LanguageTypeScriptMIT LicenseMIT

Matterhorn 🏔

An API Boilerplate project built with Node.js and Typescript.

Quick Start

  1. 🍴 Fork the repository
  2. 👯‍♀️ Clone it to your computer 
  3. 🏃‍♀️ Run npm run install && npm run dev
  4. 📝 Edit any of the files in src/
  5. 👀 Watch as the app magically rebuilds and relaunches itself

Scripts

The following npm scripts can be run using npm run <script>. This project relies on opn and rimraf utilities in order to support cross-platform opening and deleting files.

  • build - build the TypeScript files and output to lib/
  • build:watch - automatically rebuild files if changes are detected in src/
  • clean - recursively delete the lib/ and coverage/ directories
  • clean:build - recursively delete the lib/ directory
  • clean:coverage - recursively delete the coverage/ directory
  • coverage - run the test suite and generate code coverage reports
  • coverage:open - run npm run coverage then open the results in a browser
  • dev - concurrently run build:watch and start:watch 
  • lint - run the linter configured by TSLint on the src/ directory
  • start - run the app from lib/. Make sure to use npm run build first!
  • start:watch - relaunch the server if new changes are detected in lib/ 
  • test - run unit tests defined in the tests/ directory
  • test:ci - run unit tests and generate necessary files for CI integration

Command Line Arguments & Environment Variables

Matterhorn implements example usage of both command line arguments and environment variables. It uses yargs-parser to manage command line arguments. Command line arguments are passed in through the start command: node lib/index.js <command line arguments>. The --log argument has been enabled as an example. Running npm run start starts up the project without any command line arguments. This command is intended to be used in production, so logging is disabled by default (i.e. we don't pass the --log argument). If you are using this command to test your code locally and want to see the logging output, then run npm run start -- --log. This passes the command line argument through npm and into the aliased command.

Environment variables work in a similar way to command line arguments. They can be set in multiple ways depending on the terminal and operating system you are using. In a bash terminal you can specify environment variables as you use any of the above mentioned scripts by prepending the assignment to the command. For example, this project has the PORT environment variable enabled. In a bash terminal run PORT=8080 npm run start to run the API on port 8080.

Contributing

Open an issue if you'd like to report a bug or a feature. Make sure to write a detailed description and indicate if you will or will not be resolving the issue yourself.

If you are interested in contributing make sure to follow these practices:

  • Prepend branches with fix/, feature/, or docs/ depending on the change being made
  • NPM commands test, lint, and build run without failing.
  • If you are solving an open issue, reference it in the Pull Request description using Ref #<issue number>.

Contributors

🦉 Ethan Arrowood Original Author - Follow on: Twitter @ArrowoodTech & GitHub @Ethan-Arrowood