EventHive: Event Countdown Task Generator

Generate a complete reverse-timeline task plan from T-16 weeks to post-event. Edit tasks in a slide-out panel, export as reusable templates, and push tasks directly to the Ops Tracker.

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.

AI features in this tool are optional. They require an API key (OpenAI, Anthropic, or compatible). All core functionality works without AI.

---

Features

• Pre-built T-16 week countdown task library (200+ tasks)
• Category filters: Venue, AV, Catering, Speakers, Sponsors, etc.
• Slide-out panel for editing task details and next actions
• Export plan as reusable JSON template
• Import saved templates
• Push tasks to Ops Tracker with one click
• AI assistance via Erleah — ask her to adjust tasks by name

---

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 Ops Task & Supplier Tracker. Ensure the hub tool has data for best results.

---

Related Tools

• Event Ops Task & Supplier Tracker — pushes generated tasks into Ops Tracker
• Team Workload Heatmap — task assignments feed workload view
• Post-Event Report Generator — completion data pulled into report
• Run Sheet / Show Flow — high-level tasks seed the run sheet

---

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-countdown-planner.git
cd eventhive-tool-countdown-planner

# 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	Event Countdown Planner	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.