EventHive: Post-Event Report Generator

Build a leadership-ready post-event report in minutes. Fill in attendance, budget, NPS, supplier ratings, and lessons learned — then export a polished PDF. Pulls linked data from the Countdown Planner automatically.

Quick Start

Browser Mode (no install)

1. Download the latest release or clone this repo
2. Open tool.html in any modern browser
3. Start using it — data saves automatically (requires EventHive hosting for full cloud sync)

Also Available on EventHive

This tool is available on EventHive — the free platform for event professionals. On EventHive, your data syncs across devices, integrates with your other tools, and includes AI assistance from Erleah.

---

Features

• Structured report builder (Attendance, Budget, NPS, Suppliers, Lessons)
• Auto-imports data from linked Countdown Planner
• Supplier performance ratings
• Lessons learned capture with categorisation
• Export to polished PDF
• JSON backup/restore

---

Customising This Tool

This tool was built using AI-assisted development ("vibe coding"). To customise it for your needs:

1. Fork this repo (click the Fork button above)
2. Clone your fork locally
3. Read the AI Coding Docs — our methodology for building tools like this with AI
4. Open in your AI editor (Claude Code, Cursor, Copilot, etc.)
   • The .clinerules file gives your AI assistant context about this tool
   • For Claude Code: run claude and the rules load automatically
5. Modify, test, deploy — it's just HTML, CSS, and vanilla JS

Tip: The manifest.json file defines the configuration schema. If you add new configurable options, update it so your tool works with the EventHive platform's config editor.

---

Data Storage

Mode	Where	Persistence
Browser	localStorage (fallback)	Until browser data cleared
EventHive	Cloud database (PostgreSQL)	Synced across devices

This tool reads data from Event Countdown Task Generator. Ensure the hub tool has data for best results.

---

Related Tools

• Event Countdown Task Generator — task completion data auto-imported
• Event Ops Task & Supplier Tracker — supplier ratings drawn from ops data
• Event Budget Tracker — final actuals pulled in for financial summary

---

Contributing

PRs welcome! Please read the Contributing Guide first.

---

License

MIT — free to use, modify, and distribute.

Built by Visual Hive as part of the EventHive open-source toolkit.

---

🐳 Self-Hosting

Run this tool on your own infrastructure using Docker Compose. Your data stays on your servers.

Prerequisites

• Docker Desktop (or Docker Engine + Compose V2)
• ~512 MB RAM

Quick Start

# 1. Clone this repo
git clone https://github.com/Visual-Hive/eventhive-tool-post-event-report.git
cd eventhive-tool-post-event-report

# 2. Run the setup script — it handles .env creation, optional password, and Docker build
bash self-hosted/setup.sh

# 3. Open the tool in your browser
open http://localhost:3000

Manual Setup (without the script)

cd self-hosted
cp .env.example .env
# Edit .env to set SESSION_SECRET, optional PASSWORD_HASH, etc.
docker compose up -d --build

Setting a Login Password

By default the tool runs in open-access mode (fine for local use). To add password protection:

cd self-hosted
npm install
npm run hash-password yourpassword   # copy the $2b$... hash
# Paste into .env:  PASSWORD_HASH=<hash>
docker compose restart app

Configuration (.env)

Variable	Default	Description
PORT	3000	HTTP port
SESSION_SECRET	(required)	Random string for signing sessions
PASSWORD_HASH	(empty = open)	bcrypt hash of your access password
TOOL_TITLE	Post-Event Report	Title shown inside the tool
PRIMARY_COLOR	#6366f1	Branding colour (hex)

Data Storage

All data is stored in a PostgreSQL database inside the Docker volume db_data.

Backup:

docker compose -f self-hosted/docker-compose.yml exec db pg_dump -U tool tooldb > backup.sql

Restore:

cat backup.sql | docker compose -f self-hosted/docker-compose.yml exec -T db psql -U tool tooldb

---

This self-hosted backend is API-compatible with EventHive, so you can migrate your data to the hosted version at any time using the tool's built-in export/import feature.