Skip to content
A version of the Clementine.js boilerplate specifically for use with Free Code Camp curriculum.
JavaScript CSS HTML
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
app
public
.gitignore
LICENSE.md
README.md
package.json
server.js

README.md

Deprecation

Heya! 👋 This package is being deprecated & moved to another repository for a new version of Clementine in early 2020. I'll link to the repo when that happens, but this repository will be archived at that time.

Clementine.js FCC Boilerplate

Join the chat at https://gitter.im/johnstonbl01/clementinejs

Overview

Clementine.js is a lightweight boilerplate for fullstack JavaScript development which utilizes MongoDB, Express and Node.js. The boilerplate errs on the side of transparency and simplicity, making it an ideal starting point for beginner and seasoned developers alike.

The Free Code Camp version of Clementine.js is meant for use when completing projects as part of the FCC curriculum. This version includes GitHub authentication using Passport.

Versions

There are 3 versions of Clementine.js:

  • Standard: 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) (this version): A modified version of the standard boilerplate that is intended for use with the Free Code Camp curriculum.

Quick Start Guide

Prerequisites

In order to use Clementine.js, you must have the following installed:

Installation & Startup

To install Clementine.js, simply enter the below in the terminal window:

$ git clone https://github.com/johnstonbl01/clementinejs-fcc.git your-project

To install the dependencies, enter the following in your terminal:

$ cd your-project
$ npm install

This will install the Clementine.js components into the your-project directory.

Setup GitHub Authentication

Please follow this guide to register the application with GitHub and get API keys / secrets.

Local Environment Variables

Create a file named .env in the root directory. This file should contain:

GITHUB_KEY=your-client-id-here
GITHUB_SECRET=your-client-secret-here
MONGO_URI=mongodb://localhost:27017/clementinejs
PORT=8080
APP_URL=http://localhost:8080/

Starting the App

To start the app, make sure you're in the project directory and type node server.js into the terminal. This will start the Node server and connect to MongoDB.

You should the following messages within the terminal window:

Node.js listening on port 8080...

Next, open your browser and enter http://localhost:8080/. Congrats, you're up and running!

c9.io Setup

If you're using c9.io, please reference the documentation for instructions to get Clementine.js working in the c9 environment.

Contributing

This is an open-source project, and contributions are always welcome! To see ways to contribute, please review the contribution guidelines.

Documentation

Complete documentation can be found here.

Tutorial

You can find a complete step-by-step tutorial on how to create this app from the ground up here.

Features

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

License

MIT License. Click here for more information.

You can’t perform that action at this time.