👍🎉 First off, thanks for taking the time to contribute! 🎉👍
Working on your first Pull Request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub.
Please join our Slack channel if you have any questions or just want to say hi.
For hacking on Hydrogen you'll need to have Node.js and npm installed.
apm develop hydrogen
This will clone the hydrogen repository to ~/github unless you set the
ATOM_REPOS_HOME environment variable.
If you cloned it somewhere else, you'll want to use apm link --dev within the
package directory, followed by apm install to get dependencies.
After pulling upstream changes, make sure to run apm update.
To start hacking, run atom --dev . from the package directory.
Cut a branch while you're working then either submit a Pull Request when done
or when you want some feedback!
You can run specs by triggering the window:run-package-specs command in Atom. To run tests on the command line use apm test within the package directory.
We use Jasmine for writing specs.
We use flow for type checking. Before you make a pull request, you should run npm run flow
to see if there are any errors. If you have an error you can't fix after taking a crack at it, feel free to open your PR anyway and ask for help there.
To build the website locally run:
npm install gitbook-cli -g
gitbook install
gitbook serveOpen up http://localhost:4000 in your browser to live preview changes in the ./docs/ directory. If you want to add or remove a page in the docs, be sure to edit SUMMARY.md.
For more information take a look at https://toolchain.gitbook.com/setup.html.
npm install
npm run build-commit
apm publish patch