Changelog — StackStats

v1.7.3 Latest 9 October 2026

More accurate location lookups

Fixed AI chat interpreting the word "in" as Indiana when answering questions about subscribers in countries such as Armenia
Non-US country questions now bypass US-state matching, preventing impossible combined locations in chat responses
Two-letter US-state abbreviations now match only when explicitly capitalized, while full state names remain supported
The US-state filter in Audience Explorer now appears only when United States is selected and clears automatically when switching countries
Added regression coverage for accidental US-state matches in non-US country lookups

v1.7.2 8 October 2026

Audience Explorer & privacy-first AI

Added an Audience Explorer for filtering subscribers by country, US state, and recent activity
Subscriber names and emails remain masked until PII is explicitly revealed, with search, pagination, and filtered CSV export built in
AI chat can now answer country and US-state subscriber questions, including counts, activity, names, and emails
Subscriber lookups run entirely on the device before any AI-provider request, so names, emails, and individual activity records never leave StackStats
External AI providers receive aggregate country totals only, without subscriber identities or email addresses
Added automated privacy regression tests to ensure local subscriber results bypass external AI providers

v1.7.1 4 October 2026

Workspace data consistency fix

Existing workspaces now normalize generated Auto-Sync file paths on load, so old nested snapshots stop affecting analytics
Multiple workspaces pointed at the same newsletter source now resolve to the same current generated exports instead of mixing 18-file and 27-file histories
Workspace file counts are cleaned up during startup, making it easier to spot whether two workspaces are using the same underlying export set
Auto-Sync folder cleanup now rewrites generated CSV and ZIP references back to the stable workspace folder when those files exist there
Fixed a data mismatch where subscriber totals, active reader counts, and never-engaged percentages could differ between workspaces using the same newsletter source
Added regression coverage for nested Auto-Sync file cleanup and canonical workspace sync folders

v1.7.0 27 Sep 2026

Multiple newsletter workspaces

Workspaces added for Lifetime users — manage multiple newsletters on one device, each with separate files, sync settings, and newsletter name
Sidebar workspace switcher added so newsletter context is always visible while moving between Overview, Growth Sources, Subscribers, Publications, Deep Dive, Reach, Actions, and AI Insights
Workspace switching now reloads cleanly from the selected workspace so charts, file lists, and newsletter names do not bleed between newsletters
New workspace creation flow added for setting up additional newsletters without replacing the current newsletter's files
Auto-Sync now keeps each newsletter in its own stable folder, so repeated syncs do not create nested paths like Newsletter/Newsletter/Newsletter
Demo page remains focused on one sample newsletter, without dummy workspace switchers or workspace setup controls
App version bumped in the sidebar so local testers can confirm they are running the newest workspace build

v1.6.6 18 Sep 2026

Safer workspace migration

Existing configs now migrate into the workspace structure without losing loaded CSVs, ZIP exports, AI settings, or license details
Saving settings now preserves workspace metadata from disk, preventing stale renderer state from deleting newly created workspaces
Startup recovery now detects orphaned workspace folders and restores them into the workspace list

v1.6.5 20 Aug 2026

Auto-Sync cleanup for multiple newsletters

Auto-Sync now avoids repeatedly nesting newsletter folders when two workspaces use the same newsletter source
Duplicate generated exports are cleaned up so old snapshots do not inflate subscriber totals or make two matching newsletters appear different
Workspace file lists now prefer the newest synced export for each data type

v1.6.4 16 Jul 2026

Local build workflow

Local build workflow simplified with Make commands — make dev for quick testing, make test for coverage, make build for local packaging, and make release for publishing
Mac local builds now target the current machine architecture by default, keeping test builds faster and less noisy
Release builds still package both Apple Silicon and Intel Mac artifacts for publishing

v1.6.3 12 Jun 2026

Test coverage and CI

Test coverage expanded for workspace switching, config migration safety, duplicate sync-file cleanup, and the licensing Worker API
CI now runs app checks, app tests, and Worker tests so release issues are caught before publishing
Worker API tests now cover activation, verification, registered devices, JSON 404s, and CORS preflight

