Skip to content

PrimalZed/haven-keeper

Repository files navigation

HavenKeeper

A scenario bookkeeping app for Gloomhaven and Frosthaven.

https://primalzed.github.io/haven-keeper

Features

  • Add Characters, Monsters, and Monster Standees to your tabletop
  • Quick reference for Monster stats for the scenario level
  • Track Hit Points and Conditions on each figure
  • Track Elemental Infusions
  • Draw Monster cards
  • Sort by Initiative order
  • Undo / Redo
    • Redo for drawing cards will draw the same card
  • View Spent / Remaining cards in monster ability deck

Peer-to-Peer

Found in the menu menu, Peer-to-Peer can be used to share the tabletop among devices in the local network.

The tabletop is saved on the host's device and shared with one or more connected guests.

As Host

  1. Select 'Host'.
  2. Add a Guest connection with add.
  3. Give the generated offer code to the guest, either by copying and sharing the offer code or by showing them the QR code to scan.
  4. Either paste the guest's answer code into the textbox and press done or scan the guest's QR code.
  5. Continue adding guests as desired.
  6. Remove a connection with delete.

As Guest

  1. Select 'Guest'.
  2. Either paste the host's offer code into the textbox and press done or scan the host's QR code.
  3. Give the generated answer code to the host, either by copying and sharing the answer code or by showing them the QR code to scan.

Close Peer-to-Peer

Close all connections and leave with logout.

Install for Offline Use

As a Progressive Web App, this app can be installed for offline use from the browser in most devices.

Tech Stack

This runs entirely in-browser, meaning there is no server-side component to it. Even the peer-to-peer works only within the local network.

Key libraries include:

Data persistence uses IndexDB

Peer-to-peer uses WebRTC

Installing for offline use is done as a Progressive Web App

TODO

  • Better way to codify "instead" element enhancements
  • Add Jaws of the Lion and Frosthaven.

Potential future features

  • Internationalization support
  • Monster attack modifier deck
  • Track character loot and xp
  • Character and monster portraits

Contributing

To report bugs or request features, please submit an Issue.

To help out with code, please submit a Pull Request.

Development server

Run npm run ng serve for a dev server. Navigate to http://localhost:4200/. The application will automatically reload if you change any of the source files.

Run npm run pwa for a dev server as a Progressive Web App. Navigate to http://localhost:8080/haven-keeper.


Gloomhaven, Forgotten Circles, Frosthaven, and Jaws of the Lion and all related properties, images and text are owned by Cephalofair Games.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published