EventHive: HiveMap — Interactive Venue Map

Interactive venue map with admin floor plan editor, stand/POI placement, multi-floor navigation, human-path wayfinding, and public attendee viewer with search and route planning.

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 in your browser's localStorage

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

• Admin floor plan editor — draw walls, rooms, and corridors
• Stand and POI placement with labels
• Multi-floor venue support
• Human-path wayfinding algorithm (fewest turns, widest aisles)
• Public attendee viewer with search
• Route planning with landmark-based directions
• Export floor plan as image or JSON

---

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 (eventhive_event_{eventSlug}_map)	Until browser data cleared
EventHive	Cloud database (PostgreSQL)	Synced across devices

This tool stores all data locally in eventhive_event_{eventSlug}_map. Data persists until browser storage is cleared.

---

Related Tools

• Exhibitor Manager — stand locations overlay on map
• Registration Manager — attendee check-in locations

---

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

# 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	HiveMap — Interactive Venue Map	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.