groknag

Lore tracking and AI quest generation for Tabletop Role Play Games

Development

Rust

1. install Rust and Cargo
2. cargo build

Pre-Commit

1. Install pre-commit, pipx is suggested
2. pre-commit install
3. pre-commit run --all-files

htmpl

1. build and install it from here
2. run htmpl templates/pages static/html templates/base.html -w to watch for template changes and rerender during development

sqlx

cargo should install sqlx on first build.

You can rebuild a dev db using sqlx database reset.

Add migrations using sqlx migrate add -s -r add-a-new-table

Dev Server Setup

1. Install Rust using Rustup
2. Install SQLX CLI cargo install sqlx-cli
3. init the database sqlx database create
4. run cargo run
5. run htmpl templates/pages/ static/html/ templates/base.html
6. hack away

Operations

Production Server Setup

Certbot

1. isntall certbot apt install certbot
2. get cert `certbot certonly --standalone -d groknag.com
3. add certs to your env file (check cert paths with certbot certificates)

App

1. Install Rust using Rustup
2. Install SQLX CLI cargo install sqlx-cli
3. init the database sqlx database create
4. migrate the database sqlx migriate run
5. compile in your prod env cargo build --release
6. install htmpl (see above)
7. build static html templates htmpl templates/pages static/html templates/base.html
8. install and set up certbot (see above)