Lithium

A rewrite of Helium in Flask

Setup

IDE Functionality

VSCode extensions:

• Python: https://marketplace.visualstudio.com/items?itemName=ms-python.python
• Jinja template language support: https://marketplace.visualstudio.com/items?itemName=wholroyd.jinja

Project creation

Python setup

Install python: https://www.python.org/downloads/

python -m venv .venv
.venv\Scripts\activate

pip install Flask
pip install Flask-Assets
pip install Flask-Compress
pip install Flask-SocketIO
pip install watchdog
pip install cssmin
pip install jsmin

Node Setup

Install NodeJS: https://nodejs.org/en/download/prebuilt-installer

npm install
npm install -g sass

Development Debugging

# Can add in --watch if necessary, although my SCSS changes super rarely.
sass scss/index.scss scss/index.css
sass scss/math.scss scss/math.css

# Can also add in --watch for JS changes.
esbuild js/index.ts --bundle --outdir=static --sourcemap
esbuild js/puzzle.ts --bundle --outdir=static --sourcemap
esbuild js/game.ts --bundle --outdir=static --sourcemap
esbuild js/lobby.ts --bundle --outdir=static --sourcemap
esbuild js/traces.ts --bundle --outdir=static --sourcemap
esbuild js/math.ts --bundle  "--external:fonts/KaTeX*" --outdir=static --sourcemap 

flask --debug run

Production release

esbuild js/index.ts --bundle --outdir=static --minify
esbuild js/puzzle.ts --bundle --outdir=static --minify
esbuild js/game.ts --bundle --outdir=static --minify
esbuild js/lobby.ts --bundle --outdir=static --minify
esbuild js/traces.ts --bundle --outdir=static --minify
esbuild js/math.ts --bundle  "--external:fonts/KaTeX*" --outdir=static --minify

See Setup.md for more details on the production server setup.

Reference

See attributions.py for the listing of components used in this site