apps-h3p and conflict monitor

Public documentation, release communication, and live intelligence presentation.
A single VitePress repository powering the H3P apps hub and the public STATE OF US & WORLD POLITICS monitor.

apps-h3p.com · Conflict Monitor · Predictions · Support · Policies

---

Overview

This repository publishes two related public surfaces from one deployable codebase.

H3P Apps Documentation Hub

The apps hub at apps-h3p.com is the canonical documentation and release-communication layer for current H3P apps.

It provides:

• app overview pages with platform support and status metadata
• installation, feature, FAQ, changelog, and component documentation
• support, legal, privacy, cookie-policy, and trust pages
• app-specific icons, media, screenshots, and release-linked content

STATE OF US & WORLD POLITICS

The monitor surface combines conflict-monitoring presentation and prediction-market reporting.

Primary entry points:

• Conflict Monitor
• Predictions

It provides:

• live conflict metric cards and freshness indicators
• map, timeline, ticker, and source-summary views
• prediction-market reporting pages
• generated public data payloads refreshed by scheduled workflows

---

Screenshots

Apps Hub

Conflict Cards and Live Ticker

Conflict Monitor Overview

Conflict Metrics and Map

---

Quick Start

git clone https://github.com/h3pdesign/appsh3p.git
cd appsh3p
npm install
npm run docs:dev

Open http://127.0.0.1:5173.

Useful commands:

npm run docs:build
npm run docs:preview
node scripts/validate-polymarket-site.mjs
node scripts/update-iran-war-metrics.mjs
node scripts/update-conflict-news.mjs
node scripts/update-market-id-map.mjs
node scripts/update-social-tracker-metrics.mjs

---

Repository Layout

docs/
  apps/                         App documentation pages
  policies/                     Privacy, cookie, terms, and trust pages
  public/
    icons/                      Public app icons
    media/                      Public screenshots and app artwork
    polymarket-us-politics/     Conflict monitor and prediction portal data
scripts/
  update-iran-war-metrics.mjs   Conflict metrics, map, and timeline payloads
  update-conflict-news.mjs      Live ticker and news payloads
  update-market-id-map.mjs      Prediction-market ID mapping
  update-social-tracker-metrics.mjs
  validate-polymarket-site.mjs  Static validation before publish
.github/workflows/              Scheduled data refresh and GitHub Pages deploys

---

Data and Automation

The monitor pages are generated from public payloads stored under:

docs/public/polymarket-us-politics/data/

Scheduled GitHub Actions refresh the public data for:

• conflict metrics, map points, and timeline entries
• conflict news ticker content
• prediction-market mapping and snapshots
• social-attention metrics

Before publishing, validate the generated site payloads:

node scripts/validate-polymarket-site.mjs

---

Deployment

Production is served by GitHub Pages on the custom domain:

• https://apps-h3p.com

Deployment-related files:

• docs/public/CNAME
• VitePress configuration and sitemap hostname
• GitHub Actions workflows for scheduled refreshes and Pages deployment

Production build output:

docs/.vitepress/dist

---

App Documentation Workflow

When adding or updating an app:

1. Create or update docs/apps/<slug>/
2. Add app icons or media under docs/public/icons/ or docs/public/media/
3. Sync release-driven metadata when applicable
4. Build locally
5. Validate generated public data
6. Deploy through the configured GitHub Pages workflow

Typical local preflight:

npm run docs:build
node scripts/validate-polymarket-site.mjs

---

Project Purpose

This repository is the public-facing operations and documentation layer for:

• H3P app management and release communication
• conflict-monitoring presentation
• prediction-market reporting
• support, policy, and trust content

The goal is one maintainable site that serves product documentation, release communication, and continuously refreshed public intelligence pages from the same VitePress codebase.