Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jkk/shinkgs
A JavaScript client for the KGS Go Server
https://github.com/jkk/shinkgs
Last synced: 8 days ago
JSON representation
A JavaScript client for the KGS Go Server
- Host: GitHub
- URL: https://github.com/jkk/shinkgs
- Owner: jkk
- License: mit
- Created: 2017-04-23T17:42:31.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2023-02-25T00:44:30.000Z (over 1 year ago)
- Last Synced: 2024-08-02T14:08:26.584Z (3 months ago)
- Language: JavaScript
- Homepage: https://shin.gokgs.com/
- Size: 4.79 MB
- Stars: 263
- Watchers: 21
- Forks: 56
- Open Issues: 175
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 
Shin KGS
[](https://travis-ci.com/jkk/shinkgs)
A semi-official JavaScript client for [KGS Go Server](http://www.gokgs.com/).
- The **official stable version** is available at https://shin.gokgs.com.
- A development version (less stable) is available at https://shinkgs-master.now.sh.
## Screenshot
## Goals
* First-class web and mobile experience
* Retain community vibe of KGS
* Start small, release early
* Work towards native versions (Electron, React Native, Cordova)
* [Bus factor](https://en.wikipedia.org/wiki/Bus_factor) > 1
## Progress
- [x] Game lists
- [x] Game spectating and chat
- [x] Room chat
- [x] User chat (direct messaging)
- [x] View and edit user details
- [x] Submit challenge proposal (no negotiating)
- [x] Create challenge
- [x] Negotiate challenge
- [ ] Automatch
- [x] Basic game playing
- [ ] Full-featured game playing (fine-tuned UI, rengo, simul)
- [ ] Review tools
- [ ] Admin/moderation tools
- [ ] Everything else
For more details, look at [the milestones](https://github.com/jkk/shinkgs/milestones)
## Contributing
Contributions welcome. Please check the [milestones](https://github.com/jkk/shinkgs/milestones) and the [issues](https://github.com/jkk/shinkgs/issues) to help coordinate efforts. Feel free to create an issue if there isn't one already for what you have in mind.
Issues with the ["difficulty-easy"](https://github.com/jkk/shinkgs/issues?q=is%3Aopen+is%3Aissue+label%3Adifficulty-easy) label are good tasks to get started on. Reach out if you need any guidance!
Discord chat group for anyone interested in helping: https://discord.gg/vwzxdVr
## Code Overview
This project uses JavaScript, React, and ES6+ with [Flow](https://flow.org/) types. [VS Code](https://code.visualstudio.com/) (with eslint and flow extensions added) is a great editor for this setup.
State is managed with a Redux-like pattern: there is a single, primary source of truth for app state, plus a bit of component-local state. Messages describing actions are dispatched, which handlers then process to produce the next app state. Unlike typical Redux, no implicit context is used. Everything is passed down through props.
## Development Setup
You'll need [Node.js](https://nodejs.org/en/) and [Yarn V1](https://classic.yarnpkg.com/en/).
To install and start a local dev server, run:
```
yarn install
yarn start
```
Requests are sent to the official KGS API by default and are proxied through the Webpack development server. If you would prefer to send requests to the KGS beta server, use the alternative `start:beta` script:
```
yarn start:beta
```
Making requests to the beta server will require HTTPS, so you will need to tell your browser to accept the self-signed certificate in order to access the page.
If you're password from the regular KGS server doesn't work (or you want another
account to test with) you can create a new one at
https://beta.gokgs.com/register/index.html.
For setting up a standalone web server you can generate just the optimized production code with ```yarn build```. This creates a build folder which can be run locally with ```yarn start:server``` or you can copy the tree to another server and run them from there. The production/beta service is currently served by nginx with a simple config like this:
```
server {
server_name shin.gokgs.com;
listen [::]:80; # if you want to allow unsecure access, o/w redirect
location / {
root /var/www/shinkgs/;
add_header X-nginx-rule 80-shinkgs always;
try_files $uri $uri/ /;
}
# add letsencrypt config here for https
```
We use Travis as a continuous integration service. The [Travis job](.travis.yml) will run `yarn lint` and `yarn flow` and fails if those fail. So make sure to use those commands locally before pushing.
## Deployment
The official and stable build lives at https://shin.gokgs.com. Each commit is also built and deployed using [Vercel](https://www.vercel.com) (previosly called *Now*) on:
```
https://shinkgs-BRANCH.now.sh
```
With `BRANCH` being one of the Git branches of this repository. For example, a live version of master is always available at https://shinkgs-master.now.sh. **Warning**: the `master` branch should always work but is certainly not bullet-proof and bug-free. Use the [official build](https://shin.gokgs.com) for any sensitive games (such as tournaments).
If you are developing the app and want to deploy in the cloud, use the [Vercel service](https://www.vercel.com):
```
# Install `vercel` globally
yarn global add vercel
# Deploy the project.
vercel
```
This builds the app then pushes it out to the cloud. If you have not used Vercel before, you will be prompted to log-in using your email before deploying.
## Troubleshooting
### Installing Node.js on Windows
It is highly recommended that you install the [Chocolatey package manager](https://chocolatey.org/) before installing Node.js on Windows. After Chocolatey is installed, make sure to check the 'Automatically install the necessary tools' checkbox when prompted during the Node.js installation. These tools are needed to build some ShinKGS dependencies.
### Vercel is not recognized
If your system does not recognize `vercel` as a command after running `yarn global add vercel`, make sure that the Yarn `bin` directory is a part of your `path` environment variable. For MacOS/Linux, this directory is usually `~/.yarn/bin`. For Windows, it will be something like `C:\Users\username\AppData\Local\Yarn\bin`. Most of the time this directory should get added to your path automatically when installing Yarn.
## References
* [KGS API Docs](https://www.gokgs.com/json/protocol.html)
* [KGS API Download](https://www.gokgs.com/help/protocol.html)
* [KGS Client Coding Google Group](https://groups.google.com/forum/#!forum/kgs-client-coding)
## Similar Projects
* [Go Universe](https://github.com/IlyaKirillov/GoUniverse)
* [KGS Leben](https://github.com/stephenmartindale/kgs-leben)