With the help of community members contributing content to the site, JavaScript.com aims to keep developers up to date on news, frameworks, and libraries. In addition, we aim to be a gateway for those wanting to learn JavaScript.

JavaScript.com was the product of a hack day and there's a lot of room for improvement. Check out the current roadmap.

We'd love for you to contribute! For the time being, we will be placing a strong emphasis on getting the code base up to standards before adding new features.

We have two main branches, master and production. All PR's will be merged into master which is then merged into production. The production branch is the code that is currenly deployed.

At the moment, master is ahead of production while we streamline our deploy process. Please bear with us for the timing being!

Install NVM (brew install nvm and follow instructions)

nvm install 4.2.1
npm install -g gulp
npm install

To build assets locally, you'll need to install Bower dependencies and run these Gulp tasks:

bower install
gulp sass
gulp javascript

Remember to re-run these tasks after pulling or changing branches.

This app authenticates with GitHub, so you'll need to create a GitHub Application.

Set the Homepage URL to http://localhost:3000 and

the Authorization callback URL to http://localhost:3000/sessions/auth/github/callback/

We use dotenv to keep ourselves sane with the various environment variables.

Copy example.env to .env and then fill in the variables. The only ones that are critical locally are Github variables for sign in. For everything else, you can setup test accounts if you'd like.

Download and install MongoDB

When you run npm start, mongod will be forked as a background process. No need to create the database either. You're all set.

After you're done, make sure you run npm stop to shut down mongod.

Run the application with $ npm start.

If you add any runtime dependencies, you must run npm shrinkwrap and commit changes to npm-shrinkwrap.json.