The "Simplified" Guide to Setting Up Dev Environment. (Mac)

[Chaboi_3000]

Difficulty: (Intermediate-Advanced)

Intro

Ever wanted to “hack” CodeCombat and help contribute in making CodeCombat better? (There are two types of hacking, white-hat hacking, and black-hat hacking. White hat hacking is to help fix problems and stop black-hat hackers, and black-hat hacking is malicious hacking/cheating.) Do you find the current guide way too confusing? I’ve simplified the current guide so you can understand it. Use Node version 10.

Guide

1. Download the Xcode command line tools by either:
   Going to Xcode->Preferences->Downloads
   or…
   Run xcode-select --install in the terminal app.

2. Download NVM. Before you do that, go open up Terminal. You can spotlight search Terminal and click enter. (Spotlight search is the icon at the top).
   Once you go into the terminal app, type in the following to install NVM:
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
   or
   wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.34.0/install.sh | bash
   then run:
   export NVM_DIR="$HOME/.nvm"
   then
   [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
   then
   [ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"

3. Download Node and NPM using NVM. It’s simple, run the following command in your terminal:
   nvm install 14.x.x

4. Set your default Node to version 14. You won’t have to manually type nvm use 14.x.x every time. Run the following command:
   nvm alias default 8.15.1

5. Update NPM.
   Run this:
   npm install -g npm@6.4.1

@You

Are we done yet?

Not yet. We are around halfway there.

6. Create an account on GitHub. (You can skip this step if you already have an account)
7. Download Git here: Download git-2.21.0-intel-universal-mavericks.dmg (git-osx-installer (abandoned))
8. After downloading Git, set your username:
   git config --global user.name "username"
   then confirm it by:
   git config --global user.name
9. Configure your email address:
   git config --global user.email "email@example.com"
   Confirm your email:
   git config --global user.email
10. Clone CodeCombat:
    git clone https://github.com/codecombat/codecombat
11. After cloning, (It takes a while), type in:
    cd codecombat
    then
    npm install
    Note: npm install might take a few minutes so be patient.
12. Run npm run build
13. To run your server, type:
    cd codecombat
    then
    npm run proxy
    (Optional) Create a new terminal window(Don’t close current one) and type in
    cd codecombat
    then
    npm run webpack -- --watch

@You

I’m really tired. How many more steps? Your instructions are really long.

Ok fine… Just go to localhost:3000 and see your very own environment in action!
It should look like this:

---

Those who want to start hacking codecombat, follow this guide:

Part 1-How To Start "Hacking" Codecombat. (Mac)

Difficulty: (Easy) Intro Congrats! You have successfully completed this guide: https://discourse.codecombat.com/t/the-simplified-guide-to-setting-up-dev-environment-mac/18533 It’s time to start “hacking”… Steps You’ve probably got the hang of the terminal and want to do more. Here’s how to start: Go to GitHub and log into your account. Go to the CodeCombat Repository and fork it. [51%20PM] You should have a “clone” of CodeCombat’s repository, and it’s probably named somethin…

[Chaboi_3000]

Update:
There were a few missing steps and easier steps.

1. Added a new way to download Xcode command line tools(Running xcode-select --install in terminal)
2. Enhanced step 2.

[Chaboi_3000]

The new setup requires Node v10 and npm run build. The guide is updated.