MuzHack

MuzHack is a Web application for publishing musical instrument designs.

[](https://gratipay.com/~Arve Knudsen/)

Editing

Please install EditorConfig in your editor of choice, since we control the code standard through that (e.g. 2 spaces indentation). Specifically the EditorConfig settings are defined in the .editorconfig file.

Please also install ESLint in your editor, in order to make sure you conform to our code standards. This is configured via .eslintrc.

Development

MuzHack is developed with Node (via hapi.js) on the server and Omniscient (a functional, top-down rendering, React wrapper). The code standard is ES2015 JavaScript. We use Babel to be able to write ES2015 both on the server and on the client.

For the database we use RethinkDB, a NoSQL technology.

Local Installation

1. Enter the MuzHack Git repository.
2. Install nvm.
3. nvm install.
4. npm install.
5. If you don't have Python already, install it with brew: brew install python.
6. pip install -r requirements.txt
7. Install RethinkDB.
8. ./rethinkdb/setup-rethinkdb.py $AUTH_KEY.

Running Locally

1. In one terminal, enter the MuzHack repository.
2. Run the Node server: ./run-server
3. In another terminal, enter the MuzHack repository.
4. Run the Webpack dev server: ./node_modules/.bin/webpack-dev-server -d --inline. This serves as a front-end to the Node server, which automatically compiles resources via Webpack.
5. Access the Webpack dev server at http://localhost:8080 in your browser. The app will automatically be refreshed when you make changes to the source code thanks to Webpack's hot reload feature.