Getting setup is easy, you'll need to have node.js installed, then simply clone the repository and within the working directory run the following:
# You only need to run this the first time
sudo npm install -g yarn
yarn install
npx husky install
# Run this to start the development server and build system
npm run dev
If you're on linux, you can simply type make
and it will do all this for you as well.
Once running, you can then navigate to http://dev.beta.online-go.com:8080/ which loads the interface from your local server that you just started with gulp, and connects to the beta server for testing.
- Sign up for a GitHub account.
- Search the issue tracker to see if the problem is already submitted or the request for an enhancement exists.
- Submit an issue if one does not exist. Please include as much of the below information as possible:
- A clear summary.
- Operating System tested on.
- Browser used when bug appeared (or multiple browsers if you have replicated the bug.)
- Browser version.
- Steps to reproduce the issue.
- Any additional information that you might think is useful.
- Fork the repository.
- If you haven't done so, set up git.
- Clone the repository to your computer. (Found in step 2 of "keeping your fork synced" in the fork a repo help article.)
- To ensure you track the latest updates, you will want to configure git to sync your fork with the original online-go repository. (See step 3 in the same article.)
- Create a branch on your local machine. Name it something that makes sense for your updates.
- This could also be done from the git bash command line.
- If you used the first method, you will need to ensure you pull down your project's remote branches.
- Make the desired changes in the code or documentation.
- Add, commit, and push your changes to your forked repository.
- Navigate to the branch you created in your forked repository on github.
- Select
New Pull Request
. - Write an appropriate title and comment for the proposed updates.
- Create the pull request.
This project is largely built with Typescript and React. If you are unfamiliar with these, please take a few minutes to familiarize yourself.