pf2e-party-tracker 0.1.0

package/src/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="#6c7a89" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M12 2.6 4.5 5.3v6.2c0 4.6 3.1 7.9 7.5 9.9 4.4-2 7.5-5.3 7.5-9.9V5.3z"/>
+  <circle cx="12" cy="9.3" r="1.7"/>
+  <path d="M8.7 15.4a3.4 3.4 0 0 1 6.6 0"/>
+</svg>

package/src/manifest.webmanifest

@@ -0,0 +1,14 @@
+{
+  "name": "PF2e Party Tracker",
+  "short_name": "Party Tracker",
+  "description": "A GM's Pathfinder 2e party tracker — passive stats, secret checks, exploration activities, offline.",
+  "start_url": ".",
+  "scope": ".",
+  "display": "standalone",
+  "orientation": "landscape",
+  "background_color": "#14161b",
+  "theme_color": "#14161b",
+  "icons": [
+    { "src": "icon.svg", "sizes": "any", "type": "image/svg+xml", "purpose": "any maskable" }
+  ]
+}

package/src/styles.css

@@ -0,0 +1,298 @@
+/* ============================================================
+   THEME TOKENS — base tokens flip with [data-theme]; --accent (+ ink)
+   is set by JS (custom palette). Accent shades derive via color-mix().
+   ============================================================ */
+:root{
+  --accent:#6c7a89;
+  --accent-ink:#ffffff;
+  --accent-dim:color-mix(in srgb, var(--accent) 55%, var(--line));
+  --accent-soft:color-mix(in srgb, var(--accent) 14%, transparent);
+  --accent-text:var(--accent);
+  --radius:14px;
+}
+:root, :root[data-theme="dark"]{
+  color-scheme:dark;
+  --bg:#14161b; --surface:#1d2027; --surface-2:#262a33;
+  --ink:#e8eaf0; --muted:#9aa1b0; --line:#2f3440;
+  --heal:#5bbf7e; --harm:#d9637a; --info:#6fa8dc; --warn:#d6a94a;
+  --accent-text:var(--accent);
+  --shadow:0 1px 2px rgba(0,0,0,.4), 0 4px 14px rgba(0,0,0,.22);
+}
+:root[data-theme="light"]{
+  color-scheme:light;
+  --bg:#f4f5f8; --surface:#ffffff; --surface-2:#eef0f4;
+  --ink:#1b1e24; --muted:#5d6470; --line:#dfe3ea;
+  --heal:#2f9e5b; --harm:#c43a57; --info:#2b6cb0; --warn:#9a6b12;
+  --accent-text:color-mix(in srgb, var(--accent) 72%, #000);
+  --shadow:0 1px 2px rgba(20,30,50,.08), 0 4px 14px rgba(20,30,50,.06);
+}
+
+*{box-sizing:border-box;-webkit-tap-highlight-color:transparent;}
+html,body{margin:0;padding:0;background:var(--bg);}
+body{
+  color:var(--ink);
+  font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;
+  font-size:16px; line-height:1.5; -webkit-text-size-adjust:100%;
+}
+h1,h2,h3{margin:0 0 .4em;line-height:1.2;letter-spacing:-.01em;}
+h1{font-size:1.25rem;font-weight:800;}
+h2{font-size:1.05rem;font-weight:700;}
+p{margin:.4em 0;}
+.hide{display:none !important;}
+.icn{display:inline-block;width:1em;height:1em;flex:0 0 auto;vertical-align:-.14em;}
+.icn.flip{transform:rotate(180deg);}
+button,.chip,input,select,textarea,.rrow,details.ref{transition:background-color .15s ease,border-color .15s ease,color .15s ease;}
+
+/* ---- Header ---- */
+header.top{
+  background:linear-gradient(180deg, color-mix(in srgb, var(--accent) 9%, var(--surface)), var(--surface));
+  border-bottom:1px solid var(--line);
+  padding:12px 20px; position:sticky; top:0; z-index:30;
+}
+.tophead{display:flex;align-items:center;justify-content:space-between;gap:10px;max-width:1200px;margin:0 auto;}
+header.top h1{margin:0;display:flex;align-items:center;gap:9px;}
+.apptitle-ic{display:inline-flex;color:var(--accent-text);width:1.3rem;height:1.3rem;}
+header.top .sub{color:var(--muted);font-size:.82rem;margin:2px auto 0;max-width:1200px;}
+.menubtn{
+  flex:0 0 auto;background:var(--surface-2);border:1px solid var(--line);border-radius:11px;
+  width:40px;height:40px;color:var(--accent-text);display:inline-flex;align-items:center;justify-content:center;
+}
+.menubtn .icn{width:1.25rem;height:1.25rem;}
+
+/* ---- Top tab nav ---- */
+nav.tabs{
+  position:sticky;top:0;z-index:20;background:var(--surface);border-bottom:1px solid var(--line);
+  display:flex;gap:2px;justify-content:center;padding:0 12px;
+}
+nav.tabs button{
+  background:none;border:none;color:var(--muted);font-family:inherit;font-weight:700;font-size:.92rem;
+  padding:12px 16px;display:inline-flex;align-items:center;gap:7px;cursor:pointer;
+  border-bottom:2px solid transparent;
+}
+nav.tabs button .ic{display:inline-flex;width:1.1rem;height:1.1rem;}
+nav.tabs button:hover{color:var(--ink);}
+nav.tabs button.on{color:var(--accent-text);border-bottom-color:var(--accent);}
+
+/* ---- Layout ---- */
+.wrap{max-width:1200px;margin:0 auto;padding:20px 20px 60px;}
+.panel{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);padding:18px;box-shadow:var(--shadow);}
+.meta{font-size:.9rem;color:var(--muted);}
+.meta b{color:var(--ink);font-weight:600;}
+.hint{font-size:.82rem;color:var(--muted);}
+.hint b{color:var(--accent-text);}
+.empty{text-align:center;color:var(--muted);padding:52px 20px;}
+.empty h2{color:var(--ink);}
+
+/* ---- Buttons ---- */
+button{font-family:inherit;cursor:pointer;}
+.btn{
+  display:block;width:100%;padding:13px;border-radius:11px;border:none;
+  background:var(--accent);color:var(--accent-ink);font-weight:800;font-size:1rem;margin:12px 0;box-shadow:var(--shadow);
+  display:flex;align-items:center;justify-content:center;gap:8px;
+}
+.btn.secondary{background:var(--surface-2);color:var(--accent-text);border:1px solid var(--accent-dim);box-shadow:none;}
+.btn.sm{width:auto;padding:9px 15px;font-size:.9rem;margin:0;border-radius:9px;}
+.btn:active{transform:translateY(1px);}
+
+/* ---- Fields ---- */
+label.field{display:block;margin:12px 0;}
+label.field.inline{margin:0;}
+label.field .name{display:block;font-weight:700;margin-bottom:6px;font-size:.92rem;}
+label.field .hint{font-weight:400;}
+input,select,textarea{
+  width:100%;padding:11px;font-size:1rem;border-radius:10px;font-family:inherit;
+  background:var(--surface-2);color:var(--ink);border:1px solid var(--line);appearance:none;-webkit-appearance:none;accent-color:var(--accent);
+}
+input:focus,select:focus,textarea:focus{outline:none;border-color:var(--accent);}
+select{background-image:linear-gradient(45deg,transparent 50%,var(--muted) 50%),linear-gradient(135deg,var(--muted) 50%,transparent 50%);
+  background-position:calc(100% - 20px) center,calc(100% - 14px) center;background-size:6px 6px,6px 6px;background-repeat:no-repeat;padding-right:38px;}
+textarea{resize:vertical;line-height:1.4;}
+input[type="color"]{padding:4px;height:42px;cursor:pointer;}
+input[type="number"]{-moz-appearance:textfield;}
+.row{display:flex;gap:12px;}
+.row.tight{gap:8px;align-items:center;}
+.row.tight .btn{margin:0;}
+.row>*{flex:1;}
+
+/* ============================================================
+   ROSTER TABLE
+   ============================================================ */
+table.roster{width:100%;border-collapse:collapse;font-variant-numeric:tabular-nums;}
+.roster thead th{
+  position:sticky;top:49px;background:var(--surface-2);z-index:5;
+  font-size:.72rem;text-transform:uppercase;letter-spacing:.5px;color:var(--muted);font-weight:700;
+  padding:9px 8px;text-align:center;border-bottom:1px solid var(--line);
+}
+.roster th.c-name{text-align:left;padding-left:14px;}
+.roster th .passv{font-size:.62rem;color:var(--muted);opacity:.7;margin-left:3px;text-transform:none;}
+.roster td{padding:10px 8px;border-bottom:1px solid var(--line);text-align:center;vertical-align:middle;}
+.roster td.num{font-weight:700;font-size:1rem;}
+.roster td.num.strong{font-size:1.1rem;color:var(--accent-text);}
+.roster td .passv{display:inline-block;margin-left:5px;font-size:.72rem;font-weight:600;color:var(--muted);}
+.roster td.c-name{text-align:left;padding-left:14px;max-width:280px;}
+.roster td.c-exp{width:34px;color:var(--muted);}
+.rrow{cursor:pointer;}
+.rrow:hover{background:var(--accent-soft);}
+.rrow.open{background:var(--accent-soft);}
+.pname{font-weight:700;font-size:1rem;}
+.pmeta{font-size:.78rem;color:var(--muted);margin-top:1px;}
+.rconds{margin-top:4px;display:flex;flex-wrap:wrap;gap:4px;}
+.condchip{font-size:.68rem;font-weight:700;background:var(--surface-2);border:1px solid var(--line);color:var(--muted);border-radius:6px;padding:1px 6px;}
+.condchip.crit{background:color-mix(in srgb,var(--harm) 18%,var(--surface));border-color:color-mix(in srgb,var(--harm) 45%,var(--line));color:var(--harm);}
+
+.hpwrap{display:flex;flex-direction:column;align-items:center;gap:3px;min-width:74px;}
+.hpbar{width:70px;height:7px;border-radius:4px;background:var(--surface-2);border:1px solid var(--line);overflow:hidden;}
+.hpfill{height:100%;background:var(--heal);}
+.hpfill.mid{background:var(--warn);}
+.hpfill.low{background:var(--harm);}
+.hpnum{font-size:.8rem;font-weight:700;}
+.hptemp{color:var(--info);margin-left:3px;}
+
+/* ---- Expanded detail ---- */
+.rdetail td{padding:0;background:var(--surface-2);}
+.detail{border-left:4px solid var(--accent);padding:16px 18px;display:grid;grid-template-columns:1fr 1fr;gap:18px 26px;}
+.dsec.live,.dsec:first-child{grid-column:1 / -1;}
+.dsec-h{font-size:.72rem;text-transform:uppercase;letter-spacing:.6px;color:var(--accent-text);font-weight:800;margin-bottom:8px;border-bottom:1px solid var(--line);padding-bottom:4px;}
+.dsec-note{float:right;color:var(--muted);font-weight:600;text-transform:none;letter-spacing:0;}
+.abrow{display:flex;gap:8px;flex-wrap:wrap;}
+.abcell{flex:1;min-width:64px;text-align:center;background:var(--surface);border:1px solid var(--line);border-radius:9px;padding:7px 4px;}
+.ablbl{display:block;font-size:.66rem;color:var(--muted);letter-spacing:.5px;}
+.abmod{display:block;font-size:1.15rem;font-weight:800;color:var(--accent-text);}
+.skgrid{display:grid;grid-template-columns:repeat(auto-fill,minmax(150px,1fr));gap:5px 12px;}
+.skcell{display:flex;align-items:baseline;gap:6px;padding:3px 0;border-bottom:1px dotted var(--line);}
+.skcell.lore .skname{font-style:italic;}
+.skname{flex:1;font-size:.9rem;}
+.skmod{font-weight:800;font-size:.95rem;}
+.skpsv{font-size:.72rem;color:var(--muted);width:22px;text-align:right;}
+.dfacts{display:flex;flex-direction:column;gap:4px;font-size:.9rem;}
+.dfacts b{color:var(--accent-text);font-weight:700;margin-right:4px;}
+.castrow{margin-top:8px;display:flex;flex-wrap:wrap;gap:6px;}
+.castchip{font-size:.8rem;background:var(--surface);border:1px solid var(--accent-dim);color:var(--accent-text);border-radius:7px;padding:3px 8px;font-weight:600;}
+.dactions{grid-column:1 / -1;display:flex;justify-content:flex-end;}
+
+/* ---- Live tracking ---- */
+.livewrap{display:flex;flex-direction:column;gap:10px;}
+.liverow{display:flex;flex-wrap:wrap;align-items:center;gap:12px;}
+.hpctl{display:flex;align-items:center;gap:7px;flex-wrap:wrap;}
+.hpin{width:62px;text-align:center;padding:7px;}
+.amtin{width:52px;text-align:center;padding:7px;}
+.stlbl{font-size:.72rem;text-transform:uppercase;letter-spacing:.5px;color:var(--muted);font-weight:700;}
+.stbtn{background:var(--surface);border:1px solid var(--line);color:var(--ink);border-radius:8px;padding:7px 11px;font-weight:800;font-size:.9rem;}
+.stbtn.harm{color:var(--harm);border-color:color-mix(in srgb,var(--harm) 40%,var(--line));}
+.stbtn.heal{color:var(--heal);border-color:color-mix(in srgb,var(--heal) 40%,var(--line));}
+.heroctl{display:flex;align-items:center;gap:6px;}
+.pip{width:20px;height:20px;border-radius:50%;border:2px solid var(--accent);background:transparent;padding:0;}
+.pip.full{background:var(--accent);}
+.stepper{display:inline-flex;align-items:center;gap:7px;background:var(--surface);border:1px solid var(--line);border-radius:9px;padding:4px 8px;}
+.stval{min-width:16px;text-align:center;font-weight:800;color:var(--muted);}
+.stval.on{color:var(--accent-text);}
+.condbtns{display:flex;flex-wrap:wrap;gap:6px;}
+.condbtn{background:var(--surface);border:1px solid var(--line);color:var(--muted);border-radius:8px;padding:5px 10px;font-size:.82rem;font-weight:700;}
+.condbtn.on{background:var(--accent);color:var(--accent-ink);border-color:var(--accent);}
+.activeconds{display:flex;flex-wrap:wrap;gap:8px;}
+.activecond{display:inline-flex;align-items:center;gap:5px;background:color-mix(in srgb,var(--accent) 12%,var(--surface));border:1px solid var(--accent-dim);color:var(--accent-text);border-radius:8px;padding:3px 5px 3px 10px;font-size:.85rem;font-weight:700;}
+.condx{background:none;border:none;color:var(--muted);display:inline-flex;padding:2px;}
+.condx .icn{width:.9rem;height:.9rem;}
+
+/* ============================================================
+   ROLLER
+   ============================================================ */
+.rollbar{display:flex;align-items:flex-end;gap:14px;flex-wrap:wrap;}
+.rollbar .field.inline select{min-width:180px;}
+.rollbar .field.inline.dc input{width:90px;}
+.rollhead{font-weight:800;color:var(--accent-text);margin:16px 0 8px;font-size:1.02rem;}
+.rolllist{display:flex;flex-direction:column;gap:6px;margin-bottom:14px;}
+.rollrow{display:flex;align-items:center;gap:12px;padding:9px 12px;border-radius:9px;background:var(--surface-2);border:1px solid var(--line);border-left:4px solid var(--line);}
+.rollrow.csucc,.rollrow.succ{border-left-color:var(--heal);}
+.rollrow.fail{border-left-color:var(--warn);}
+.rollrow.cfail{border-left-color:var(--harm);}
+.rname{flex:1;font-weight:700;}
+.rmath{color:var(--muted);font-size:.85rem;font-variant-numeric:tabular-nums;}
+.nat{font-weight:800;padding:0 4px;border-radius:5px;}
+.nat.nat20{color:var(--heal);background:color-mix(in srgb,var(--heal) 18%,transparent);}
+.nat.nat1{color:var(--harm);background:color-mix(in srgb,var(--harm) 18%,transparent);}
+.natp{font-weight:700;color:var(--ink);}
+.rtotal{font-size:1.25rem;font-weight:800;min-width:34px;text-align:right;}
+.deg{font-size:.72rem;font-weight:800;text-transform:uppercase;letter-spacing:.4px;padding:2px 8px;border-radius:6px;min-width:96px;text-align:center;}
+.deg.csucc{background:color-mix(in srgb,var(--heal) 22%,var(--surface));color:var(--heal);}
+.deg.succ{background:color-mix(in srgb,var(--heal) 12%,var(--surface));color:var(--heal);}
+.deg.fail{background:color-mix(in srgb,var(--warn) 16%,var(--surface));color:var(--warn);}
+.deg.cfail{background:color-mix(in srgb,var(--harm) 18%,var(--surface));color:var(--harm);}
+
+/* ============================================================
+   EXPLORATION BOARD
+   ============================================================ */
+.expboard{display:flex;flex-direction:column;}
+.exphead,.exprow{display:grid;grid-template-columns:88px 1.4fr 1.3fr 100px 2fr;gap:12px;align-items:center;}
+.exphead{font-size:.72rem;text-transform:uppercase;letter-spacing:.5px;color:var(--muted);font-weight:700;padding:0 0 8px;border-bottom:1px solid var(--line);}
+.exprow{padding:10px 0;border-bottom:1px solid var(--line);}
+.expord{display:flex;align-items:center;gap:4px;}
+.ordbtn{background:var(--surface-2);border:1px solid var(--line);color:var(--muted);border-radius:7px;padding:4px;display:inline-flex;}
+.ordbtn .icn{width:1rem;height:1rem;}
+.ordnum{font-weight:800;color:var(--accent-text);min-width:16px;text-align:center;}
+.expsel select{padding:9px;}
+.govmod{font-weight:800;color:var(--accent-text);font-size:1rem;}
+.expnote{font-size:.82rem;color:var(--muted);}
+
+/* ============================================================
+   REFERENCE
+   ============================================================ */
+.searchbar{display:flex;align-items:center;gap:8px;background:var(--surface-2);border:1px solid var(--line);border-radius:10px;padding:0 12px;margin-bottom:14px;}
+.searchbar .icn{color:var(--muted);width:1.1rem;height:1.1rem;}
+.searchbar input{border:none;background:none;padding:11px 0;}
+.searchbar input:focus{border:none;}
+details.ref{border:1px solid var(--line);border-radius:11px;margin:8px 0;background:var(--surface);overflow:hidden;}
+details.ref summary{padding:12px 14px;cursor:pointer;list-style:none;display:flex;align-items:center;justify-content:space-between;gap:10px;}
+details.ref summary::-webkit-details-marker{display:none;}
+.refname{font-weight:700;}
+.refkind{font-size:.68rem;text-transform:uppercase;letter-spacing:.5px;color:var(--muted);background:var(--surface-2);border:1px solid var(--line);border-radius:6px;padding:1px 7px;}
+.refbody{padding:0 14px 14px;font-size:.92rem;line-height:1.55;color:var(--ink);}
+
+/* ============================================================
+   MENU
+   ============================================================ */
+.importbox{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);padding:16px;box-shadow:var(--shadow);}
+.importstatus{font-size:.85rem;margin-top:8px;min-height:1.2em;}
+.importstatus.ok{color:var(--heal);}
+.importstatus.err{color:var(--harm);}
+.charcard{display:flex;align-items:center;gap:12px;background:var(--surface);border:1px solid var(--line);border-radius:11px;padding:12px 14px;margin:8px 0;box-shadow:var(--shadow);}
+.charcard .txt{flex:1;}
+.charcard .nm{font-weight:700;}
+.charcard .tl{font-size:.82rem;color:var(--muted);}
+.rmrow{width:34px;height:34px;flex:0 0 34px;border-radius:9px;background:var(--surface-2);border:1px solid var(--line);color:var(--muted);display:inline-flex;align-items:center;justify-content:center;}
+.rmrow .icn{width:1rem;height:1rem;}
+.seg{display:flex;gap:8px;margin:6px 0 12px;}
+.seg button{flex:1;padding:11px;border-radius:10px;border:1px solid var(--line);background:var(--surface-2);color:var(--ink);font-weight:700;}
+.seg button.on{background:var(--accent);color:var(--accent-ink);border-color:var(--accent);}
+.swatchrow{display:flex;align-items:center;gap:10px;margin:8px 0;}
+.swatchrow label{flex:1;font-weight:600;font-size:.92rem;}
+.swatchrow input[type="color"]{flex:0 0 54px;width:54px;}
+.credit{text-align:center;margin-top:22px;font-size:.78rem;}
+
+/* ---- Toast ---- */
+.toast{
+  position:fixed;bottom:28px;left:50%;transform:translateX(-50%);
+  background:var(--accent);color:var(--accent-ink);font-weight:800;padding:12px 20px;border-radius:30px;
+  z-index:50;opacity:0;transition:opacity .25s;pointer-events:none;box-shadow:0 4px 16px rgba(0,0,0,.35);max-width:90vw;text-align:center;
+}
+.toast.show{opacity:1;}
+
+/* ============================================================
+   RESPONSIVE — collapse the wide table to stacked cards on small screens
+   ============================================================ */
+@media (max-width:820px){
+  .wrap{padding:14px 12px 60px;}
+  .roster thead{display:none;}
+  table.roster,.roster tbody,.roster tr,.roster td{display:block;width:100%;}
+  .roster tr.rrow{border:1px solid var(--line);border-radius:12px;margin:10px 0;padding:6px 4px;background:var(--surface);}
+  .roster td{border:none;text-align:left;padding:4px 12px;}
+  .roster td.num::before,.roster td.c-hp::before{content:attr(data-lbl);font-size:.7rem;text-transform:uppercase;letter-spacing:.5px;color:var(--muted);font-weight:700;margin-right:8px;}
+  .roster td.num{display:inline-block;width:auto;min-width:96px;}
+  .roster td.c-exp{display:none;}
+  .rdetail td{display:block;}
+  .detail{grid-template-columns:1fr;}
+  .exphead{display:none;}
+  .exprow{grid-template-columns:1fr;gap:6px;}
+  .rollbar{flex-direction:column;align-items:stretch;}
+  .rollbar .field.inline select,.rollbar .field.inline.dc input{width:100%;}
+}

