Boilerplate project for MOTW Workshop 2015
HTML CSS JavaScript Shell
Latest commit 1955b42 Mar 4, 2016 @hoch added theremin example
Permalink
Failed to load latest commit information.
app updated 0.0.6 Oct 2, 2015
tutorials added theremin example Mar 3, 2016
.gitignore updated 0.0.6 Oct 2, 2015
LICENSE Initial commit May 14, 2015
README.md updated README Sep 9, 2015
gulpfile.js updated 0.0.6 Oct 2, 2015
motw_install.sh updated shell script Sep 10, 2015
package.json updated 0.0.6 Oct 2, 2015

README.md

MOTW Workshop: Boilerplate Project

This repository is the boilerplate project for "Musicking on the Web" workshop. The MOTW workshop 2015 will be hosted by Google Campus Seoul and be a part of Music 220A class at CCRMA at Stanford University.

Prerequisites

Note that the installation of these prerequisites may require the system admin privileges.

Get the code

Run the command in the terminal. Be creative with your directory name:

git clone https://github.com/hoch/motw-2015.git MY_DIR

Installation

Move into the project directory and run the command:

cd MY_DIR
./motw_install.sh

How to Get Started

Make sure you are in the project root directory before running the following commands.

  • Take a look around the workshop tutorials on the local tutorial server. Stop the server when you're ready to write your own code.
# start tutorial server
gulp tutorials
  • Then start up the development server and do your work. Any change in the app directory will trigger the refresh in the browser automatically.
# start development server
gulp app

Deployment

Before deploying your project, be sure to create a GitHub repository.

  • Note that the git configuration MUST be changed to route the deployment to your remote target repository. You only have to do this once with your own USERNAME and MY_REPO.
# Change remote origin.
git remote set-url origin https://github.com/USERNAME/MY_REPO.git
  • Note that you have to build the application at least once to have the app directory ready.
# Build the application and commit/push to master.
git commit -am 'initial commit'
git push origin master
  • If you are ready to upload the content, deploy the app directory to gh-pages branch with the following command. You might have to type your credential in the process. If you're getting errors, consider change the name of your directory.
# Deploy site to gh-pages branch.
$ gulp deploy-app

To access the deployed site, open the URL in your browser. Make sure to change USERNAME and MY_REPO accordingly. For example, the deployed site of the current repository is https://hoch.github.io/motw-2015.

https://USERNAME.github.io/MY_REPO

LICENSE

Copyright (c) 2015 Hongchan Choi. The MIT License.