1
0
mirror of https://github.com/fazo96/ipfs-boards synced 2025-01-10 12:24:20 +01:00
ipfs-boards/CONTRIBUTING.md

36 lines
1.5 KiB
Markdown
Raw Permalink Normal View History

2015-11-15 21:34:22 +01:00
## Setting up a developer environment
You'll need:
- __node and npm__: you can get these on Homebrew on OSX or in your Linux distro's repos
- __git__: you can get it just like node and npm
2015-12-12 11:54:14 +01:00
- __webpack and webpack-dev-server__: you can get them by running `npm install -g webpack webpack-dev-server`. It might require super user privileges
2015-11-15 21:34:22 +01:00
- __go-ipfs__: you can get it like git and node, but not always, you may need to follow its istructions on its repo
2015-12-20 21:29:37 +01:00
- make sure you use __go-ipfs 0.4.0 or higher__. `0.4.0-dev` is fine of course.
2015-11-15 21:34:22 +01:00
1. Clone this repository and `cd` to its directory
1. run `npm install` to get dependences (there are many)
2015-12-12 11:54:14 +01:00
To fully use the app you'll need to have an IPFS daemon running. You can start one using `ipfs daemon`
2015-11-15 21:34:22 +01:00
2015-12-12 11:54:14 +01:00
You will also need to enable CORS on your IPFS daemon.
See the `ipfs_daemon_set_cors.sh` file (__Security Tip:__ don't run it before reading it!!!)
2015-11-15 21:34:22 +01:00
Now you can run:
2015-12-12 11:54:14 +01:00
- `npm run build` to build the webapp inside `webapp/dist/`
- `npm run serve` to start a webserver that will serve you the app locally and automagically rebuild it if you change some files
2015-11-15 21:34:22 +01:00
__Note about writing code:__ webpack will refuse to compile your code if
it doesn't comply with [standard](https://github.com/feross/standard)
code guidelines, which were chosen for this project to have a consistent,
proven useful standard for code style. If you want to have code linting in your
text editor on IDE, look for a plugin that can run
[eslint](https://github.com/eslint/eslint).
2015-11-15 21:34:22 +01:00
Have fun!
2015-12-04 11:07:19 +01:00
### Contributing a pull request
Make sure your code compiles fine :)