MuzHack is a Web application for publishing musical instrument designs.

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

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.

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.

1. Enter the MuzHack Git repository.
2. Get Git submodules: git submodule update --init --recursive
3. Install nvm.
4. nvm install.
5. npm install.
6. If you don't have Python 3 already, install it with brew: brew install python3.
7. pip3 install -r requirements.txt
8. Install RethinkDB.
9. ./rethinkdb/setup-rethinkdb.py.

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.