Encounter

Daggerheart encounter prep and run app for iOS and macOS, primarily for game masters who need to set up and track encounters at the table.

Built with SwiftUI, targeting iOS 26, macOS 26, and visionOS 26.

Documentation

Full documentation is hosted at gwillish.github.io/encounter (see issue #20 for CI setup).

• CLAUDE.md — full technical context, conventions, and build instructions for development with Claude Code
• docs/data-schema.md — Daggerheart JSON schema reference and source links
• docs/decisions/ — Architecture Decision Records (ADRs): the history of significant architectural, data-format, and UX choices made during development

Content Packs

Encounter supports community and homebrew content through the .dhpack format — a plain JSON file containing adversaries, environments, or both.

• .dhpack format reference — complete schema, field tables, and examples
• Authoring a pack — three paths: text editor, in-app export, or programmatic generation
• Sharing and hosting — AirDrop, URL sources, GitHub Releases, jsDelivr, Gist

The JSON Schema for .dhpack is maintained in the DHModels repository. Add "$schema": "https://raw.githubusercontent.com/gwillish/DHModels/main/schemas/dhpack.schema.json" to your pack file to enable validation and autocomplete in VS Code.

Architecture Decision Records

Significant decisions are recorded as ADRs in docs/decisions/. Each record captures why a decision was needed, what was decided, what alternatives were considered, and what consequences follow.

When a decision turns out to be wrong or needs to change, a new ADR is written that supersedes the original. The original is never edited or deleted — the reasoning history is preserved. See docs/decisions/README.md for the full process.

License & Attribution

The Encounter app source code is licensed under the MIT License.

This app bundles content from the Daggerheart System Reference Document 1.0, used under the Darrington Press Community Gaming License (DPCGL):

This product includes materials from the Daggerheart System Reference Document 1.0, © Critical Role, LLC. under the terms of the Darrington Press Community Gaming (DPCGL) License. More information can be found at https://www.daggerheart.com. There are no previous modifications by others.

Full DPCGL license text: https://darringtonpress.com/license/

See NOTICE for the complete dual-license breakdown.

This project is not affiliated with, endorsed by, or sponsored by Darrington Press, LLC or Critical Role, LLC. Daggerheart is a trademark of Critical Role, LLC.