|
Roll20 Sheet Build Successful The Ravenous Roll20 sheet was generated and validated successfully.
Ravenous/ravenous_roll20/pipeline/head This commit looks good
Details
|
||
|---|---|---|
| .. | ||
| src | ||
| tests | ||
| tools | ||
| AGENT.md | ||
| AGENTS.md | ||
| README.md | ||
| TASKS.md | ||
README.md
Ravenous Craft Workshop
This subproject will build a static, offline-capable website for composing,
checking, saving, sharing, and exporting Ravenous crafts. It is intentionally
kept inside this repository so that every published catalog is generated from
the exact ravenous_typst revision used by the Roll20 sheet.
The intended implementation is deliberately boring to deploy:
- Python 3.11 generates normalized JSON and the static bundle;
- the browser application uses dependency-free HTML, CSS, and JavaScript;
- no Node.js, application server, database, account, or CDN is required;
- Jenkins can build it on FreeBSD 13 and publish it below
RPG/; - recipes work offline and remain on the player's device unless explicitly downloaded, copied, or encoded in a share link/QR code.
The product scope and implementation phases are in TASKS.md. The authoritative development rules and source map are in AGENTS.md.
Current proof of concept
The first deployable prototype includes the complete generated catalogue, all
book themes, responsive filtering and sorting, a component workspace with basic
totals, browser-local saving, and a provisional Roll20 export. It demonstrates
the intended information architecture and visual direction; discipline-specific
rules and authoritative final-output mapping remain tracked in TASKS.md.
uv run python craft_web/tools/build.py
uv run python -m unittest discover -s craft_web/tests -v
uv run python craft_web/tools/build.py --check
Jenkins publishes production at /RPG/ravenous_craft/, with _candlelight
and _lighthouse siblings for development and review branches.
Proposed user experience
The home screen is a searchable catalog and recipe workspace. A player chooses one of Forge, Restauration, Alchimie, Brasserie, or Pièges, enters their artisan limits, then adds compatible components. Totals, derived output, constraints, and warnings update immediately. Filters include mastery/tier, difficulty, toxicity, cost, finishing budget, equipment category, and discipline-specific values such as satiety, titrage, or preparation time.
Recipes can be named, duplicated, pinned, sorted, and stored locally. They can be exported as:
- an editable Ravenous Workshop recipe file;
- finalized
ravenous-roll20-craftversion 1 JSON; - a print-friendly recipe card;
- a compact link or QR code when the encoded recipe fits safely.
Import accepts Workshop recipes and Roll20 craft JSON. Roll20 imports are treated as finalized items and may not be fully reversible into source ingredients.
Architecture boundary
ravenous_typst remains the rules and content authority. The generator will
read its TSV files, data/src/db/weapons.db, glossary YAML, theme definitions,
and data/config/recipes.yaml. Browser code consumes only generated normalized
data; it must not contain a second hand-maintained copy of ingredients or
rules.
The website's editable recipe document and the Roll20 exchange document serve different purposes:
ravenous-workshop-reciperecords selected source components, user inputs, and source-data version so the recipe can be reopened and recalculated;ravenous-roll20-craftrecords final sheet rows accepted by the existing Mod importer and JSON Schema.
That separation is a proposed design decision and is called out for approval in Phase 0 of the task list.