orcpub

.clj-kondo/config.edn

@@ -0,0 +1,74 @@
+{:output {:exclude-files [".*resources/public/js/compiled.*"
+                          ".*docker/scripts/.*"]}
+ :linters {:shadowed-fn-param {:level :off}
+           :shadowed-var {:level :off}
+           :unused-namespace {:level :off}
+           :unused-binding {:level :off}
+           :missing-else-branch {:level :warning}
+           :clojure-lsp/unused-public-var
+           {:exclude [user                              ; REPL utilities
+                      orcpub.styles.core/app
+                      ;; LSP can't trace cross-file references to these —
+                      ;; all are called from classes.cljc (live code)
+                      orcpub.dnd.e5.options/monk-elemental-disciplines
+                      orcpub.dnd.e5.options/spell-tags
+                      orcpub.dnd.e5.options/potent-spellcasting
+                      ;; Live callers exist but LSP can't trace them
+                      orcpub.common/dissoc-in                ; events.cljs
+                      orcpub.dnd.e5.character/add-ability-namespaces ; test
+                      ;; Cross-file refs: used in template.cljc but defined in spell_subs.cljs
+                      orcpub.dnd.e5.spell-subs/sunlight-sensitivity
+                      orcpub.dnd.e5.spell-subs/mask-of-the-wild-mod]
+            ;; re-frame event handlers are dispatched via keyword, not var reference.
+            ;; LSP can't connect reg-event-db registration to (dispatch [:keyword]).
+            :exclude-when-defined-by #{re-frame.core/reg-event-db
+                                        re-frame.core/reg-event-fx
+                                        re-frame.core/reg-sub
+                                        re-frame.core/reg-sub-raw}}
+           ;; garden.selectors vars are generated by macros (defselector,
+           ;; defpseudoclass, gen-pseudo-class-defs, etc.) at compile time.
+           ;; clj-kondo can't resolve macro-generated vars statically and
+           ;; garden doesn't ship a clj-kondo config.
+           :unresolved-var
+           {:exclude [garden.selectors
+                      ;; errors.cljc macros behind #?(:clj) reader conditional —
+                      ;; one kondo instance can't resolve them
+                      orcpub.errors]}
+           ;; read-string is a valid cljs.core symbol that clj-kondo
+           ;; doesn't recognize in its ClojureScript analysis data.
+           :unresolved-symbol
+           {:exclude
+            [read-string
+             (clojure.test.check.clojure-test/defspec)
+             (clojure.core.match/match)
+             (cljs.core.match/match)
+             (io.pedestal.interceptor.error/error-dispatch)
+             (orcpub.modifiers/modifier)
+             (orcpub.modifiers/deferred-modifier)
+             (orcpub.modifiers/cum-sum-mod)
+             (orcpub.modifiers/vec-mod)
+             (orcpub.modifiers/set-mod)
+             (orcpub.modifiers/map-mod)
+             (orcpub.modifiers/fn-mod)
+             (orcpub.dnd.e5.modifiers/spells-known-cfg)
+             (orcpub.dnd.e5.modifiers/prop-trait)
+             (orcpub.dnd.e5.modifiers/dependent-trait)
+             (orcpub.dnd.e5.modifiers/dependent-trait-2)
+             (orcpub.dnd.e5.modifiers/skill-proficiency)
+             (orcpub.dnd.e5.modifiers/skill-expertise)
+             (orcpub.dnd.e5.modifiers/tool-expertise)
+             (orcpub.dnd.e5.modifiers/ac-bonus-fn)
+             (orcpub.dnd.e5.modifiers/attack)
+             (orcpub.dnd.e5.modifiers/action)
+             (orcpub.dnd.e5.modifiers/bonus-action)
+             (orcpub.dnd.e5.modifiers/reaction)
+             (orcpub.dnd.e5.modifiers/level-val)
+             (orcpub.entity-spec/make-entity)
+             (orcpub.routes-test/with-conn)
+             (orcpub.routes.folder-test/with-conn)
+             (user/with-db)]}}
+ :lint-as {reagent.core/with-let clojure.core/let
+           hiccup.def/defhtml clojure.core/defn
+           user/with-db clojure.core/let
+           clojure.test.check.clojure-test/defspec clojure.test/deftest}
+}

.dockerignore

@@ -0,0 +1,11 @@
+# ignore .git and .cache folders
+.git
+.cache
+.idea
+.github
+docker-compose*
+test/*
+*.md
+data/*
+log/*
+backups/*

.env.example

@@ -0,0 +1,42 @@
+# ============================================================================
+# Dungeon Master's Vault — Docker Environment Configuration
+#
+# Copy this file to .env and update the values:
+#   cp .env.example .env
+#
+# Or run the setup script to generate .env with secure random values:
+#   ./docker-setup.sh
+# ============================================================================
+
+# --- Application ---
+PORT=8890
+
+# --- Datomic Database ---
+# ADMIN_PASSWORD secures the Datomic admin interface
+# DATOMIC_PASSWORD is used by the application to connect to Datomic
+# The password in DATOMIC_URL must match DATOMIC_PASSWORD
+ADMIN_PASSWORD=change-me-admin
+DATOMIC_PASSWORD=change-me-datomic
+DATOMIC_URL=datomic:free://datomic:4334/orcpub?password=change-me-datomic
+
+# --- Security ---
+# Secret used to sign JWT tokens (20+ characters recommended)
+SIGNATURE=change-me-to-something-unique-and-long
+
+# --- Email (SMTP) ---
+# Leave EMAIL_SERVER_URL empty to disable email functionality
+EMAIL_SERVER_URL=
+EMAIL_ACCESS_KEY=
+EMAIL_SECRET_KEY=
+EMAIL_SERVER_PORT=587
+EMAIL_FROM_ADDRESS=
+EMAIL_ERRORS_TO=
+EMAIL_SSL=FALSE
+EMAIL_TLS=FALSE
+
+# --- Initial Admin User (optional) ---
+# Set these then run: ./docker-user.sh init
+# Safe to run multiple times — duplicates are skipped.
+INIT_ADMIN_USER=
+INIT_ADMIN_EMAIL=
+INIT_ADMIN_PASSWORD=

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+# These are supported funding model platforms
+patreon: DungeonMastersVault

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+
+If applicable, add screenshots to help explain your problem.
+
+**Desktop (please complete the following information):**
+
+ - OS: [e.g. iOS]
+ - Browser [e.g. chrome, safari]
+ - Version [e.g. 22]
+
+**Smartphone (please complete the following information):**
+
+ - Device: [e.g. iPhone6]
+ - OS: [e.g. iOS8.1]
+ - Browser [e.g. stock browser, safari]
+ - Version [e.g. 22]
+
+**Additional context**
+
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Motivation / Use Case**
+
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Expected Behavior**
+
+A clear and concise description of what you want to happen.
+
+**Other Information**
+
+A clear and concise description of any alternative solutions or features you've considered.

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Description:
+
+**Related issue (if applicable):** fixes #<issue number goes here>
+
+## Checklist:
+  - [ ] The code change is tested and works locally.
+  - [ ] I have commented my code, particularly in hard-to-understand areas
+  - [ ] I have made corresponding changes to the documentation if necessary
+  - [ ] There is no commented out code in this PR.
+  - [ ] My changes generate no new warnings (check the console)