ThunderFlurry

ThunderFlurry is a nodejs based web server providing management of motion picture productions. It is currently under development and has not been released.

Collaborate With Us

We use Slack for communications. Your input on this project is extremely valuable to us, so please join the conversation today!

Browser Support

We support most browsers, which is the point of using our module in the first place :-)

Internet Explorer 9+
Edge
Firefox 0.8+
Chrome 1+
Safari 3+
Opera 8+ (including Opera Next)

Building the code

Required Tools

Node
- Development requires Node 5.0+
- Building is tested with Node 5.8 on Windows, Mac OS, and Ubuntu
- Compiled Server requires Node 4.2+ or 5.0+
- Compiled Server is tested with:
  - Node 4.4/5.8 on Windows, Mac OS, Ubuntu
  - Node 4.2 on Amazon EBS with a EC2 micro installation
NPM (prefer 2+)
Grunt

This list is currently in flux as the foundation is released.

Optional Tools

WebStorm (Project Editor)

check out the source code

#create your project directory
$ mkdir thunderflurry

#change to the directory you made
$ cd thunderflurry

#clone this repository
$ git clone https://github.com/thunderflurry/thunderflurry.git .

# BUILD using npm and grunt:
$ npm install

# If you want to send us changes, you should fork
# the project into your own account first, and use
# that URL to clone it.

# If you fork it later you can just change the origin by:

# move the old origin out of the way. You could delete it if you want.
$ git remote rename origin upstream

# add your repo url as the origin:
# e.g. [email protected]:victoriafrench/thunderflurry.git
$ git remote add origin <your-repo-url>

# to run the project from npm:
$ npm run

# open your web browser and visit http://localhost:3000

License

ThunderFlurry is licensed under the Apache 2.0 license. Copyright and related rights for sample code as defined in the project's LICENSE.md file are waived via CC0.

Project Dashboard

You can see issues, pull requests, backlog items, etc. in the OneGet Dashboard

Stage	Stats
Pending
Development
QA

Throughput Graph

Branches

There are currently three branches in the git repository:

Branch/Tag	Purpose
`master`	The `master` branch is where the daily builds are made from.
`greenkeeper-*`	Automated branch created by greenkeeper to tell us to update a dependency in the project
`qa`	Branch specific to qa testing.
`gh-pages`	Git hub pages storage.
`cloud`	Branch of what is running in the cloud which may have modifications not part of the project.
`spike/*`	Experiments that are being run.

Contributing

To push contributions to us, we require that all contributors sign our Contributor License Agreement (CLA). All pull-requests are checked against the signature database before being accepted.

The following flow is used to contribute to this project. No person has direct access to push code.

Your first step is to fork the code to your github account. Then clone your fork.

# create your project directory
$ mkdir thunderflurry

# change to the directory you made
$ cd thunderflurry

# clone this repository
$ git clone https://github.com/<YOUR GITHUB NAME>/thunderflurry.git .

# add us as the upstream remote server
$ git remote add upstream https://github.com/thunderflurry/thunderflurry.git

# try to never make changes in your master, so lets create a branch to work in
$ git checkout -b <working branch name>

# now make the changes you want
# when you are ready to send them back flatten your checkins to a new branch for us
# make sure we are on the master branch
$ git checkout master

# let's make sure we have the latest code updates
$ git merge upstream/master

# we are going to create a pull request branch from this updated code
$ git checkout -b <push branch name>

# now we pull your new code in as a single commit
$ git merge --squash <working branch name>

# if there are errors they need to be fixed and checked in.
# make sure everything compiles and runs
$ npm install
$ npm build
$ npm test

# if all works then lets push the code to github
$ git push origin <push branch name>

# visit your github account fork and there will be a green button to make a pull request.
# click it and your done!

# to remove the branches
$ git checkout master
$ git branch -D <working branch name>
$ git branch -D <push branch name>

# once we have accepted your pr you can update your system.
$ git checkout master
$ git merge upstream/master
$ git push origin master

# now your changes have come back merged with ours.