SeeCodeRun 101: Running SeeCodeRun from scratch

We already have a readme file. This one includes more details and troubleshooting for Cloud9 development.

Setup a Cloud9 workspace

1. Log in with your Github(or other valid) credentials.

2. Create a workspace:

   a. From our repository.

   b. using the Node.js template.

If you created from a branch and not the master, you will get an RSA passphrase prompt when running git pull/push.

Fix it with:

 git remote set-url origin https://github.com/tlatoza/SeeCodeRun.git

This will set the master properly.

Configure the workspace's machine

Cloud9 will create a new virtual machine to host your workspace. This means that you will need to install and configure apps and libraries so your project runs properly.

Give jspm access

jspm requires GitHub credentials to perform transactions beyond its default data limit. As a good security practice, we encourage using access tokens instead of your password to configure jspm. The configuration is as follows:

1. Go to your GitHub account.
2. Go to Personal Settings >> Personal Access Tokens >> Generate new Token.
3. Check "public_repo" and give a description.
4. Copy the token, we will need it when executing "jspm registry config github".

If you do not copy the token, you will have to do this part all over again.

Setting the Aurelia Framework

It will take some minutes, be warned.

npm install
npm install -g gulp
npm install -g jspm
jspm registry config github
jspm install -y

When configuring the jspm registry, GitHub username must be the same that you used to create the token in the previous step. When you paste the token, the shell will not show any input entered, that is fine. Make sure you test the configuration.

Run SeeCodeRun

gulp watch

After running "gulp watch", wait till you see in the log information the "Local" link:

 Access URLs:
 ----------------------------
 Local: http://localhost:8082
 ----------------------------
    UI: http://localhost:3001
 ----------------------------

Click/tap on the link to get a pop-up menu. Then select open and voila!

####Note: run "jspm install -y" when "package.json"/"config.js" change or someone mentioned that they added new libraries. ###Important: If you get stuck while loading SeeCodeRun (the load icon perpetuates or the page is blnk), inspect(browser debugger) the page to see what is the problem. Normally, the issue is having missing libraries, which is fixed with the previous note.

#Sharing On the top right corner, there is a share button-ish, right between the CPU monitor and the Settings gear icon. Add GitHub usernames and the will be abe to see your workspace live. Set your sharing configurations wisely.

What are others looking at?

When other users are working in your workspace, they will be added to the side of your user icon. That will be to the left side of the CPU monitor. If you click on a user's icon, the option "go to active file" will be available. This will switch your active tab to the file that the other user is watching. Once there, you can look for her/his cursor too. Remember that code edition and cursors are color coded.

#Have Fun =]