dev.md

Build Setup

# current versions are:
# node 20.5.1
# npm  9.8.0
# yarn 1.22.21

npm install -g yarn

# install dependencies
yarn install

# dev server
yarn dev
# production build (fails to open locally with file:// protocol due to cors)
yarn build

Create derivative files

Warning: this operation may result in the same puzzle repeating too often. This operation is not idempotent. Re-creating allAnswers.json will change the order of the puzzles, which could result in the same puzzle twice in a row on deploy in the worst case. As of the latest version (v2.2.0) I've made createRandomGenerator that produces pseudo-random numbers but can be given a seed to produce the same sequence of random numbers. This should make the operation idempotent.

Both steps below are bundled into yarn generatePuzzleInputs.

1. Create AllWords.txt This is only required if there are changes to wordsAdded.txt or wordsRemoved.txt.

   yarn createAllWords

2. Create allAnswers$N.json

   yarn createFiles

   AllWords.txt must already exist. It must contain a single word per line. answers.txt and pangrams.txt are created for debugging. allAnswers.json is created for use in the game.

Linting

# lint check
yarn lint
# lint autofix
yarn lintfix

Versioning

# set version prefix
yarn config set version-tag-prefix "v"

# set version explicitly
yarn version --new-version <version>

# bump minor version
yarn version --minor

Favicon

Favicons created with http://faviconer.com http://faviconer.com/user/17914

Page stats

Page counting at https://beacha.goatcounter.com/

• https://www.goatcounter.com/help/gdpr
  • github alt: https://github.com/arp242/goatcounter/blob/c8c50d8720862e605049c3492fd7b4f285de6e98/tpl/help/gdpr.markdown
• https://github.com/arp242/goatcounter/blob/c8c50d8720862e605049c3492fd7b4f285de6e98/tpl/help/consent.markdown