Skip to content

Vizoalica v0.5.3 — A clearer console, website pages, and where your visitors are

Deployment support: no D1 schema change. Redeploy the Worker (pnpm vizoalica backend) to get the complete country, page, and source lists; an older Worker keeps working and the console shows its top ten.

Compatibility: no breaking changes to the event, analytics, or static-snippet contracts. The overview response has the same shape with more rows (up to 300 countries and 100 pages, sources, and user agents, previously 10). The website workflow reference in generated installation guidance now points at v0.5.3. The console's #/manage/installation address no longer exists (installing is done from a website's page), so an old bookmark opens Overview.

Vizoalica 0.5.3 reorganizes the console, gives every website its own pages and a rebuilt Install page, and adds a Geography view.

The console now has two areas. Analytics is for reading: Overview, Pages, Sources, Geography, Technology, and Traffic quality, and nothing in it can change or delete anything. Manage is for setup: Projects, Websites, and Health. The project and website you are viewing are chosen once, in a bar under the header, and stay chosen across screens and reloads. Deleting or disabling a project or website happens in a separate danger zone with a confirmation that names what you are about to remove; a project also asks you to type its name. This separation is also the groundwork for role-based access in a later release.

Websites are now a list of cards, a page for each website, and separate add and edit pages. A website's page gathers its origins, identifiers, live status, and the actions Edit, Install, and View analytics, with disable and delete kept apart. Edit and Add have a back link, check entries next to each field, and ask before you leave with unsaved changes. Adding a website ends on its Install page.

The Install page asks how the website is deployed, GitHub → Cloudflare Pages (recommended) or Paste a snippet, and then gives numbered steps, each with one action and at most one code block, naming which settings are public variables and which are secrets. It ends with Check now, which reads the last 24 hours of page views for the website. Installation is no longer its own item in the navigation: you install a website from its page.

Geography shows where visitors are: countries by full name on a world map, a table of every country, and totals by continent. Tor traffic and unknown locations are labelled instead of appearing as T1 or XX. Only country and continent are shown; the audience attributes review records why nothing finer (language, region, city) or anything about people is collected. The map ships inside the console and makes no network requests.

Overview now compares page views and unique users with the previous period of equal length, long lists have a "Show all" control, and distributions use readable bars with a table view instead of pie charts. Manage > Health shows every website's status, reachability, and next step in one place.

Known limits: a comparison against a period that retention has already deleted can read as growth from zero, the map omits very small territories (they remain in the table), and "Check now" reads aggregated data, so new page views can take a short while to appear. See the QA reports for the console and the website pages for the full list.

The release candidate was checked with formatting, lint, type checking, a production build, 758 unit and integration tests, 95.86% line and 91.83% branch coverage, 23 Chromium end-to-end scenarios (including an automated accessibility scan of every screen in light and dark), and a dependency audit with no known vulnerabilities. Screen-reader testing, Firefox and Safari, usability sessions on the Install page, and a run against a real deployment are still to be done by the release owner. It does not contain Cloudflare credentials and does not trigger deployment.

See the changelog, release operations, and using the console.

Released under the MIT License. Visitor data stays in your own Cloudflare account.