1/ Setting up your development environment

Last updated last month

Setting Up Your Development Environment

1. Install Meteor. On a mac, you should use this command:

curl "https://install.meteor.com/?release=" | sh

On Windows, you should run the official installer here. If you're unsure whether you already have meteor installed, type meteor --version in your command line to check. You should see that you have meteor version

2. Fork this repository by clicking on the button on the top far right of https://github.com/codebuddies/codebuddies.

Once you have a copy of this repo on your own account, clone this repo to your computer by typing in something like:

git clone https://github.com/codebuddies/codebuddies.git

(Replace the URL with your own repository URL path.)

3. Type cd codebuddies in your terminal. Then, set up this repository as an upstream branch by typing:

  • git remote add upstream https://github.com/codebuddies/codebuddies.git

Now, whenever you want to sync with the owner repository, you can do the following:

  • git fetch upstream

  • git checkout staging

  • git merge upstream/staging

    Note: You can type git remote -v to check which repositories your origin and upstream are pointing to.

4. Type meteor npm install to install the initial meteor packages. You have to do this once!

Start up the App

Run meteor --settings settings-development.json in your terminal to start up the app in your browser (http://localhost:3000). Note that the first time you do this, it may take a while (a few minutes) for the app to start up.


  • meteor npm run meteor:dev can also run the app, but may use up your CPU.

  • Also note: if you see an error in your terminal asking you to meteor npm install --save faker, please run that command!

  • When you create a hangout in your localhost:3000, a Slack notification will be sent to the #codebuddies-ops channel. This emulates what happens when you create a hangout on codebuddies.org, where a Slack announcement about the hangout will appear in the #announcements channel.