Clementine.js is a lightweight boilerplate for fullstack JavaScript development which utilizes MongoDB, Express and Node.js. Coming in at just under 32 KB, Clementine.js is a perfect alternative to more feature-dense boilerplates.
Clementine.js errs on the side of transparency and simplicity, making it an ideal starting point for beginner and seasoned developers alike. Note that this implementation assumes the developer wishes to perform implementation of more complex features him- or herself.
There are 3 versions of Clementine.js:
- Standard (this version): the simplest version of Clementine.js. Intended for those who wish for the smallest and least intrusive footprint OR to implement features on their own.
- Angular: a slightly more complex version of the same application. This version employs the use of AngularJS as the front-end framework.
- Free Code Camp (FCC): A modified version of the standard boilerplate that is intended for use with the Free Code Camp curriculum.
In order to use Clementine.js, you must have the following installed:
There are 3 ways to install Clementine.js:
- Clone the GitHub Repository
- Clone using Mirror
- Install via Yeoman Generator
Both options are similar, and a matter of preference.
Option 1 - Clone GitHub Repo
$ git clone https://github.com/johnstonbl01/clementinejs.git your-projectThis will install the Clementine.js components into the your-project directory.
Option 2 - Clone using Mirror
Mirror is a tool that does 1:1 clones of Github repos. Click on the button below to mirror this repo.
Alternatively, you can use the mirror cli tool to clone it from the command line:
npm install -g mirror-cli
mirror johnstonbl01/clementinejs to USER/REPO -u USERNAME -t ACCESS_TOKENOption 3 - Yeoman Generator
$ npm install -g generator-clementinejs
$ mkdir your-project
$ cd your-project
$ yo clementinejsNote: generator-clementinejs must be installed globally.
To start the application, browse to the project directory and type: $ node server into the terminal window. Point a browser to localhost:3000 and you're up and running!
If you're using c9.io, please reference the documentation for instructions to get Clementine.js working in the c9 environment.
This is an open-source project, and contributions are always welcome! To see ways to contribute, please review the contribution guidelines.
Complete documentation can be found here.
You can find a complete step-by-step tutorial on how to create this app from the ground up here.
| Features | Standard | Angular | FCC |
|---|---|---|---|
| MongoDB | Yes | Yes | Yes |
| Express | Yes | Yes | Yes |
| AngularJS (1.x) | No | Yes | No |
| Node.js | Yes | Yes | Yes |
| Passport | No | No | Yes |
| Mongoose | No | No | Yes |
MIT License. Click here for more information.