package/src/sw.js

@@ -0,0 +1,62 @@
+/* Service worker — offline support for the hosted (GitHub Pages) PWA.
+   Network-first for the app page (fresh when online, cached when offline),
+   cache-first for static assets. Cache version is stamped at build time so a
+   redeploy refreshes clients automatically. */
+const CACHE = "pf2e-party-tracker-__CACHE_VERSION__";
+/* Every cache this app has ever made starts with PREFIX. The sweep below is
+   scoped to it on purpose: the three PF2e tools share an origin when they are
+   served from one host (GitHub Pages does it, and so does the toolbox), and an
+   unscoped sweep would delete the other two apps' offline caches every time
+   this one activated. */
+const PREFIX = "pf2e-party-tracker-";
+const SHELL = ["./", "./index.html", "./manifest.webmanifest", "./icon.svg"];
+
+self.addEventListener("install", (e) => {
+  e.waitUntil(
+    caches.open(CACHE)
+      .then((c) => c.addAll(SHELL).catch(() => {}))
+      .then(() => self.skipWaiting())
+  );
+});
+
+self.addEventListener("activate", (e) => {
+  e.waitUntil(
+    caches.keys()
+      .then((keys) => Promise.all(keys.filter((k) => k.startsWith(PREFIX) && k !== CACHE)
+        .map((k) => caches.delete(k))))
+      .then(() => self.clients.claim())
+  );
+});
+
+self.addEventListener("fetch", (e) => {
+  const req = e.request;
+  if (req.method !== "GET") return;
+
+  // App page: network-first so deploys are picked up, cache fallback when offline.
+  if (req.mode === "navigate") {
+    e.respondWith(
+      fetch(req)
+        .then((res) => {
+          const copy = res.clone();
+          caches.open(CACHE).then((c) => c.put("./index.html", copy));
+          return res;
+        })
+        .catch(() => caches.match("./index.html").then((r) => r || caches.match("./")))
+    );
+    return;
+  }
+
+  // Static assets: cache-first.
+  e.respondWith(
+    caches.match(req).then((r) =>
+      r ||
+      fetch(req).then((res) => {
+        if (res.ok && new URL(req.url).origin === self.location.origin) {
+          const copy = res.clone();
+          caches.open(CACHE).then((c) => c.put(req, copy));
+        }
+        return res;
+      }).catch(() => r)
+    )
+  );
+});

