quizbowlreader_ts_react_mobx v0.1.0

Introduction

MODAQ (MODerator Assistant for Quizbowl) is an application for assisting moderators with reading and scorekeeping quiz bowl matches. It helps track all the events that occur during the match, such as buzzes, substituions, protests, and more. It also tracks buzz point data, and can export it to Lifsheets or a JSON file.

See the wiki to learn how to use the reader.

Getting Started

You will need to have npm and yarn installed on your system.

To setup the project, run

npm init

Then

npm build

Then open index.html.

VS Code is recommended as an IDE, although you can use whatever editor you like. If you install VS Code, be sure to install the Prettier VS Code extension.

Build and Test

To build, run

npm build

To run the tests, run

npm test

If you want to use the Dev Server (required for testing Google Sheets), then do the following

• Add this entry to your HOSTS file (in Windows, at C:\Windows\System32\drivers\etc\hosts)

  127.0.0.1 localhost.quizbowlreader.com

• Run npm start

• Open https://localhost.quizbowlreader.com:8080/out

  • You can either accept the HTTPS certificate, or you can create your own self-signed cert and add it to a certificate store. This PowerShell script should work in Windows, although I haven't tried this approach yet.

  $cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname localhost.quizbowlreader.com -KeyAlgorithm ECDSA_nistP256

Contribute

Contributions are welcomed. Please verify that npm lint and npm test succeed without warnings or failures before submitting a pull request.