studyopenings

UPDATE (Dec 31 2024): After 5 years of serving studyopenings in production, I've decided to take down the site. I've financed the server costs entirely out-of-pocket and maintained the site entirely in my free time alongside a full-time job and, though I've enjoyed it until now, I no longer wish to pursue this. I wish studyopenings users the best of luck in their chess improvement journey.

What is this?

A tool to help chess players memorize opening repertoires.

The tool lets you:

• build repertoires by playing opening moves on a board and

• study repertoires by repeatedly recalling one side of the opening lines.

Credits

• Chessboard UI uses lichess' Chessground.
• Chess game logic uses chess.js.
• PGN parser uses PEG.js and the grammar from kevinludwig/pgn-parser.
• Authentication uses Auth0.
• Icons from the Noun Project.
• Tooltips use tippy.js.
• Toasts use toastr.
• Sounds from lichess and use howler.js.
• Feedback mechanism uses Doorbell.io.
• Database uses MongoDB and is hosted on MongoDB Atlas.
• Server written in Node.js.
• Client bundling uses Webpack.
• Unit tests use Jest and ts-jest.

Running locally

1. Clone the repository.
2. Install MongoDB if necessary. Then start a local MongoDB database instance:

$ mongod --dbpath ~/data/db --port 27017
[...]
waiting for connections on port 27017

3. Copy the .env file which points the application to your local database:

studyopenings/ $ cp .env.local .env

4. Run the server:

studyopenings/ $ npm install
studyopenings/ $ npm run start-dev
[...]
studyopenings is running!
Listening on 5000.
Using database path: mongodb://127.0.0.1:27017

5. Go to http://localhost:5000.

Running tests

To run all the tests once:

studyopenings/ $ npm install
studyopenings/ $ npm run test
[...]
Ran all test suites.

To run the tests continuously as changes are made:

studyopenings/ $ npm install
studyopenings/ $ jest --watch

Author

Justin Venezuela • jven@jvenezue.la • http://jvenezue.la