package/src/template.html

@@ -0,0 +1,120 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover">
+<meta name="theme-color" content="#14161b">
+<meta name="apple-mobile-web-app-capable" content="yes">
+<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+<meta name="apple-mobile-web-app-title" content="Party Tracker">
+<meta name="description" content="A GM's Pathfinder 2e party tracker — passive stats, secret checks, and exploration activities.">
+<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%236c7a89' stroke-width='1.6' stroke-linecap='round' stroke-linejoin='round'><path d='M12 2.6 4.5 5.3v6.2c0 4.6 3.1 7.9 7.5 9.9 4.4-2 7.5-5.3 7.5-9.9V5.3z'/><circle cx='12' cy='9.3' r='1.7'/><path d='M8.7 15.4a3.4 3.4 0 0 1 6.6 0'/></svg>">
+<!-- Set the light/dark theme before first paint (avoids a flash); the engine reconciles fully on load. -->
+<script>
+(function(){try{
+  var lib=JSON.parse(localStorage.getItem("pf2ePartyTracker.v1"))||{};
+  var s=lib.settings||{}, mode=s.themeMode||"auto";
+  if(mode!=="light"&&mode!=="dark") mode=(window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches)?"dark":"light";
+  var root=document.documentElement; root.dataset.theme=mode;
+  var c=s.custom;
+  if(c){ if(c.accent)root.style.setProperty("--accent",c.accent); if(c.bg)root.style.setProperty("--bg",c.bg);
+    if(c.ink)root.style.setProperty("--ink",c.ink); if(c.surface)root.style.setProperty("--surface",c.surface); }
+}catch(e){}})();
+</script>
+<link rel="manifest" href="manifest.webmanifest">
+<link rel="apple-touch-icon" href="icon.svg">
+<title>PF2e Party Tracker</title>
+<style>
+/*__INJECT_STYLES__*/
+</style>
+</head>
+<body>
+
+<header class="top">
+  <div class="tophead">
+    <h1><span class="apptitle-ic" id="titleIcon"></span> Party Tracker</h1>
+    <button class="menubtn" onclick="openMenu()" title="Characters &amp; backup" aria-label="Menu"><svg class="icn" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="8" r="3.4"/><path d="M5.5 20a6.5 6.5 0 0 1 13 0"/></svg></button>
+  </div>
+  <div class="sub" id="partySub">Pathfinder 2e (Remaster)</div>
+</header>
+
+<nav class="tabs">
+  <button id="nav-roster" class="on" onclick="go('roster')"><span class="ic"></span>Roster</button>
+  <button id="nav-roll" onclick="go('roll')"><span class="ic"></span>Roll</button>
+  <button id="nav-explore" onclick="go('explore')"><span class="ic"></span>Explore</button>
+  <button id="nav-reference" onclick="go('reference')"><span class="ic"></span>Reference</button>
+</nav>
+
+<main class="wrap">
+  <section id="view-roster"></section>
+  <section id="view-roll" class="hide"></section>
+  <section id="view-explore" class="hide"></section>
+  <section id="view-reference" class="hide"></section>
+
+  <!-- ================= MENU ================= -->
+  <section id="view-menu" class="hide">
+    <h2>Import from Pathbuilder</h2>
+    <p class="meta">In Pathbuilder 2e: <b>Menu → Export → Export JSON</b>. You'll get an id number and a JSON export.</p>
+    <div class="importbox">
+      <label class="field"><span class="name">By export id</span>
+        <div class="row tight">
+          <input type="text" id="importCode" inputmode="numeric" placeholder="e.g. 102154">
+          <button class="btn sm" onclick="importFromCode()">Fetch</button>
+        </div>
+      </label>
+      <label class="field"><span class="name">…or paste JSON <span class="hint">always works, offline</span></span>
+        <textarea id="importJSON" rows="4" placeholder='Paste the exported JSON here, then tap Import'></textarea>
+      </label>
+      <button class="btn" onclick="importFromJSON()">Import from JSON</button>
+      <div class="importstatus" id="importStatus"></div>
+    </div>
+
+    <h2 style="margin-top:26px">Characters</h2>
+    <div id="menuList"></div>
+
+    <h2 style="margin-top:26px">Back up &amp; share</h2>
+    <p class="meta">Everything is stored <b>on this device only</b>. Export the whole party (or a single character from its detail panel) to a code you can save or send to another GM.</p>
+    <div class="row tight">
+      <button class="btn secondary" onclick="exportParty()">Export party</button>
+      <button class="btn secondary" onclick="importBackup()">Import code</button>
+    </div>
+    <textarea id="backupIO" rows="3" placeholder="A code appears here on export — or paste one here, then tap Import."></textarea>
+
+    <h2 style="margin-top:26px">Use offline</h2>
+    <div class="row tight">
+      <button class="btn secondary" onclick="downloadOffline()">Save offline copy</button>
+      <button class="btn secondary" id="installBtn" style="display:none" onclick="installApp()">Install app</button>
+    </div>
+
+    <h2 style="margin-top:26px">Appearance</h2>
+    <div id="appearancePanel"></div>
+
+    <button class="btn secondary" style="margin-top:22px" onclick="closeMenu()">← Back to roster</button>
+    <p class="meta credit">Condition &amp; action text: Paizo (OGL/ORC) via the Foundry VTT pf2e project · unofficial fan tool<br><span id="dataStamp"></span></p>
+  </section>
+</main>
+
+<div class="toast" id="toast"></div>
+
+<script>
+/*__INJECT_REFERENCE__*/
+</script>
+<script>
+/*__INJECT_CONFIG__*/
+</script>
+<script>
+/*__INJECT_ENGINE__*/
+</script>
+<script>
+(function(){
+  // fill in nav + title icons from the registry once config+engine are live
+  try{
+    document.getElementById("titleIcon").innerHTML = iconSvg("shield");
+    [["roster","roster"],["roll","roll"],["explore","explore"],["reference","reference"]].forEach(function(p){
+      var b=document.querySelector("#nav-"+p[0]+" .ic"); if(b) b.innerHTML=iconSvg(p[1]);
+    });
+  }catch(e){}
+})();
+</script>
+</body>
+</html>