v1.6.2 8 May 2026

Stat card exports & deliverability improvements

CSV export buttons added to main stat cards (Total Subscribers, Active Last 7 Days, Unengaged, Re-engage Target, Deliverability Risk, Power Users)
Deliverability Risk now shows all subscribers with any dropped emails (previously only 50%+ drop rate)
Deliverability CSV export includes Emails Dropped, Emails Received, and Drop Rate % columns for full context
Stat card subtitle clarified to show "≥1 email dropped" for better understanding
All exports include Name, Email, Type, Join Date, Opens, Clicks, Comments, Shares, Post Views, and Days Active

v1.6.1 8 May 2026

CSV exports for Smart Audience Segments

CSV export buttons added to all Smart Audience Segments (Champions, New & Active, Loyalists, At Risk, Ghosts)
Download any segment with full engagement metrics and subscription details
Exports include Name, Email, Type, Join Date, Opens (6mo/30d/7d), Clicks, Comments, Shares, Post Views

v1.6.0 7 May 2026

Actions tab and local time by country

New Actions tab suggests what to do next, like re-engaging quiet readers, pitching warm free subscribers, or resending missed posts
Actions now feel easier to use with clearer language, built-in CSV exports, and privacy toggles wherever subscriber details appear
Geographic Snapshot now shows a representative local time for each top country so you can quickly see where readers are in their day
Auto-Sync now refreshes the latest post data more reliably when new exports arrive with the same filenames

v1.5.5 6 May 2026

Auto-Sync refresh fix

Fixed Auto-Sync sometimes showing older data after a fresh sync
New posts now appear correctly in Post Performance and other publication views after syncing
The "files loaded" date now updates properly when your latest data is pulled in

v1.5.4 22 Apr 2026

Conversion potential, engagement benchmarks, and optimal send time

Conversion Potential — free subscribers scored 0-100 on likelihood to upgrade based on engagement depth, tenure, and consistency (Subscribers tab)
Top 10% Engagement Benchmark — see how your top performers engage and how much better they open compared to average (Overview tab)
Geographic Engagement Analysis — countries ranked by active 7d/30d engagement with stat cards showing top 3 (Reach tab)
Optimal Send Time — when your subscribers actually open emails based on ZIP timestamps, distinct from when you historically posted (Publications tab)
Better Growth Predictions — upgraded to 180-day forecast using exponential smoothing with trend strength indicator (Overview tab)
Best Hour to Post renamed to "Best Hour to Post (Historical)" to clarify it shows your past posting patterns vs subscriber activity
CSV export for Conversion Potential includes all high+medium potential subscribers, not just top 20
Removed Email Client Stats (unreliable user agent detection) and Post-to-Unsubscribe section (data not available in most exports)

v1.5.3 21 Apr 2026

Completion rates, Restacks tracking, and Evergreen Winners table

See which posts people actually finish reading — new Completion Rate shows what percentage of readers scroll to the end
Track your Substack Notes reshares — Restacks column helps identify which posts go viral
New Evergreen Winners section highlights your best long-term content — posts people keep coming back to weeks after you publish
Click rates now show for all your posts, not just older ones
Post dates now include time stamps so you can see how publishing time affects open rates

v1.5.2 25 Mar 2026

Churn Risk scoring improvements & per-tier CSV export

CSV export buttons on High, Medium, and Low Risk tiles — download the full subscriber list for each bucket
Churn Risk scoring overhauled — new subscribers now get a 60-day grace period (was 30) before being flagged High Risk
Medium risk split now uses lifetime opens instead of a circular 6-month rate — long-time readers who've gone quiet score lower than subscribers who were never engaged
Drop rate penalty no longer applies to recently active subscribers (opened in last 30d)

v1.5.1 21 Mar 2026

CSV export for key subscriber tables

CSV export button on Superfans, Top 15 Most Engaged Readers, and Recoverable At-Risk Subscribers tables
PII reveal button added directly to the Recoverable At-Risk sub-section for quicker access

v1.5.0 21 Mar 2026

