Kauaʻi Pulse

The live dashboard for what’s happening on Kauaʻi right now.

Kauaʻi Pulse is an open-source island-status service for residents and visitors. It will bring weather, surf, tides, roads, power, and official emergency information into one fresh, location-aware view at TheKauaiPulse.com.

The project is intentionally beginning as one small Go service. Phase 0 establishes a durable foundation without pretending the data integrations already exist.

Phase 0

The current service provides:

• a minimal branded page at /;
• liveness at /healthz and startup/readiness state at /readyz;
• structured JSON logs with Go's log/slog;
• environment-based configuration and graceful shutdown;
• unit and HTTP handler tests;
• reproducible local, container, and CI workflows; and
• product, architecture, roadmap, and data-source decisions in this repository.

Live island data begins in Phase 1. Kauaʻi Pulse is not an official emergency service; source attribution and direct links to official guidance will remain prominent.

Run it

Requires Go 1.25 or newer.

make run
curl http://localhost:8080/healthz
curl http://localhost:8080/readyz

Run all local checks with make check, build a binary with make build, or build the container with make docker-build.

Configuration

Variable	Default	Purpose
HTTP_ADDR	:8080	HTTP listen address
APP_ENV	development	Environment label included in startup logs
LOG_LEVEL	info	debug, info, warn, or error
READ_HEADER_TIMEOUT	5s	Maximum time to read request headers
SHUTDOWN_TIMEOUT	10s	Graceful shutdown deadline

Project guide

• Roadmap
• Architecture
• Data-source strategy
• Contributing

The enduring product idea is simple: aggregation earns attention, but answering “Does this affect me?” creates lasting value.

Released under the MIT License.