scrabble-solver

Table of contents

1. Dictionaries
2. Run
3. Uninstall
4. Develop
   1. Setup
   2. Run app dev server
   3. Rebuild the entire project
   4. Rebuild a single package
   5. Add a new language
5. Tech stack
6. Related projects
7. Media

Dictionaries

| Language | Word list | Word definitions | Highest-scoring word | |-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------|--------------------------------------------------------------------------------------------------------------| | 🇬🇧 English | 💾 SOWPODS | Merriam-Webster | oxyphenbutazone (1458) | | 🇺🇸 English | 💾 TWL06 | Merriam-Webster | oxyphenbutazone (1458) | | 🇫🇷 French | 💾 ODS8 | CNRTL | schizothymiques (1566) | | 🇩🇪 German | 💾 hippler/german-wordlist | DWDS | polytoxikomanem (1512) | | 🇮🇷 Persian | 💾 MansourM/persian-to-persian-dictionary | واژه یاب | ‏(756) اگزیستانسیالیست | | 🇵🇱 Polish | 💾 SJP.PL | SJP.PL | współposiądźmyż (1512) | | 🇷🇴 Romanian | 💾 LOC 5 | dexonline | luxemburghezele (1944) | | 🇪🇸 Spanish | 💾 FILE 2017 | Diccionarios.com | flexibilizabais (1323) | | 🇹🇷 Turkish | 💾 Turkish | Türk Dil Kurumu Sözlükleri | dövüşmeyeceğime (1593) |

Run

You can run Scrabble Solver on your machine - all you need is Node.js 20 or later.

npx scrabble-solver@latest

Give it a while to install and download dictionaries. When it's done it will automatically open http://localhost:3333/ in your browser.

Hit Ctrl + C in your terminal to exit the app and shut down the server.

Uninstall

Dictionaries and logs are stored in $HOME/.scrabble-solver. $HOME location is acquired using os.homedir().

rm -rf $HOME/.scrabble-solver

Develop

These steps are required only if you want to make changes to the source code.

Setup

One-time project setup.

git clone https://github.com/kamilmielnik/scrabble-solver.git
cd scrabble-solver
npm install
npm run build

Run app dev server

The following command will serve the app at http://localhost:3000/.

npm run dev

Note: hot code reload works only for the scrabble-solver package. If you make changes to any other package, you will need to rebuild it (see below).

Rebuild the entire project

npm run build

Rebuild a single package

For convenience, here's a list of commands to rebuild every package individually.

npm run build -w @scrabble-solver/configs
npm run build -w @scrabble-solver/constants
npm run build -w @scrabble-solver/dictionaries
npm run build -w @scrabble-solver/logger
npm run build -w @scrabble-solver/scrabble-solver
npm run build -w @scrabble-solver/solver
npm run build -w @scrabble-solver/types
npm run build -w @scrabble-solver/word-definitions
npm run build -w @scrabble-solver/word-lists

Add a new language

1. Find and download a flag representing the locale in an SVG format
   • I usually find them at https://commons.wikimedia.org/
2. Rename the file to FlagXX.svg and put it in packages/scrabble-solver/src/icons
3. Export the SVG file in packages/scrabble-solver/src/icons/index.ts
4. Add IETF language tag for the new locale in packages/types/src/Locale.ts
5. Rebuild the types package

   npm run build -w @scrabble-solver/types

6. Add locale configuration in packages/scrabble-solver/src/i18n/constants.ts
7. Update locale-detecting code in packages/scrabble-solver/src/lib/detectLocale.ts
8. Add game configs for the new locale in packages/configs/src/languages
9. Add an export for these locale configs in packages/configs/src/languages/index.ts
10. Add a translation file in packages/scrabble-solver/src/i18n/languages and fill it with translations
    • Copy any existing file, e.g. english.json and modify it
11. Add an entry for the translations in packages/scrabble-solver/src/i18n/i18n.ts
12. Add a function to fetch the list of words in the new locale in packages/word-lists/src/getWordList.ts
13. Add a function to fetch the word definition in the new locale in packages/word-definitions/src/crawl.ts
14. Add a function to parse the word definition crawled in the previous step in packages/word-definitions/src/parse.ts
    • Bonus points for adding tests in packages/word-definitions/src/parse.test.ts

Tech stack

• TypeScript
• Node.js
• Next.js
• Express
• Workbox
• React
• Redux
• Redux Toolkit
• Redux-Saga
• SCSS
• CSS Modules
• include-media
• Lerna
• Cypress
• Jest
• ESLint
• Prettier

Related projects

Lexatious

The user interface and source code for the web front end of Lexatious is based on Scrabble Solver.

• Web: https://lexatious.com
• GitHub: https://github.com/ericgjackson/lexatious_web

Media

• 5 Free Scrabble Solver Websites To Quickly Find Top Scoring Words