Advanced analytics & overview redesign

Overview redesigned — three exclusive insight panels at top (Audience Health segmentation, Growth Momentum with 90-day forecast, Best Time to Post)
Smart Audience Segments (Champions, Loyalists, At-Risk, Ghosts) now lead the Subscribers tab
Publications tab — new Publishing Health snapshot showing open rate trend, all-time best post, and best posting time at a glance
Growth Sources — Content-to-Growth Correlation promoted above sources table (shows subscriber lift before/after each post)
Smart Insights expanded to full-width two-column layout on Overview
Trend lines on Overview growth chart and Growth tab subscriber chart
Stacked area chart in Growth tab showing daily visitors by source (top 6 sources)
Source quality insight in Smart Insights — compares acquisition sources by conversion rate, excludes noise sources
Growth plateau detection in Smart Insights — flags when growth stalls below 3 subs/day
Post-to-Unsubscribe Correlation table in Publications (shows explanation for free-only newsletters)

v1.4.0 18 Mar 2026

Auto-Sync Beta

Auto-Sync Beta — one-click download of all Substack data (subscriber export + ZIP export) directly from Settings
Settings redesign — Auto-Sync at top, Manual Upload and Your Data as separate sections
map[Bug fixes:Reach tab charts, at-risk subscriber filter, monthly traffic KPIs]
Median Days Since Open now color-coded green/yellow/red for quick health assessment

v1.3.14 18 Mar 2026

Onboarding & instructions update

Onboarding modal updated with correct Substack export paths matching the instructions page
ZIP export promoted to "Most valuable" in onboarding — it was previously buried under Deep analytics
Removed stale "Email / Publication Stats" export entry that no longer exists in Substack
Fixed Audience Location to show 3 downloads (countries, US states, followers) instead of 2
Added "Full instructions" link in onboarding modal (top and footer) opening stackstats.app/instructions
Fixed Overview chart tooltip — correctly says daily, not weekly

v1.3.13 18 Mar 2026

Smart audience segments, churn risk & post engagement scores

Smart Audience Segments — five named groups (Champions, New & Active, Loyalists, At Risk, Ghosts) computed from tenure, engagement, and subscriber type
Churn Risk Radar — each subscriber scored 0–100 based on engagement recency and decay; shows High/Medium/Low distribution and a recoverable at-risk table
Post Engagement Score — composite 0–100 score per post combining open rate, likes, comments, shares, and signups; shown as Eng column in post table
Hidden Gems — new section in Publications surfacing posts with strong engagement scores but below-average open rates
Info icons (ⓘ) added to all new data points, segment labels, and table column headers with plain-English explanations

v1.3.12 17 Mar 2026

Folder support for Substack export

ZIP export folder support — if macOS auto-extracts the Substack ZIP, the app now detects and imports the folder directly
Auto-scan and manual browse both work with extracted folders, not just .zip files

v1.3.11 16 Mar 2026

UI polish & manage license

Manage License link in Settings — opens stackstats.app/manage-license to view and deactivate devices
Help button in Settings to re-open onboarding anytime
Settings button moved to topbar with label for easier access
AI badge now only visible on AI Insights tab
Sidebar footer simplified — files loaded + as-of date only

v1.3.10 16 Mar 2026

OTA Bug Fixes on Mac version

OTA test release

v1.3.9 16 Mar 2026

OTA Bug Fixes

Fixed OTA install on Mac — disabled Electron asar fs patching (process.noAsar) + shell rm -rf for belt-and-suspenders reliability

v1.3.8 15 Mar 2026

OTA Bug Fixes

Fixed OTA install crash on Mac — used shell rm -rf instead of Node fs.rmSync to avoid Electron's asar fs patching issue

v1.3.7 15 Mar 2026

Onboarding screen

Added onboarding screen on first launch — shows where to download each file type from Substack
Added "?" help button in Settings → Your Data to re-open onboarding anytime

v1.3.6 15 Mar 2026

OTA fix + UI polish

