Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/johnridesabike/coronate
A Swiss-style chess tournament management app.
https://github.com/johnridesabike/coronate
chess react rescript swiss-system tournament tournament-manager webapp
Last synced: about 1 month ago
JSON representation
A Swiss-style chess tournament management app.
- Host: GitHub
- URL: https://github.com/johnridesabike/coronate
- Owner: johnridesabike
- License: mpl-2.0
- Created: 2019-03-17T11:12:45.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-08-20T17:40:38.000Z (4 months ago)
- Last Synced: 2024-11-06T10:35:27.664Z (about 1 month ago)
- Topics: chess, react, rescript, swiss-system, tournament, tournament-manager, webapp
- Language: ReScript
- Homepage: https://coronate.netlify.app/
- Size: 51.8 MB
- Stars: 148
- Watchers: 3
- Forks: 24
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-list - coronate - style chess tournament management app. | johnridesabike | 74 | (ReScript)
- awesome-rescript - Coronate - A Swiss-style chess tournament manager for the web and desktop, written with ReScript-React. [(web demo)](https://coronate.netlify.app/) (ReScript / Example Apps)
README
Coronate
Coronate is a web app for managing Swiss-style chess tournaments.
## Notice
Maintenance is currently paused for Coronate. This has almost always been a
one-person passion project, and there simply isn't time to work on it these
days. The [version hosted here](https://coronate.netlify.app/) should continue
to work for the indefinite future, and its code will always be open-source.
Anyone may use the Coronate source code in accordance with its
[license](./LICENSE).
If you have a special interest in working with Coronate that you wish to
discuss, please still feel free to reach out to me or open a GitHub issue.
## About
Coronate is a free chess tournament manager. Anyone, even a tournament newbie
with nothing but a web browser at their public library, can use it to run their
tournament.
👉 Click here to open Coronate ♟
[Read more about how to use the app here](https://johnridesa.bike/software/coronate/).
[Read the frequently asked questions here](./docs/faq.md).
## Enjoy using Coronate?
Coronate is free software, but you're welcome to show your appreciation.
## Development
You will need to install [Node.js] version 18. Coronate might run on other
versions too, but it's not tested on them.
[node.js]: https://nodejs.org/
The source code is mostly written in [ReScript] and [React], which compiles to
JavaScript. You'll need to be at least familiar with these languages and their
toolchains.
[rescript]: https://rescript-lang.org/
[react]: [https://reactjs.org/]
### Installing
For most people, the easiest method is to click the "Clone or Download" button
on [this project's GitHub homepage](https://github.com/johnridesabike/coronate).
If you have Git installed, you can run:
```
git clone https://github.com/johnridesabike/coronate.git
```
If you want to make your own changes, then you should fork this repository on
GitHub and clone your forked version.
Once you have a local copy of the code, run this command in the project's
directory to install its dependencies:
```
npm install
```
## Usage
Coronate works completely in your local browser.
First run this to compile the ReScript source:
```
npm run build:rescript
```
Alternatively, you can run the compiler in watch mode:
```
npm run start:rescript
```
Then run this to start a development version of the app:
```
npm start
```
This will start a server hosting Coronate on your computer. You can then open
the app by clicking the link it shows you.
The server works with the JavaScript files that are created by the ReScript
compiler. If you edit the ReScript source, it will need to recompile before the
changes appear in the live app.
The app keeps your data in your browser's storage, so be mindful that data loss
can happen unexpectedly depending on your settings. The app's "options" page has
a button to back up your data in an external file.
### Other commands
To execute the tests, run:
```
npm test
```
To create an optimized version for your own website, run:
```
npm run build
```
To automatically format all of the ReScript source files, run:
```
npm run format
```
## Contributing, hacking, and more
[See this document with information about contributing.](CONTRIBUTING.md)
Coronate tries to have easy-to-use formats so users can truly own their data.
[For example, you can use this python script to output standings](https://github.com/johnridesabike/coronate/issues/90).
## Acknowledgments
The three "kings" in the logo are derived from the Mérida chess font, which is
informally licensed as "freeware."
Some human interface decisions (colors, buttons, etc.) are based on the
[Photon Design System](https://design.firefox.com/photon/) for an elegant,
OS-neutral, appearance.