diff --git a/assets/live-stats.js b/assets/live-stats.js
new file mode 100644
index 00000000..573688e5
--- /dev/null
+++ b/assets/live-stats.js
@@ -0,0 +1,71 @@
+/*
+ * Latest view counts for the catalog and the resource pages.
+ *
+ * The daily traffic workflow keeps a fresh resource-stats.json on the automation/traffic-stats-staging
+ * branch. Publishing it to master needs a pull request that GitHub Actions cannot open here, so the
+ * copy on the site is only as fresh as the last merged weekly PR. This script reads the staging copy
+ * straight from raw.githubusercontent.com, which serves it to any site and caches it for five minutes.
+ *
+ * Only the view counts are taken from it. The local file stays the source for everything else
+ * (upvotes, discussion links), and it is the fallback when the staging copy cannot be read, is
+ * older than the local file, or was rendered by a different counting method (sources.views).
+ * Exposes window.FastTrackLiveStats = { url, fetch, pick }. It never throws and never blocks a page.
+ */
+(function () {
+ 'use strict';
+
+ var LIVE_STATS_URL = 'https://raw.githubusercontent.com/microsoft/FastTrack/automation/traffic-stats-staging/resource-stats.json';
+ var TIMEOUT_MS = 5000;
+
+ // Resolves with the parsed staging file, or null on any failure or timeout.
+ function fetchLive() {
+ return new Promise(function (resolve) {
+ try {
+ if (!window.fetch) { resolve(null); return; }
+ var controller = window.AbortController ? new AbortController() : null;
+ var timer = setTimeout(function () {
+ if (controller) controller.abort();
+ resolve(null);
+ }, TIMEOUT_MS);
+ var options = { credentials: 'omit', referrerPolicy: 'no-referrer' };
+ if (controller) options.signal = controller.signal;
+ window.fetch(LIVE_STATS_URL, options)
+ .then(function (response) {
+ if (!response.ok) throw new Error('HTTP ' + response.status);
+ return response.json();
+ })
+ .then(function (doc) { clearTimeout(timer); resolve(doc); })
+ .catch(function () { clearTimeout(timer); resolve(null); });
+ } catch (error) {
+ resolve(null);
+ }
+ });
+ }
+
+ // Returns { slug: views } when the staging copy can replace the local view counts, else null.
+ function pick(local, live) {
+ try {
+ if (!local || !live || !live.resources || typeof live.resources !== 'object') return null;
+ if (!local.sources || !live.sources || !local.sources.views || local.sources.views !== live.sources.views) return null;
+ var localTime = Date.parse(local.generatedAt);
+ var liveTime = Date.parse(live.generatedAt);
+ if (!(liveTime >= localTime)) return null;
+
+ var views = {};
+ var found = false;
+ Object.keys(live.resources).forEach(function (slug) {
+ var entry = live.resources[slug];
+ var count = entry ? Number(entry.views) : NaN;
+ if (isFinite(count) && count >= 0) {
+ views[slug] = Math.round(count);
+ found = true;
+ }
+ });
+ return found ? views : null;
+ } catch (error) {
+ return null;
+ }
+ }
+
+ window.FastTrackLiveStats = { url: LIVE_STATS_URL, fetch: fetchLive, pick: pick };
+})();
diff --git a/assets/privacy-notice.js b/assets/privacy-notice.js
index 163299e6..25267fa1 100644
--- a/assets/privacy-notice.js
+++ b/assets/privacy-notice.js
@@ -95,6 +95,7 @@
'',
'- Google Fonts. The catalog and resource pages load fonts from fonts.googleapis.com and fonts.gstatic.com.
',
'- giscus and GitHub. A resource’s detail view in the catalog loads comments and reactions from giscus.app, which uses GitHub Discussions in the microsoft/FastTrack repository. You sign in with GitHub to react or comment.
',
+ '- Latest view counts. The catalog and resource pages read a public statistics file from the microsoft/FastTrack repository on raw.githubusercontent.com. The request carries no cookies and sends no referrer.
',
'- Links to other sites, such as Microsoft Learn and GitHub, follow those sites’ own privacy statements.
',
'
',
'',
diff --git a/assets/resource-page.js b/assets/resource-page.js
index 0f51c0ea..fd3554d5 100644
--- a/assets/resource-page.js
+++ b/assets/resource-page.js
@@ -53,17 +53,25 @@
}
// Views come from the published stats, so the page needs no rebuild when the counts change. The row
- // stays hidden if the file cannot be read. Keep VIEWS_TIP in step with the catalog (index.html).
+ // stays hidden if the file cannot be read. The latest counts are taken from the staged stats when
+ // they can be read in time (assets/live-stats.js). Keep VIEWS_TIP in step with the catalog (index.html).
var VIEWS_TIP = "Catalog page views recorded by Microsoft Clarity since Jul 2026, plus views of the resource's GitHub folder from saved snapshots (Apr\u2013Jun and 14\u201327 Oct 2026). Some days were never captured, so this is a minimum.";
+ var LIVE_STATS_WAIT_MS = 1500;
var viewsRow = document.getElementById('viewsRow');
var viewsValue = document.getElementById('viewsValue');
if (viewsRow && viewsValue && slug && script && script.src && window.fetch) {
- fetch(new URL('../resource-stats.json', script.src).href, { cache: 'no-cache' })
- .then(function (response) { if (!response.ok) throw new Error('HTTP ' + response.status); return response.json(); })
- .then(function (data) {
+ var liveStats = window.FastTrackLiveStats ? window.FastTrackLiveStats.fetch() : Promise.resolve(null);
+ var liveOrTimeout = Promise.race([liveStats, new Promise(function (resolve) { setTimeout(function () { resolve(null); }, LIVE_STATS_WAIT_MS); })]);
+ var localStats = fetch(new URL('../resource-stats.json', script.src).href, { cache: 'no-cache' })
+ .then(function (response) { if (!response.ok) throw new Error('HTTP ' + response.status); return response.json(); });
+ Promise.all([localStats, liveOrTimeout])
+ .then(function (results) {
+ var data = results[0];
if (!data || !data.resources || typeof data.resources !== 'object') return;
var entry = data.resources[slug];
var views = entry ? Number(entry.views) : 0;
+ var fresh = window.FastTrackLiveStats ? window.FastTrackLiveStats.pick(data, results[1]) : null;
+ if (fresh && Object.prototype.hasOwnProperty.call(fresh, slug)) views = fresh[slug];
if (!isFinite(views) || views < 0) views = 0;
var short = views >= 10000 ? (views / 1000).toFixed(0) + 'k' : views >= 1000 ? (views / 1000).toFixed(1) + 'k' : String(views);
viewsValue.textContent = short;
diff --git a/index.html b/index.html
index 64c5ddae..6ed1756e 100644
--- a/index.html
+++ b/index.html
@@ -1641,6 +1641,7 @@ Related resources
+
+