Fixed OTA update download — now uses GitHub API to find the correct zip asset, no YAML parsing
Sidebar nav icon and text spacing tightened
Mini stats bar now shows "as of [date]" so you can see when data was last loaded

v1.3.5 15 Mar 2026

UI polish + data freshness

Sidebar nav icon and text spacing tightened
Mini stats bar now shows "as of [date]" so you can see when data was last loaded

v1.3.4 14 Mar 2026

Mac auto-update without Developer cert

Fixed Mac auto-update — bypasses Squirrel.Mac/ShipIt entirely, no Apple Developer cert required
Update now extracts and replaces the app bundle directly, then relaunches cleanly
Fixed update errors being silently swallowed; now shown with a Retry button
Fixed "Check for updates" button in Settings showing the progress modal correctly

v1.3.3 14 Mar 2026

Auto-update fixes

Fixed auto-update stuck at 0% — download errors were silently swallowed; now shown with a Retry button
Fixed Mac auto-update — zip artifact now included in builds so electron-updater can apply in-place updates
Fixed "Check for updates" button in Settings — now shows the download progress modal correctly

v1.3.2 14 Mar 2026

Update button fix in Settings (incomplete)

Partial fix — update modal was not visible because it is nested inside the splash overlay

v1.3.1 14 Mar 2026

OTA update progress bar

Download progress bar shown when installing an update — fixes stuck "Downloading..." state
App restarts automatically once download completes

v1.3.0 13 Mar 2026

Subscriber geography & rising readers

Subscribers by State/Province chart — top regions from the richer subscriber export, shown alongside acquisition sources
Rising Readers table — subscribers with comments or shares in the last 7 days, ranked by recent activity score
Momentum ratio — compares a reader's daily engagement rate this week vs their 30-day baseline (e.g. 2.4× means they are twice as active as usual)
Release info in Settings — shows current version, latest release date fetched live from GitHub, and a Check for updates button
Fixed update check hanging on splash screen in dev builds

v1.2.0 12 Mar 2026

Light/dark theme & version management

Substack-style light theme — warm cream palette matching the Substack aesthetic, with the orange accent
Dark mode — original dark theme preserved; toggle with the ☀/☾ button in the sidebar
Theme preference saved — persists across restarts
Version number shown in sidebar footer
About card in Settings — current version, latest release date, one-click update check

v1.1.0 11 Mar 2026

Renamed to StackStats

App renamed from Stacklytics to StackStats throughout
Fixed splash screen hanging when update check is skipped in dev

v1.0.0 11 Mar 2026

Initial release

7 analytics tabs — Overview, Growth Sources, Subscribers, Publications, Deep Dive, Reach, AI Insights
9 CSV file types supported — growth, subscribers, email stats, traffic, followers, audience location, email count, traffic sources, ZIP export
ZIP export analytics — per-post opens, clicks, device breakdown, top countries; bot filtering removes GoogleImageProxy inflated open counts
Richer subscriber export — 43-column subscriber-export CSV parsed transparently with engagement, activity, and conversion fields
Overview — KPI cards, daily growth chart with period filter, traffic donut, smart insights, 90-day growth forecast
Growth Sources — ranked source table with conversion %, content-to-growth correlation, source quality by engagement
Subscribers — engagement segments, subscriber countries, acquisition sources, paid conversion time, churn analysis
Publications — timing charts (best day/hour), resend candidates, post performance table with bot-filtered open rates
Deep Dive — engagement funnel, cohort retention, open rate decay, superfans widget, top 15 readers table
Reach — page views, followers vs email subs stacked area, top countries by signups and email opens
AI Insights — 4 insight cards (Growth, Engagement, Audience, 30-Day Plan) plus live chat with 7 provider support
AI providers — Anthropic, OpenAI, Gemini, OpenRouter, Groq, Ollama, custom OpenAI-compatible endpoints
Licensing — Gumroad + Cloudflare Worker backend; 1-year and lifetime tiers; per-device activation
OTA updates — auto-detects new releases via GitHub Releases, prompts on launch
All data stays local — AI providers receive only aggregated summaries, never raw email addresses or subscriber data