Release v0.3.0

InsightFlare v0.3.0 makes analytics data easier to share, query, and reuse.

This release focuses on completing the public sharing experience. Teams can enable public access links for sites, allowing external members to view core analytics dashboards without signing in. The API also gains more complete query capabilities, making it easier for AI Agents, automation scripts, and external systems to read site data, combine metrics, and generate reports.

Highlights

• Added a public sharing system. Sites can enable a public access slug and generate share links that can be copied and opened without authorization.
• Added public shared dashboard pages where external visitors can browse core analytics views that do not expose specific visitor privacy, including Overview, Pages, Referrers, Campaigns, Retention, Geo, Devices, Browsers, and Performance.
• The public links management page now shows public access status, public URLs, and domains for all sites, with actions to copy links or jump to site settings.
• API v1 now supports more complete site analytics queries, including trends, breakdowns, cross-breakdowns, time comparisons, explore queries, retention cohorts, and Web Vitals performance data.
• Added global /api/v1/batch requests, making it easier for clients and Agents to combine multiple API queries in one call.
• Added README guidance for connecting AI Agents through skills.json, so Agents can connect to InsightFlare and read analytics data.
• Improved caching for public sharing and dashboard queries, making public dashboards faster on repeated visits.
• Improved dashboard navigation, time ranges, map points, and metric loading states for a more stable day-to-day analytics experience.
• The favicon and LOGO now look sharper.

Changes Since v0.2.0

• Upgraded the public links management page from a placeholder to a site list where users can view site domains, public URLs, enabled status, copy links, and jump to site settings.
• Added a dedicated header, time range controls, analytics tabs, and mobile adaptation to public share pages, allowing external visitors to browse core data directly.
• Changed dashboard site route slugs to be domain-based, and refreshed the dashboard sidebar after site creation to reduce cases where a new site exists but navigation has not updated.
• Fixed current analytics tab loss when switching sites from the sidebar, and preserved the current analytics section across all site links.
• Fixed day/week interval availability at range boundaries such as 7d, 90d, and 12m.
• Fixed geo page queries that could fail to return point data, and aggregated geographic points by rounded coordinates to reduce response payload size.
• Added a two-column medium-width layout for overview metric cards and stabilized metric loading heights to reduce page jumping.
• Unified map loading states around the project Spinner component.
• Synced public sharing, API contracts, OpenAPI, and skills discovery documentation to fix pre-release API shape inconsistencies.
• Relaxed CSP connect-src and ESLint allowDefaultProject configuration to reduce local development and tooling false positives.
• Fixed inconsistent loading animations in some components.

Developer Experience

• Added a standalone Cloudflare build script, scripts/cf-build.ts, to unify local, remote, demo, and CI build entry points.
• Added scripts/dev.ts, wrangler.dev.toml, and workers/dev-worker.js, so local development now goes through the Worker by default.
• Consolidated the check workflow into a TypeScript script covering typecheck, lint, format, i18n, tests, OpenAPI, and skills checks.
• Migrated OpenAPI contract checks and ast-grep binding checks to TypeScript scripts, reducing Node/ESM script fragmentation.
• Removed unused dependencies and environment variable configuration to reduce install size and deployment configuration noise.
• Added a Public API Gate with clearer request entry points, preflight handling, and security boundaries for public API access.
• Migrated private dashboard, public sharing, management, archive, API v1, health check, well-known, map tile, and tracking script entry points to the Hono routing layer.
• Added a local Worker development flow. npm run dev now runs through the Worker + Dashboard path, closer to the Cloudflare deployment environment.
• Expanded test coverage for Hono routes, edge adapters, Public API Gate, API v1 branches, routing compatibility layers, and cache behavior.
• Kept legacy API routes as compatibility wrappers, with a route inventory and parity baseline to reduce regression risk during the Hono migration.