package/tools/build.py

@@ -0,0 +1,60 @@
+#!/usr/bin/env python3
+"""
+build.py — assemble the single, self-contained dist/index.html.
+
+Inlines styles + Foundry-derived reference data + static config + engine into
+the template so the result is one file you can open offline (file://) or hand to
+another GM. Run from the project root:
+
+    python3 tools/build.py
+"""
+import os
+import time
+
+ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+def read(rel):
+    with open(os.path.join(ROOT, rel), encoding="utf-8") as fh:
+        return fh.read()
+
+
+def main():
+    html = read("src/template.html")
+    parts = {
+        "/*__INJECT_STYLES__*/": read("src/styles.css"),
+        "/*__INJECT_REFERENCE__*/": read("data/reference.generated.js"),
+        "/*__INJECT_CONFIG__*/": read("src/config.js"),
+        "/*__INJECT_ENGINE__*/": read("src/engine.js"),
+    }
+    for marker, content in parts.items():
+        if marker not in html:
+            raise SystemExit(f"marker not found in template: {marker}")
+        # str.replace (not regex) so JS/CSS content is inserted verbatim
+        html = html.replace(marker, content)
+
+    out_dir = os.path.join(ROOT, "dist")
+    os.makedirs(out_dir, exist_ok=True)
+    out_path = os.path.join(out_dir, "index.html")
+    with open(out_path, "w", encoding="utf-8") as fh:
+        fh.write(html)
+
+    # Static PWA files (for the hosted GitHub Pages version). Harmlessly absent
+    # when index.html is opened as a downloaded standalone file.
+    cache_ver = time.strftime("%Y%m%d%H%M%S")
+    for name in ("icon.svg", "manifest.webmanifest", "sw.js"):
+        src = os.path.join(ROOT, "src", name)
+        if not os.path.exists(src):
+            continue
+        content = read("src/" + name)
+        if name == "sw.js":
+            content = content.replace("__CACHE_VERSION__", cache_ver)
+        with open(os.path.join(out_dir, name), "w", encoding="utf-8") as fh:
+            fh.write(content)
+
+    kb = os.path.getsize(out_path) / 1024
+    print(f"built {out_path} ({kb:.0f} KB) + PWA files (cache {cache_ver})")
+
+
+if __name__ == "__main__":
+    main()