diff --git a/.github/workflows/deploy.yml b/.github/workflows/deploy.yml
index 324d75f..32dbc44 100644
--- a/.github/workflows/deploy.yml
+++ b/.github/workflows/deploy.yml
@@ -23,6 +23,18 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Regenerate milestones-data.js from YAML
+        run: npm run build:milestones
+
       - name: Deploy to GitHub Pages (gh-pages branch)
         uses: peaceiris/actions-gh-pages@v4
         with:
@@ -31,4 +43,4 @@ jobs:
           # Preserve any existing PR preview directories across production deploys
           keep_files: true
           # Exclude non-site files from the deployment
-          exclude_assets: '.github,node_modules,tests,package-lock.json,package.json'
+          exclude_assets: '.github,node_modules,tests,scripts,package-lock.json,package.json,milestones.yaml'
diff --git a/.github/workflows/preview.yml b/.github/workflows/preview.yml
index 3865283..ed8c8a8 100644
--- a/.github/workflows/preview.yml
+++ b/.github/workflows/preview.yml
@@ -15,6 +15,18 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Regenerate milestones-data.js from YAML
+        run: npm run build:milestones
+
       - name: Deploy PR preview to gh-pages branch
         uses: peaceiris/actions-gh-pages@v4
         with:
@@ -24,7 +36,7 @@ jobs:
           # Preserve existing previews and production files
           keep_files: true
           # Exclude non-site files
-          exclude_assets: '.github,node_modules,tests,package-lock.json,package.json'
+          exclude_assets: '.github,node_modules,tests,scripts,package-lock.json,package.json,milestones.yaml'
 
       - name: Post or update preview URL comment
         uses: actions/github-script@v7
diff --git a/death-clock-core.js b/death-clock-core.js
index 074f72f..9ae989d 100644
--- a/death-clock-core.js
+++ b/death-clock-core.js
@@ -56,357 +56,87 @@ const HISTORICAL_DATA = [
   { date: '2026-04-14', tokensT: 65000 },
 ];
 
-// Environmental milestone definitions
-// Token thresholds represent cumulative global AI inference since 2020.
-// Environmental correlations are symbolic/illustrative based on:
-// - Energy: 1,000 tokens ≈ 0.0003 kWh inference energy (Google/DeepMind estimates)
-// - CO₂: 0.4 kg CO₂ per kWh (global average grid intensity)
-// - Water: 0.5 L per 1,000 tokens (Microsoft data-center cooling research)
-const MILESTONES = [
-  {
-    id: 'first_forest',
-    name: 'First Forest Felled',
-    icon: '🌲',
-    tokens: 1_000_000_000_000, // 1 trillion
-    shortDesc: '1 Trillion Tokens',
-    description: 'CO₂ equivalent of 50,000 mature trees cut down',
-    consequence:
-      'A single trillion tokens generates CO₂ equal to the annual absorption of 50,000 mature trees. ' +
-      'The Amazon loses 4.3 million acres per year — AI energy demands accelerate this.',
-    followingEvent:
-      '🔥 Regional droughts intensify. Species lose habitat. The carbon feedback loop begins.',
-    color: '#2D9B27',
-    darkColor: '#1a6b15',
-  },
-  {
-    id: 'power_grid_strain',
-    name: 'Power Grid Strain',
-    icon: '⚡',
-    tokens: 2_000_000_000_000, // 2 trillion
-    shortDesc: '2 Trillion Tokens',
-    description: 'AI data centres claim 1 % of global electricity — equal to all of Argentina',
-    consequence:
-      'When data centres alone consume 1 % of the world\'s electricity, every brown-out and ' +
-      'rolling blackout hits hospitals, water-treatment plants, and cold-storage food supplies first. ' +
-      'Grid operators begin rationing power to residential users.',
-    followingEvent:
-      '💡 Planned blackouts become routine. Industrial production slows. Energy poverty spikes.',
-    color: '#FFAA00',
-    darkColor: '#cc7700',
-  },
-  {
-    id: 'arctic_ice',
-    name: 'First Ice-Free Arctic Summer',
-    icon: '🧊',
-    tokens: 5_000_000_000_000, // 5 trillion
-    shortDesc: '5 Trillion Tokens',
-    description: 'The Arctic Ocean is ice-free for the first time in recorded history',
-    consequence:
-      'Sea ice reflects 80 % of incoming sunlight back into space. Without it, the dark Arctic ' +
-      'Ocean absorbs that heat, accelerating warming by 2–3 × above the global average. ' +
-      'Polar vortex destabilisation sends extreme weather to temperate regions.',
-    followingEvent:
-      '❄️ Polar vortex collapses. Record cold snaps devastate agriculture at lower latitudes.',
-    color: '#B0E0FF',
-    darkColor: '#5aabdd',
-  },
-  {
-    id: 'bee_colony',
-    name: 'Bee Colony Collapse',
-    icon: '🐝',
-    tokens: 10_000_000_000_000, // 10 trillion
-    shortDesc: '10 Trillion Tokens',
-    description: '1 billion bees lost to energy-driven habitat destruction',
-    consequence:
-      'Bees pollinate 35 % of human food crops. AI\'s growing energy demands accelerate pesticide use ' +
-      'and destroy wildflower habitats that bee colonies depend on.',
-    followingEvent:
-      '🌾 1-in-3 food items vanish from shelves. Crop yields drop 35 %. Food prices triple globally.',
-    color: '#FFD700',
-    darkColor: '#b39800',
-  },
-  {
-    id: 'wildfire_crisis',
-    name: 'Permanent Wildfire Season',
-    icon: '🔥',
-    tokens: 20_000_000_000_000, // 20 trillion
-    shortDesc: '20 Trillion Tokens',
-    description: 'Wildfire season becomes year-round across three continents',
-    consequence:
-      'Warmer, drier conditions sustained by AI\'s CO₂ load eliminate the concept of a fire season. ' +
-      'Forests in Australia, the American West, and Southern Europe burn continuously. ' +
-      'Smoke blankets cities for months, pushing respiratory illness to epidemic levels.',
-    followingEvent:
-      '🌫️ Air-quality emergencies declared in 40+ cities. Outdoor workers face daily health orders.',
-    color: '#FF5500',
-    darkColor: '#cc3300',
-  },
-  {
-    id: 'silent_species',
-    name: 'Silent Spring: 100 Species Gone',
-    icon: '🐦',
-    tokens: 50_000_000_000_000, // 50 trillion
-    shortDesc: '50 Trillion Tokens',
-    description: '100 vertebrate species driven to extinction by AI-linked habitat destruction',
-    consequence:
-      'Habitat loss and climate change driven by AI energy demands erase entire branches of the ' +
-      'tree of life. Each lost species unravels the web of interdependence — pest explosions, ' +
-      'crop failures, and disease outbreaks follow as predator-prey balances collapse.',
-    followingEvent:
-      '🌿 Ecosystems destabilise. Invasive species surge. Crop pests breed unchecked.',
-    color: '#66BB6A',
-    darkColor: '#3d7a40',
-  },
-  {
-    id: 'great_lakes',
-    name: 'Great Lakes Drained',
-    icon: '💧',
-    tokens: 100_000_000_000_000, // 100 trillion
-    shortDesc: '100 Trillion Tokens',
-    description: 'Data-centre cooling drains freshwater equal to Lake Erie',
-    consequence:
-      'AI data centres consume billions of litres of water annually for cooling. ' +
-      'This draws down aquifers and surface supplies that took millennia to accumulate.',
-    followingEvent:
-      '🚰 2 billion people face water scarcity. Water wars erupt between nations. Agriculture fails.',
-    color: '#0077BE',
-    darkColor: '#005490',
-  },
-  {
-    id: 'water_table_collapse',
-    name: 'Global Water Table Collapse',
-    icon: '🌵',
-    tokens: 200_000_000_000_000, // 200 trillion
-    shortDesc: '200 Trillion Tokens',
-    description: 'Major aquifers — Ogallala, Indo-Gangetic, North China Plain — drop below recovery',
-    consequence:
-      'Underground aquifers that supply half of all irrigation water worldwide have been drawn ' +
-      'down past their natural recharge rates. AI data-centre demand pushes many past the point ' +
-      'of no return. Regions that once fed nations face permanent desertification.',
-    followingEvent:
-      '🏜️ Breadbasket nations become dust bowls. 1 billion people face famine. Food nationalism spikes.',
-    color: '#C8A96E',
-    darkColor: '#8a6e3e',
-  },
-  {
-    id: 'amazon_tipping',
-    name: 'Amazon Tipping Point',
-    icon: '🌳',
-    tokens: 300_000_000_000_000, // 300 trillion
-    shortDesc: '300 Trillion Tokens',
-    description: 'The Amazon rainforest begins converting to savannah — irreversibly',
-    consequence:
-      'Scientists have long warned that 20–25 % deforestation would tip the Amazon into a self-drying ' +
-      'feedback loop. AI\'s cumulative carbon contribution delivers the final increment of warming. ' +
-      'The world\'s largest carbon sink becomes a carbon source.',
-    followingEvent:
-      '🌪️ Global rainfall patterns shift. Monsoons fail. 3 billion people face drought.',
-    color: '#1B5E20',
-    darkColor: '#0d3b12',
-  },
-  {
-    id: 'coral_reef',
-    name: 'Great Barrier Reef Lost',
-    icon: '🪸',
-    tokens: 500_000_000_000_000, // 500 trillion
-    shortDesc: '500 Trillion Tokens',
-    description: 'CO₂ triggers mass bleaching — the Great Barrier Reef is gone',
-    consequence:
-      'Coral reefs support 25 % of all marine species. Ocean acidification from CO₂ emissions ' +
-      'destroys these ecosystems, removing the foundation of oceanic food chains.',
-    followingEvent:
-      '🐠 500 million people lose their primary food source. Fisheries collapse. Ocean deserts expand.',
-    color: '#FF6B6B',
-    darkColor: '#cc3333',
-  },
-  {
-    id: 'permafrost_bomb',
-    name: 'Permafrost Methane Bomb',
-    icon: '💨',
-    tokens: 750_000_000_000_000, // 750 trillion
-    shortDesc: '750 Trillion Tokens',
-    description: 'Siberian and Alaskan permafrost releases stored methane at runaway rates',
-    consequence:
-      'Permafrost locks away an estimated 1.5 trillion tonnes of carbon — twice the amount ' +
-      'currently in the atmosphere. Thawing driven by AI energy emissions triggers methane release ' +
-      'that is 84× more potent than CO₂ over 20 years, creating a self-reinforcing feedback loop.',
-    followingEvent:
-      '🌡️ Global temperature rises accelerate beyond all IPCC models. Climate targets become fiction.',
-    color: '#9E9E9E',
-    darkColor: '#616161',
-  },
-  {
-    id: 'glacier',
-    name: 'Glacier Collapse',
-    icon: '🏔️',
-    tokens: 1_000_000_000_000_000, // 1 quadrillion
-    shortDesc: '1 Quadrillion Tokens',
-    description: 'Warming equivalent destabilises the West Antarctic Ice Sheet',
-    consequence:
-      "Glaciers are the world's largest freshwater reservoirs. Their loss permanently eliminates " +
-      'drinking water for billions and raises sea levels catastrophically.',
-    followingEvent:
-      '🌊 Coastal cities begin flooding. 600 million people displaced. Sea level rises 3 metres.',
-    color: '#A8D8EA',
-    darkColor: '#6ba8c4',
-  },
-  {
-    id: 'ocean_acidification',
-    name: 'Ocean Acidification Threshold',
-    icon: '🐟',
-    tokens: 2_000_000_000_000_000, // 2 quadrillion
-    shortDesc: '2 Quadrillion Tokens',
-    description: 'Ocean pH drops to 7.95 — shellfish and coral larvae can no longer form shells',
-    consequence:
-      'The ocean has absorbed 30 % of all human CO₂ emissions. As pH drops, the carbonate ions ' +
-      'that marine organisms use to build shells and skeletons dissolve. Oysters, mussels, krill, ' +
-      'and pteropods — the base of polar food webs — begin failing to reproduce.',
-    followingEvent:
-      '🦐 Krill populations crash. Whales, penguins, and polar bears follow into starvation.',
-    color: '#0D47A1',
-    darkColor: '#082e6a',
-  },
-  {
-    id: 'sahel_collapse',
-    name: 'Sahel Collapse',
-    icon: '☀️',
-    tokens: 5_000_000_000_000_000, // 5 quadrillion
-    shortDesc: '5 Quadrillion Tokens',
-    description: 'The Sahel belt becomes uninhabitable — 300 million climate refugees displaced',
-    consequence:
-      'The Sahel region, already at the edge of habitability, tips past the point where subsistence ' +
-      'farming is possible. A belt of uninhabitable land stretches across Africa from Senegal to Somalia. ' +
-      'Tens of millions of climate refugees overwhelm neighbouring regions.',
-    followingEvent:
-      '🌍 Regional governments collapse. Conflict over water and arable land escalates to warfare.',
-    color: '#E65100',
-    darkColor: '#b33d00',
-  },
-  {
-    id: 'ocean_dead_zone',
-    name: 'Ocean Dead Zone',
-    icon: '🌊',
-    tokens: 10_000_000_000_000_000, // 10 quadrillion
-    shortDesc: '10 Quadrillion Tokens',
-    description: 'Ocean acidification creates a dead zone larger than the Pacific garbage patch',
-    consequence:
-      'CO₂ absorbed by oceans shifts their pH — catastrophic for marine life. ' +
-      'Phytoplankton, which produces 50 % of Earth\'s oxygen, begins dying off.',
-    followingEvent:
-      '😮‍💨 Atmospheric oxygen concentration drops. Human cognitive function declines. Extinction accelerates.',
-    color: '#1A237E',
-    darkColor: '#0d1466',
-  },
+// ── Milestone data ────────────────────────────────────────────────────────────
+// MILESTONES are defined in milestones.yaml (human-readable source of truth).
+// The build step (`npm run build:milestones`) generates milestones-data.js.
+//
+// In the browser : milestones-data.js is loaded via <script> before this file,
+//                  which sets window.MilestonesData.
+// In Node.js/Jest: milestones-data.js is loaded via require().
+/* istanbul ignore next */
+const MILESTONES = (
+  typeof window !== 'undefined' && window.MilestonesData
+    ? window.MilestonesData.MILESTONES
+    : typeof require === 'function'
+      ? require('./milestones-data').MILESTONES
+      : []
+);
+
+// ── Token-saving tips ─────────────────────────────────────────────────────────
+// Each tip includes an estimate of token savings when applied consistently.
+// savingPct: percentage of tokens saved (0-100) relative to typical usage.
+// Sources: OpenAI prompt engineering guide, Anthropic documentation,
+// academic work on LLM efficiency.
+const TOKEN_TIPS = [
   {
-    id: 'jet_stream_collapse',
-    name: 'Jet Stream Destabilised',
-    icon: '🌪️',
-    tokens: 30_000_000_000_000_000, // 30 quadrillion
-    shortDesc: '30 Quadrillion Tokens',
-    description: 'Arctic amplification breaks the polar jet stream into chaotic loops',
-    consequence:
-      'The jet stream normally separates cold Arctic air from warm temperate air. As the Arctic ' +
-      'warms 4× faster than the rest of the planet, the temperature gradient that drives the jet ' +
-      'stream weakens. It buckles into extreme meanders, locking weather patterns in place for weeks.',
-    followingEvent:
-      '❄️🌡️ Europe freezes in July. Texas floods. Monsoons arrive months late. Harvests fail continent-wide.',
-    color: '#7E57C2',
-    darkColor: '#4a2d8a',
+    id: 'focused_prompts',
+    icon: '✏️',
+    title: 'Write Focused Prompts',
+    tip: 'Be specific and remove filler words. A 30 % shorter prompt usually gets the same quality response with far fewer input tokens.',
+    savingPct: 30,
+    detail: 'Studies show that redundant preambles, excessive politeness markers, and repeated context each add tokens without improving output quality. Aim to cut prompt length by a third without losing essential context.',
+    reference: 'https://platform.openai.com/docs/guides/prompt-engineering',
   },
   {
-    id: 'food_system_stress',
-    name: 'Global Food System Under Siege',
-    icon: '🌾',
-    tokens: 50_000_000_000_000_000, // 50 quadrillion
-    shortDesc: '50 Quadrillion Tokens',
-    description: 'Simultaneous crop failures on three continents push 1 billion into food insecurity',
-    consequence:
-      'Extreme heat waves, erratic monsoons, and drought driven by AI\'s cumulative emissions hit ' +
-      'major grain-producing regions simultaneously. Global food reserves drop below 60 days. ' +
-      'Price spikes trigger social unrest across 40+ countries.',
-    followingEvent:
-      '🍞 Food nationalism spreads. Export bans fracture global trade. Humanitarian crisis escalates.',
-    color: '#8D6E63',
-    darkColor: '#5d4037',
+    id: 'right_model_size',
+    icon: '🎯',
+    title: 'Match Model to Task',
+    tip: 'Don\'t use a frontier model (GPT-4, Claude 3.5 Opus) for simple tasks. Smaller models can be 10–100× cheaper on summarisation, classification, and simple Q&A.',
+    savingPct: 80,
+    detail: 'Frontier models are optimised for complex reasoning. For routine tasks — extracting data, reformatting, answering FAQs — a small model (7B parameters or fewer) achieves comparable accuracy at a fraction of the energy cost.',
+    reference: 'https://www.anthropic.com/pricing',
   },
   {
-    id: 'mass_extinction',
-    name: 'Sixth Mass Extinction',
-    icon: '💀',
-    tokens: 100_000_000_000_000_000, // 100 quadrillion
-    shortDesc: '100 Quadrillion Tokens',
-    description: 'AI energy demands push 10,000+ species to irreversible extinction',
-    consequence:
-      "We are already in the sixth mass extinction. AI's insatiable energy hunger " +
-      'accelerates species loss beyond any recovery. Biodiversity collapses irreversibly.',
-    followingEvent:
-      '🌑 Ecosystem services fail. Agriculture collapses. Civilisation as we know it ends. The clock reaches zero.',
-    color: '#4A0000',
-    darkColor: '#2a0000',
+    id: 'avoid_repetition',
+    icon: '♻️',
+    title: 'Avoid Repeating Context',
+    tip: 'Modern models retain conversation history — there\'s no need to re-explain background in every message. Reuse the session instead of starting fresh.',
+    savingPct: 25,
+    detail: 'Re-sending the same system prompt or background document at every turn can easily double the token count of a long conversation. Keep the context window lean and leverage the model\'s memory.',
   },
   {
-    id: 'permafrost_feedback',
-    name: 'Permafrost Runaway Feedback',
-    icon: '🌡️',
-    tokens: 200_000_000_000_000_000, // 200 quadrillion
-    shortDesc: '200 Quadrillion Tokens',
-    description: 'Permafrost thaw becomes self-sustaining — no longer stoppable by human action',
-    consequence:
-      'With 200 quadrillion tokens of AI compute behind us, the permafrost feedback loop is ' +
-      'irreversible. Methane and CO₂ now self-release regardless of human emissions reductions. ' +
-      'Temperatures rise beyond every modelled scenario.',
-    followingEvent:
-      '🌋 Feedback accelerates. Even zero human emissions cannot stop the warming now.',
-    color: '#BF360C',
-    darkColor: '#7f240a',
+    id: 'cache_responses',
+    icon: '💾',
+    title: 'Cache Repeated Queries',
+    tip: 'In automated pipelines, cache responses to identical queries. A cached response costs zero tokens.',
+    savingPct: 60,
+    detail: 'Many production AI workflows repeatedly ask the same questions (e.g. processing templated documents). Semantic caching — returning stored results for near-identical inputs — can eliminate the majority of API calls in high-volume pipelines.',
+    reference: 'https://platform.openai.com/docs/guides/prompt-caching',
   },
   {
-    id: 'monsoon_failure',
-    name: 'Asian Monsoon Failure',
-    icon: '🌧️',
-    tokens: 500_000_000_000_000_000, // 500 quadrillion
-    shortDesc: '500 Quadrillion Tokens',
-    description: 'The Asian monsoon system fails — 3 billion people lose their primary water source',
-    consequence:
-      'The Asian monsoon delivers 70–90 % of annual rainfall to South and East Asia. ' +
-      'Disrupted atmospheric circulation patterns caused by AI\'s energy emissions collapse ' +
-      'this ancient weather system. India, China, and Southeast Asia enter permanent drought.',
-    followingEvent:
-      '💧 3 billion people face water crisis. Nuclear-armed states clash over rivers. Mass migrations begin.',
-    color: '#1565C0',
-    darkColor: '#0d3d7a',
+    id: 'batch_requests',
+    icon: '📦',
+    title: 'Batch Related Requests',
+    tip: 'Instead of five separate API calls, ask for everything in one well-structured prompt. Each round trip carries overhead tokens for context and formatting.',
+    savingPct: 20,
+    detail: 'System messages and conversation headers are repeated for every independent call. Batching reduces per-request overhead and often allows the model to reason across sub-tasks more efficiently.',
   },
   {
-    id: 'civilization_collapse',
-    name: "Civilisation's Last Stand",
-    icon: '🏙️',
-    tokens: 1_000_000_000_000_000_000, // 1 quintillion
-    shortDesc: '1 Quintillion Tokens',
-    description: 'Cascading system failures end industrial civilisation as we know it',
-    consequence:
-      'At one quintillion tokens, the cumulative environmental debt has come due. ' +
-      'Power grids fail. Supply chains dissolve. Nation-states lose the ability to maintain ' +
-      'basic services. The infrastructure that sustains 8 billion human lives begins to collapse.',
-    followingEvent:
-      '🌑 Lights go out across continents. The age of AI ends not with intelligence, but with silence.',
-    color: '#212121',
-    darkColor: '#0a0a0a',
+    id: 'summarise_request',
+    icon: '📋',
+    title: 'Request Concise Outputs',
+    tip: 'Ask for bullet points or a 3-sentence summary rather than full paragraphs when a summary suffices. Output tokens cost as much as input tokens.',
+    savingPct: 40,
+    detail: 'The default verbosity of large language models is a significant source of token waste. Explicit length constraints ("in 50 words or fewer", "bullet list only") reduce output tokens dramatically with minimal quality loss for most use-cases.',
   },
   {
-    id: 'biosphere_collapse',
-    name: 'Biosphere Collapse',
-    icon: '🌑',
-    tokens: 10_000_000_000_000_000_000, // 10 quintillion
-    shortDesc: '10 Quintillion Tokens',
-    description: 'Earth\'s life-support systems fail — the biosphere can no longer sustain complex life',
-    consequence:
-      'The biosphere — the thin living layer that maintains Earth\'s temperature, atmosphere, ' +
-      'and water cycles — has been pushed past all tipping points. Complex multicellular life ' +
-      'can no longer be sustained. Earth enters a new geological epoch defined by absence.',
-    followingEvent:
-      '🕳️ The experiment of intelligence on Earth concludes. The planet heals — in 10 million years.',
-    color: '#000000',
-    darkColor: '#000000',
+    id: 'local_models',
+    icon: '🏠',
+    title: 'Run Local Models',
+    tip: 'Tools like Ollama let you run efficient open-weight models (Phi-3, Llama 3.1 8B) on your own hardware — zero cloud tokens, and often better privacy.',
+    savingPct: 100,
+    detail: 'For private documents, repetitive internal tasks, or offline use cases, running a local model eliminates cloud API calls entirely. Modern quantised models run on a laptop with 16 GB RAM and are competitive with GPT-3.5 on many tasks.',
+    reference: 'https://ollama.com',
   },
 ];
 
@@ -509,14 +239,22 @@ function calculateEnvironmentalImpact(tokens) {
 }
 
 /**
- * Generate future projection data points.
- * @param {number} currentTokens - tokens at `now`
- * @param {number} ratePerSec    - tokens per second
- * @param {number} months        - how many months to project
- * @param {Date}   [now]         - optional date override
+ * Generate future projection data points with optional exponential rate growth.
+ *
+ * With annualGrowthRate = 0 (default) the projection is linear (constant rate).
+ * With annualGrowthRate > 0 the token-production rate itself grows by that
+ * fraction each year — matching the observed hyper-exponential trajectory of
+ * global AI inference and producing the classic "hockey stick" on a linear axis.
+ *
+ * @param {number} currentTokens    - tokens at `now`
+ * @param {number} ratePerSec       - tokens per second at `now`
+ * @param {number} months           - how many months to project
+ * @param {Date}   [now]            - optional date override
+ * @param {number} [annualGrowthRate] - fractional annual growth of ratePerSec
+ *                                     (e.g. 0.5 = 50 % more tokens/sec each year)
  * @returns {Array<{ date: string, tokensT: number }>}
  */
-function generateProjectionData(currentTokens, ratePerSec, months, now) {
+function generateProjectionData(currentTokens, ratePerSec, months, now, annualGrowthRate) {
   if (
     typeof currentTokens !== 'number' ||
     typeof ratePerSec !== 'number' ||
@@ -526,14 +264,27 @@ function generateProjectionData(currentTokens, ratePerSec, months, now) {
     return [];
   }
   const base = now instanceof Date ? now : new Date();
+  const growth = typeof annualGrowthRate === 'number' && annualGrowthRate > 0
+    ? annualGrowthRate
+    : 0;
+  const SECS_PER_YEAR = 365.25 * 24 * 3600;
   const data = [];
   for (let i = 0; i <= months; i++) {
     const d = new Date(base.getTime());
     d.setMonth(d.getMonth() + i);
-    const elapsed = (d - base) / 1000;
+    const elapsed = (d - base) / 1000; // seconds since base
+    let additionalTokens;
+    if (growth === 0) {
+      additionalTokens = ratePerSec * elapsed;
+    } else {
+      // Integral of rate*(1+g)^(t/year) dt from 0 to elapsed:
+      // = rate/k * ((1+g)^(elapsed/year) - 1)  where k = ln(1+g)/year
+      const k = Math.log(1 + growth) / SECS_PER_YEAR;
+      additionalTokens = (ratePerSec / k) * (Math.exp(k * elapsed) - 1);
+    }
     data.push({
       date: d.toISOString().split('T')[0],
-      tokensT: (currentTokens + ratePerSec * elapsed) / 1e12,
+      tokensT: (currentTokens + additionalTokens) / 1e12,
     });
   }
   return data;
@@ -550,7 +301,8 @@ function formatDate(date) {
 }
 
 /**
- * Return a friendly "in X days/months/years" string.
+ * Return a friendly "in X hours/days/months/years" string.
+ * Supports hours and minutes for near-term milestones.
  * @param {Date|null} date
  * @param {Date}      [now]
  * @returns {string}
@@ -560,12 +312,18 @@ function getTimeDelta(date, now) {
   const base = now instanceof Date ? now : new Date();
   const diff = date - base;
   if (diff <= 0) return 'Already passed';
-  const days = Math.floor(diff / (1000 * 60 * 60 * 24));
-  const years = Math.floor(days / 365);
-  const months = Math.floor(days / 30);
-  if (years > 0) return `in ~${years} year${years > 1 ? 's' : ''}`;
-  if (months > 0) return `in ~${months} month${months > 1 ? 's' : ''}`;
-  return `in ~${days} day${days !== 1 ? 's' : ''}`;
+  const totalSeconds = Math.floor(diff / 1000);
+  const totalMinutes = Math.floor(diff / (1000 * 60));
+  const totalHours   = Math.floor(diff / (1000 * 60 * 60));
+  const days         = Math.floor(diff / (1000 * 60 * 60 * 24));
+  const years        = Math.floor(days / 365);
+  const months       = Math.floor(days / 30);
+  if (years > 0)        return `in ~${years} year${years > 1 ? 's' : ''}`;
+  if (months > 0)       return `in ~${months} month${months > 1 ? 's' : ''}`;
+  if (days > 0)         return `in ~${days} day${days !== 1 ? 's' : ''}`;
+  if (totalHours > 0)   return `in ~${totalHours} hour${totalHours !== 1 ? 's' : ''}`;
+  if (totalMinutes > 0) return `in ~${totalMinutes} minute${totalMinutes !== 1 ? 's' : ''}`;
+  return `in ~${totalSeconds} second${totalSeconds !== 1 ? 's' : ''}`;
 }
 
 /**
@@ -598,6 +356,36 @@ function getRateAtDate(date) {
   return RATE_SCHEDULE[0].ratePerSec;
 }
 
+/**
+ * Calculate the collective daily environmental impact if a fraction of global users
+ * consistently applies a token-saving tip.
+ *
+ * @param {number} savingPct      - 0–100, percentage of tokens saved per user per prompt
+ * @param {number} percentOfUsers - 0–100, percentage of global users applying the tip
+ * @param {number} [ratePerSec]   - tokens/sec globally (defaults to TOKENS_PER_SECOND)
+ * @returns {{ tokensPerDay: number, kWhPerDay: number, co2KgPerDay: number, waterLPerDay: number }}
+ */
+function calculateTipImpact(savingPct, percentOfUsers, ratePerSec) {
+  const rate = typeof ratePerSec === 'number' && ratePerSec > 0
+    ? ratePerSec
+    : TOKENS_PER_SECOND;
+  if (
+    typeof savingPct !== 'number' || savingPct < 0 ||
+    typeof percentOfUsers !== 'number' || percentOfUsers < 0
+  ) {
+    return { tokensPerDay: 0, kWhPerDay: 0, co2KgPerDay: 0, waterLPerDay: 0 };
+  }
+  const tokensPerDay = rate * 86400; // 86400 seconds/day
+  const saved = tokensPerDay * (Math.min(savingPct, 100) / 100) * (Math.min(percentOfUsers, 100) / 100);
+  const impact = calculateEnvironmentalImpact(saved);
+  return {
+    tokensPerDay: saved,
+    kWhPerDay:    impact.kWh,
+    co2KgPerDay:  impact.co2Kg,
+    waterLPerDay: impact.waterL,
+  };
+}
+
 // ============================================================
 // FUN FEATURE HELPERS
 // ============================================================
@@ -736,6 +524,7 @@ const DeathClockCore = {
   HISTORICAL_DATA,
   MILESTONES,
   RATE_SCHEDULE,
+  TOKEN_TIPS,
   formatTokenCount,
   formatTokenCountShort,
   getTriggeredMilestones,
@@ -747,6 +536,7 @@ const DeathClockCore = {
   getTimeDelta,
   milestoneProgress,
   getRateAtDate,
+  calculateTipImpact,
   generateEquivalences,
   calculatePersonalFootprint,
   sessionEquivalences,
diff --git a/index.html b/index.html
index 9b26665..e5877fd 100644
--- a/index.html
+++ b/index.html
@@ -217,6 +217,25 @@ <h2>Milestone Prediction Dates</h2>
   </div>
 </section>
 
+<!-- ── Token-Saving Tips ──────────────────────────────────── -->
+<section id="tips-section">
+  <div class="container">
+    <p class="section-label">&#x25A0; Act Now</p>
+    <h2>🌱 How to Reduce Your AI Footprint</h2>
+    <p class="tips-intro">
+      Every prompt matters. Small changes in how you use AI add up to billions of tokens saved —
+      and real environmental resources. The projections above show the worst case.
+      Here's how we change the trajectory.
+    </p>
+    <div class="tips-grid" id="tipsGrid">
+      <!-- populated by script.js -->
+    </div>
+    <div class="tips-impact-wrap" id="tipsImpactWrap">
+      <!-- populated by script.js -->
+    </div>
+  </div>
+</section>
+
 
 <!-- ── Personal Footprint Calculator ─────────────────────── -->
 <section id="calculator-section">
@@ -320,6 +339,8 @@ <h2 id="receipt-heading" class="sr-only">Session Receipt</h2>
   <button id="toast-close" class="toast-close" aria-label="Close notification">✕</button>
 </div>
 
+<!-- Milestone data (auto-generated from milestones.yaml) -->
+<script src="milestones-data.js"></script>
 <!-- Core logic (no DOM deps — loaded first so script.js can use it) -->
 <script src="death-clock-core.js"></script>
 <!-- Minimal Chart.js date adapter (required for time-scale x-axis) -->
diff --git a/milestones-data.js b/milestones-data.js
new file mode 100644
index 0000000..613f2e0
--- /dev/null
+++ b/milestones-data.js
@@ -0,0 +1,434 @@
+'use strict';
+// AUTO-GENERATED from milestones.yaml — do not edit directly.
+// Run `npm run build:milestones` to regenerate from milestones.yaml.
+
+const MILESTONES = [
+  {
+    id: "first_forest",
+    name: "First Forest Felled",
+    icon: "🌲",
+    tokens: 1000000000000,
+    shortDesc: "1 Trillion Tokens",
+    description: "CO₂ equivalent of 50,000 mature trees cut down",
+    consequence: "A single trillion tokens generates CO₂ equal to the annual absorption of 50,000 mature trees. The Amazon loses 4.3 million acres per year — AI energy demands accelerate this.",
+    followingEvent: "🔥 Regional droughts intensify. Species lose habitat. The carbon feedback loop begins.",
+    color: "#2D9B27",
+    darkColor: "#1a6b15",
+    reference: "https://www.iea.org/reports/electricity-2024",
+  },
+  {
+    id: "power_grid_strain",
+    name: "Power Grid Strain",
+    icon: "⚡",
+    tokens: 2000000000000,
+    shortDesc: "2 Trillion Tokens",
+    description: "AI data centres claim 1 % of global electricity — equal to all of Argentina",
+    consequence: "When data centres alone consume 1 % of the world's electricity, every brown-out and rolling blackout hits hospitals, water-treatment plants, and cold-storage food supplies first. Grid operators begin rationing power to residential users.",
+    followingEvent: "💡 Planned blackouts become routine. Industrial production slows. Energy poverty spikes.",
+    color: "#FFAA00",
+    darkColor: "#cc7700",
+    reference: "https://www.iea.org/reports/electricity-2024",
+  },
+  {
+    id: "arctic_ice",
+    name: "First Ice-Free Arctic Summer",
+    icon: "🧊",
+    tokens: 5000000000000,
+    shortDesc: "5 Trillion Tokens",
+    description: "The Arctic Ocean is ice-free for the first time in recorded history",
+    consequence: "Sea ice reflects 80 % of incoming sunlight back into space. Without it, the dark Arctic Ocean absorbs that heat, accelerating warming by 2–3 × above the global average. Polar vortex destabilisation sends extreme weather to temperate regions.",
+    followingEvent: "❄️ Polar vortex collapses. Record cold snaps devastate agriculture at lower latitudes.",
+    color: "#B0E0FF",
+    darkColor: "#5aabdd",
+    reference: "https://www.nature.com/articles/s41586-022-05185-z",
+  },
+  {
+    id: "bee_colony",
+    name: "Bee Colony Collapse",
+    icon: "🐝",
+    tokens: 10000000000000,
+    shortDesc: "10 Trillion Tokens",
+    description: "1 billion bees lost to energy-driven habitat destruction",
+    consequence: "Bees pollinate 35 % of human food crops. AI's growing energy demands accelerate pesticide use and destroy wildflower habitats that bee colonies depend on.",
+    followingEvent: "🌾 1-in-3 food items vanish from shelves. Crop yields drop 35 %. Food prices triple globally.",
+    color: "#FFD700",
+    darkColor: "#b39800",
+    reference: "https://www.science.org/doi/10.1126/science.1253124",
+  },
+  {
+    id: "wildfire_crisis",
+    name: "Permanent Wildfire Season",
+    icon: "🔥",
+    tokens: 20000000000000,
+    shortDesc: "20 Trillion Tokens",
+    description: "Wildfire season becomes year-round across three continents",
+    consequence: "Warmer, drier conditions sustained by AI's CO₂ load eliminate the concept of a fire season. Forests in Australia, the American West, and Southern Europe burn continuously. Smoke blankets cities for months, pushing respiratory illness to epidemic levels.",
+    followingEvent: "🌫️ Air-quality emergencies declared in 40+ cities. Outdoor workers face daily health orders.",
+    color: "#FF5500",
+    darkColor: "#cc3300",
+    reference: "https://www.pnas.org/doi/10.1073/pnas.2011048117",
+  },
+  {
+    id: "silent_species",
+    name: "Silent Spring: 100 Species Gone",
+    icon: "🐦",
+    tokens: 50000000000000,
+    shortDesc: "50 Trillion Tokens",
+    description: "100 vertebrate species driven to extinction by AI-linked habitat destruction",
+    consequence: "Habitat loss and climate change driven by AI energy demands erase entire branches of the tree of life. Each lost species unravels the web of interdependence — pest explosions, crop failures, and disease outbreaks follow as predator-prey balances collapse.",
+    followingEvent: "🌿 Ecosystems destabilise. Invasive species surge. Crop pests breed unchecked.",
+    color: "#66BB6A",
+    darkColor: "#3d7a40",
+    reference: "https://www.pnas.org/doi/10.1073/pnas.2306987120",
+  },
+  {
+    id: "great_lakes",
+    name: "Great Lakes Drained",
+    icon: "💧",
+    tokens: 100000000000000,
+    shortDesc: "100 Trillion Tokens",
+    description: "Data-centre cooling drains freshwater equal to Lake Erie",
+    consequence: "AI data centres consume billions of litres of water annually for cooling. This draws down aquifers and surface supplies that took millennia to accumulate.",
+    followingEvent: "🚰 2 billion people face water scarcity. Water wars erupt between nations. Agriculture fails.",
+    color: "#0077BE",
+    darkColor: "#005490",
+    reference: "https://www.nature.com/articles/d41586-024-00278-9",
+  },
+  {
+    id: "water_table_collapse",
+    name: "Global Water Table Collapse",
+    icon: "🌵",
+    tokens: 200000000000000,
+    shortDesc: "200 Trillion Tokens",
+    description: "Major aquifers — Ogallala, Indo-Gangetic, North China Plain — drop below recovery",
+    consequence: "Underground aquifers that supply half of all irrigation water worldwide have been drawn down past their natural recharge rates. AI data-centre demand pushes many past the point of no return. Regions that once fed nations face permanent desertification.",
+    followingEvent: "🏜️ Breadbasket nations become dust bowls. 1 billion people face famine. Food nationalism spikes.",
+    color: "#C8A96E",
+    darkColor: "#8a6e3e",
+    reference: "https://www.science.org/doi/10.1126/science.aaf3776",
+  },
+  {
+    id: "amazon_tipping",
+    name: "Amazon Tipping Point",
+    icon: "🌳",
+    tokens: 300000000000000,
+    shortDesc: "300 Trillion Tokens",
+    description: "The Amazon rainforest begins converting to savannah — irreversibly",
+    consequence: "Scientists have long warned that 20–25 % deforestation would tip the Amazon into a self-drying feedback loop. AI's cumulative carbon contribution delivers the final increment of warming. The world's largest carbon sink becomes a carbon source.",
+    followingEvent: "🌪️ Global rainfall patterns shift. Monsoons fail. 3 billion people face drought.",
+    color: "#1B5E20",
+    darkColor: "#0d3b12",
+    reference: "https://www.science.org/doi/10.1126/sciadv.abi4517",
+  },
+  {
+    id: "coral_reef",
+    name: "Great Barrier Reef Lost",
+    icon: "🪸",
+    tokens: 500000000000000,
+    shortDesc: "500 Trillion Tokens",
+    description: "CO₂ triggers mass bleaching — the Great Barrier Reef is gone",
+    consequence: "Coral reefs support 25 % of all marine species. Ocean acidification from CO₂ emissions destroys these ecosystems, removing the foundation of oceanic food chains.",
+    followingEvent: "🐠 500 million people lose their primary food source. Fisheries collapse. Ocean deserts expand.",
+    color: "#FF6B6B",
+    darkColor: "#cc3333",
+    reference: "https://www.nature.com/articles/s41558-017-0012-x",
+  },
+  {
+    id: "permafrost_bomb",
+    name: "Permafrost Methane Bomb",
+    icon: "💨",
+    tokens: 750000000000000,
+    shortDesc: "750 Trillion Tokens",
+    description: "Siberian and Alaskan permafrost releases stored methane at runaway rates",
+    consequence: "Permafrost locks away an estimated 1.5 trillion tonnes of carbon — twice the amount currently in the atmosphere. Thawing driven by AI energy emissions triggers methane release that is 84× more potent than CO₂ over 20 years, creating a self-reinforcing feedback loop.",
+    followingEvent: "🌡️ Global temperature rises accelerate beyond all IPCC models. Climate targets become fiction.",
+    color: "#9E9E9E",
+    darkColor: "#616161",
+    reference: "https://www.nature.com/articles/s41586-018-0807-z",
+  },
+  {
+    id: "glacier",
+    name: "Glacier Collapse",
+    icon: "🏔️",
+    tokens: 1000000000000000,
+    shortDesc: "1 Quadrillion Tokens",
+    description: "Warming equivalent destabilises the West Antarctic Ice Sheet",
+    consequence: "Glaciers are the world's largest freshwater reservoirs. Their loss permanently eliminates drinking water for billions and raises sea levels catastrophically.",
+    followingEvent: "🌊 Coastal cities begin flooding. 600 million people displaced. Sea level rises 3 metres.",
+    color: "#A8D8EA",
+    darkColor: "#6ba8c4",
+    reference: "https://www.nature.com/articles/s41558-023-01682-9",
+  },
+  {
+    id: "ocean_acidification",
+    name: "Ocean Acidification Threshold",
+    icon: "🐟",
+    tokens: 2000000000000000,
+    shortDesc: "2 Quadrillion Tokens",
+    description: "Ocean pH drops to 7.95 — shellfish and coral larvae can no longer form shells",
+    consequence: "The ocean has absorbed 30 % of all human CO₂ emissions. As pH drops, the carbonate ions that marine organisms use to build shells and skeletons dissolve. Oysters, mussels, krill, and pteropods — the base of polar food webs — begin failing to reproduce.",
+    followingEvent: "🦐 Krill populations crash. Whales, penguins, and polar bears follow into starvation.",
+    color: "#0D47A1",
+    darkColor: "#082e6a",
+    reference: "https://www.nature.com/articles/s41561-023-01163-y",
+  },
+  {
+    id: "sahel_collapse",
+    name: "Sahel Collapse",
+    icon: "☀️",
+    tokens: 5000000000000000,
+    shortDesc: "5 Quadrillion Tokens",
+    description: "The Sahel belt becomes uninhabitable — 300 million climate refugees displaced",
+    consequence: "The Sahel region, already at the edge of habitability, tips past the point where subsistence farming is possible. A belt of uninhabitable land stretches across Africa from Senegal to Somalia. Tens of millions of climate refugees overwhelm neighbouring regions.",
+    followingEvent: "🌍 Regional governments collapse. Conflict over water and arable land escalates to warfare.",
+    color: "#E65100",
+    darkColor: "#b33d00",
+  },
+  {
+    id: "ocean_dead_zone",
+    name: "Ocean Dead Zone",
+    icon: "🌊",
+    tokens: 10000000000000000,
+    shortDesc: "10 Quadrillion Tokens",
+    description: "Ocean acidification creates a dead zone larger than the Pacific garbage patch",
+    consequence: "CO₂ absorbed by oceans shifts their pH — catastrophic for marine life. Phytoplankton, which produces 50 % of Earth's oxygen, begins dying off.",
+    followingEvent: "😮‍💨 Atmospheric oxygen concentration drops. Human cognitive function declines. Extinction accelerates.",
+    color: "#1A237E",
+    darkColor: "#0d1466",
+    reference: "https://www.science.org/doi/10.1126/science.aam6321",
+  },
+  {
+    id: "jet_stream_collapse",
+    name: "Jet Stream Destabilised",
+    icon: "🌪️",
+    tokens: 30000000000000000,
+    shortDesc: "30 Quadrillion Tokens",
+    description: "Arctic amplification breaks the polar jet stream into chaotic loops",
+    consequence: "The jet stream normally separates cold Arctic air from warm temperate air. As the Arctic warms 4× faster than the rest of the planet, the temperature gradient that drives the jet stream weakens. It buckles into extreme meanders, locking weather patterns in place for weeks.",
+    followingEvent: "❄️🌡️ Europe freezes in July. Texas floods. Monsoons arrive months late. Harvests fail continent-wide.",
+    color: "#7E57C2",
+    darkColor: "#4a2d8a",
+    reference: "https://www.nature.com/articles/s41561-021-00848-8",
+  },
+  {
+    id: "food_system_stress",
+    name: "Global Food System Under Siege",
+    icon: "🌾",
+    tokens: 50000000000000000,
+    shortDesc: "50 Quadrillion Tokens",
+    description: "Simultaneous crop failures on three continents push 1 billion into food insecurity",
+    consequence: "Extreme heat waves, erratic monsoons, and drought driven by AI's cumulative emissions hit major grain-producing regions simultaneously. Global food reserves drop below 60 days. Price spikes trigger social unrest across 40+ countries.",
+    followingEvent: "🍞 Food nationalism spreads. Export bans fracture global trade. Humanitarian crisis escalates.",
+    color: "#8D6E63",
+    darkColor: "#5d4037",
+  },
+  {
+    id: "ai_thirst_today",
+    name: "AI Thirst Today",
+    icon: "💧",
+    tokens: 65075000000000000,
+    shortDesc: "65.075 Quadrillion Tokens",
+    description: "Data centres consume 4.3 billion litres of water — today's share of AI cooling",
+    consequence: "Each day, global AI inference consumes water equivalent to the daily supply of a city of 1.5 million people. Cooling systems in hyperscale data centres draw on local aquifers and municipal water supplies, competing directly with residential and agricultural demand.",
+    followingEvent: "🚰 Water stress alerts issued in tech-hub regions. Residents face hosepipe bans during heatwaves.",
+    color: "#29B6F6",
+    darkColor: "#0277bd",
+    reference: "https://www.nature.com/articles/d41586-024-00278-9",
+  },
+  {
+    id: "daily_energy_reckoning",
+    name: "Daily Energy Reckoning",
+    icon: "⚡",
+    tokens: 65080000000000000,
+    shortDesc: "65.08 Quadrillion Tokens",
+    description: "Today’s AI inference consumes enough energy to power 25,000 homes for a year",
+    consequence: "The global AI industry now processes tokens at a rate that demands roughly 8.6 trillion tokens worth of energy every day. At current efficiency rates that equates to 2.6 million kWh — enough to power a small town for a year, consumed in 24 hours.",
+    followingEvent: "🏭 Industrial electricity tariffs rise as data-centre demand crowds out manufacturing.",
+    color: "#FFA726",
+    darkColor: "#e65100",
+    reference: "https://www.iea.org/energy-system/technology/data-centres-and-data-transmission-networks",
+  },
+  {
+    id: "carbon_checkpoint",
+    name: "Carbon Checkpoint",
+    icon: "🌡️",
+    tokens: 65100000000000000,
+    shortDesc: "65.1 Quadrillion Tokens",
+    description: "Cumulative AI emissions now exceed the annual CO₂ output of a mid-sized nation",
+    consequence: "In just a few days, global AI systems will add token counts equivalent to the annual carbon footprint of a country of 10 million people. The rate is accelerating: what took years to accumulate early in AI's history now happens in weeks.",
+    followingEvent: "📊 Emissions trackers begin flagging AI as a discrete industrial sector in national inventories.",
+    color: "#EF5350",
+    darkColor: "#b71c1c",
+  },
+  {
+    id: "fortnight_forest_impact",
+    name: "Fortnight Forest Impact",
+    icon: "🌳",
+    tokens: 65200000000000000,
+    shortDesc: "65.2 Quadrillion Tokens",
+    description: "Two weeks of AI token growth equals the carbon sequestration of 100,000 acres of forest",
+    consequence: "In the time it takes to grow two weeks' worth of tokens, AI systems generate CO₂ that would take 100,000 acres of mature forest a full year to reabsorb. Global deforestation is already outpacing replanting; AI adds a growing supplementary load.",
+    followingEvent: "🌳 Forest carbon credits tighten. Offsetting schemes struggle to keep pace with AI emissions.",
+    color: "#66BB6A",
+    darkColor: "#2e7d32",
+  },
+  {
+    id: "city_power_month",
+    name: "City Power Month",
+    icon: "🏙️",
+    tokens: 65500000000000000,
+    shortDesc: "65.5 Quadrillion Tokens",
+    description: "Seven weeks of AI inference draws the same electricity as powering London for a month",
+    consequence: "Over the past seven weeks, global AI has consumed tokens generating electricity demand equivalent to powering a city the size of London for an entire month. Grid operators in high-density tech corridors now model AI load as a primary planning variable, alongside industrial and residential demand.",
+    followingEvent: "💡 Power utilities begin curtailment schedules for non-critical AI workloads during peak demand.",
+    color: "#AB47BC",
+    darkColor: "#6a1b9a",
+    reference: "https://www.iea.org/reports/electricity-2024",
+  },
+  {
+    id: "quarterly_climate_cost",
+    name: "Quarterly Climate Cost",
+    icon: "🌊",
+    tokens: 66000000000000000,
+    shortDesc: "66 Quadrillion Tokens",
+    description: "AI’s quarterly token growth adds CO₂ equivalent to burning 5 billion kilograms of coal",
+    consequence: "In less than four months, the world's AI systems will process another quadrillion tokens. The energy bill: carbon equivalent to 5 billion kg of coal burned. Regulators in the EU and US begin mandating AI energy disclosures in quarterly corporate reports.",
+    followingEvent: "📋 Mandatory AI carbon audits proposed in 40 countries. Data-centre planning approvals stall.",
+    color: "#26A69A",
+    darkColor: "#00695c",
+  },
+  {
+    id: "monsoon_disruption_warning",
+    name: "Monsoon Disruption Warning",
+    icon: "🌧️",
+    tokens: 67000000000000000,
+    shortDesc: "67 Quadrillion Tokens",
+    description: "Climate scientists flag AI energy heat-islands as a measurable monsoon disruptor",
+    consequence: "Concentrated heat output from mega-data-centre clusters alters local atmospheric moisture patterns. Research links the density of data-centre heat plumes in South and Southeast Asia to measurable shifts in pre-monsoon cloud formation. Delayed monsoons reduce crop yields for hundreds of millions of subsistence farmers.",
+    followingEvent: "💧 Monsoon onset delayed by 10–14 days in three major agricultural regions. Rice harvest forecasts cut.",
+    color: "#42A5F5",
+    darkColor: "#1565c0",
+    reference: "https://www.nature.com/articles/s41612-023-00387-4",
+  },
+  {
+    id: "annual_energy_audit",
+    name: "Annual Energy Audit",
+    icon: "🏭",
+    tokens: 68000000000000000,
+    shortDesc: "68 Quadrillion Tokens",
+    description: "One year of AI growth consumes electricity equivalent to all of India for six months",
+    consequence: "A full year of AI token production adds 3+ quadrillion tokens to the cumulative total. The electricity bill for that year rivals the annual consumption of a G20 nation's residential sector. Power grids in major tech hubs routinely operate above 95 % capacity, leaving no margin for unexpected demand spikes.",
+    followingEvent: "🚨 Grid fragility incidents rise. Rolling brownouts reported in data-centre-dense regions.",
+    color: "#FF7043",
+    darkColor: "#bf360c",
+    reference: "https://www.iea.org/reports/electricity-2024",
+  },
+  {
+    id: "two_year_carbon_budget",
+    name: "Two-Year Carbon Budget Warning",
+    icon: "🌱",
+    tokens: 72000000000000000,
+    shortDesc: "72 Quadrillion Tokens",
+    description: "Two years of AI compound growth consumes a measurable slice of the 1.5°C carbon budget",
+    consequence: "Scientists tracking the remaining carbon budget for 1.5°C identify AI infrastructure as one of the fastest-growing emission categories. Compound growth in token production means each passing year adds proportionally more CO₂, not less. The window for course correction narrows with every billion tokens.",
+    followingEvent: "🚨 IPCC emergency review triggered. AI emissions added to national carbon accounting frameworks.",
+    color: "#8BC34A",
+    darkColor: "#33691e",
+    reference: "https://www.ipcc.ch/report/ar6/syr/",
+  },
+  {
+    id: "grid_breaking_point",
+    name: "Grid Infrastructure Breaking Point",
+    icon: "🔋",
+    tokens: 80000000000000000,
+    shortDesc: "80 Quadrillion Tokens",
+    description: "AI now consumes more electricity than the entire global residential sector did in 2020",
+    consequence: "At 80 quadrillion tokens, AI's cumulative energy demand has grown to rival the residential electricity consumption of the entire planet circa 2020. Existing transmission infrastructure was not designed for this load. Brownouts, grid faults, and demand-rationing become normalised in regions without proactive investment.",
+    followingEvent: "💥 Major grid failures reported in three continents. Hospitals and data centres compete for backup power.",
+    color: "#F57F17",
+    darkColor: "#e65100",
+    reference: "https://www.iea.org/energy-system/technology/data-centres-and-data-transmission-networks",
+  },
+  {
+    id: "decade_of_damage",
+    name: "Decade of Damage",
+    icon: "🌎",
+    tokens: 90000000000000000,
+    shortDesc: "90 Quadrillion Tokens",
+    description: "Eight years of unchecked AI growth locks in 0.1°C of additional warming",
+    consequence: "Climate models incorporating AI's compound energy trajectory show that eight years of growth at historical rates locks in an additional 0.1°C of warming above already-committed levels. That fraction of a degree translates into millions more people exposed to extreme heat, rising seas, and failing harvests.",
+    followingEvent: "📊 Climate departure dates brought forward by 3–5 years in tropical regions. Adaptation plans rewritten.",
+    color: "#D32F2F",
+    darkColor: "#7f0000",
+    reference: "https://www.nature.com/articles/s41558-022-01533-z",
+  },
+  {
+    id: "mass_extinction",
+    name: "Sixth Mass Extinction",
+    icon: "💀",
+    tokens: 100000000000000000,
+    shortDesc: "100 Quadrillion Tokens",
+    description: "AI energy demands push 10,000+ species to irreversible extinction",
+    consequence: "We are already in the sixth mass extinction. AI's insatiable energy hunger accelerates species loss beyond any recovery. Biodiversity collapses irreversibly.",
+    followingEvent: "🌑 Ecosystem services fail. Agriculture collapses. Civilisation as we know it ends. The clock reaches zero.",
+    color: "#4A0000",
+    darkColor: "#2a0000",
+    reference: "https://www.pnas.org/doi/10.1073/pnas.2306987120",
+  },
+  {
+    id: "permafrost_feedback",
+    name: "Permafrost Runaway Feedback",
+    icon: "🌡️",
+    tokens: 200000000000000000,
+    shortDesc: "200 Quadrillion Tokens",
+    description: "Permafrost thaw becomes self-sustaining — no longer stoppable by human action",
+    consequence: "With 200 quadrillion tokens of AI compute behind us, the permafrost feedback loop is irreversible. Methane and CO₂ now self-release regardless of human emissions reductions. Temperatures rise beyond every modelled scenario.",
+    followingEvent: "🌋 Feedback accelerates. Even zero human emissions cannot stop the warming now.",
+    color: "#BF360C",
+    darkColor: "#7f240a",
+    reference: "https://www.nature.com/articles/s41586-018-0807-z",
+  },
+  {
+    id: "monsoon_failure",
+    name: "Asian Monsoon Failure",
+    icon: "🌧️",
+    tokens: 500000000000000000,
+    shortDesc: "500 Quadrillion Tokens",
+    description: "The Asian monsoon system fails — 3 billion people lose their primary water source",
+    consequence: "The Asian monsoon delivers 70–90 % of annual rainfall to South and East Asia. Disrupted atmospheric circulation patterns caused by AI's energy emissions collapse this ancient weather system. India, China, and Southeast Asia enter permanent drought.",
+    followingEvent: "💧 3 billion people face water crisis. Nuclear-armed states clash over rivers. Mass migrations begin.",
+    color: "#1565C0",
+    darkColor: "#0d3d7a",
+  },
+  {
+    id: "civilization_collapse",
+    name: "Civilisation’s Last Stand",
+    icon: "🏙️",
+    tokens: 1000000000000000000,
+    shortDesc: "1 Quintillion Tokens",
+    description: "Cascading system failures end industrial civilisation as we know it",
+    consequence: "At one quintillion tokens, the cumulative environmental debt has come due. Power grids fail. Supply chains dissolve. Nation-states lose the ability to maintain basic services. The infrastructure that sustains 8 billion human lives begins to collapse.",
+    followingEvent: "🌑 Lights go out across continents. The age of AI ends not with intelligence, but with silence.",
+    color: "#212121",
+    darkColor: "#0a0a0a",
+  },
+  {
+    id: "biosphere_collapse",
+    name: "Biosphere Collapse",
+    icon: "🌑",
+    tokens: 10000000000000000000,
+    shortDesc: "10 Quintillion Tokens",
+    description: "Earth’s life-support systems fail — the biosphere can no longer sustain complex life",
+    consequence: "The biosphere — the thin living layer that maintains Earth's temperature, atmosphere, and water cycles — has been pushed past all tipping points. Complex multicellular life can no longer be sustained. Earth enters a new geological epoch defined by absence.",
+    followingEvent: "🕳️ The experiment of intelligence on Earth concludes. The planet heals — in 10 million years.",
+    color: "#000000",
+    darkColor: "#000000",
+  },
+];
+
+/* istanbul ignore next */
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { MILESTONES };
+} else if (typeof window !== 'undefined') {
+  window.MilestonesData = { MILESTONES };
+}
diff --git a/milestones.yaml b/milestones.yaml
new file mode 100644
index 0000000..cd85ecc
--- /dev/null
+++ b/milestones.yaml
@@ -0,0 +1,547 @@
+# AI Death Clock — Milestone Definitions
+# ============================================================
+# This file is the human-readable source of truth for all milestone data.
+# Edit this file to add, remove, or update milestones.
+#
+# After editing, regenerate milestones-data.js by running:
+#   npm run build:milestones
+#
+# Fields:
+#   id          (string)  Unique identifier (snake_case)
+#   name        (string)  Short display name
+#   icon        (string)  Emoji icon
+#   tokens      (integer) Cumulative global token threshold
+#   shortDesc   (string)  Token count summary (e.g. "1 Trillion Tokens")
+#   description (string)  One-line description of the environmental event
+#   consequence (string)  Multi-sentence explanation of the impact
+#   followingEvent (string) Follow-on consequence (starts with emoji)
+#   color       (string)  Light-mode accent colour (CSS hex)
+#   darkColor   (string)  Dark-mode accent colour (CSS hex)
+#   reference   (string)  Optional URL to a supporting source (omit if none)
+#
+# IMPORTANT: Keep entries sorted in ascending `tokens` order.
+# ============================================================
+
+milestones:
+
+  - id: first_forest
+    name: First Forest Felled
+    icon: "\U0001F332"
+    tokens: 1000000000000
+    shortDesc: 1 Trillion Tokens
+    description: "CO₂ equivalent of 50,000 mature trees cut down"
+    consequence: >-
+      A single trillion tokens generates CO₂ equal to the annual absorption of
+      50,000 mature trees. The Amazon loses 4.3 million acres per year —
+      AI energy demands accelerate this.
+    followingEvent: "\U0001F525 Regional droughts intensify. Species lose habitat. The carbon feedback loop begins."
+    color: '#2D9B27'
+    darkColor: '#1a6b15'
+    reference: 'https://www.iea.org/reports/electricity-2024'
+
+  - id: power_grid_strain
+    name: Power Grid Strain
+    icon: "⚡"
+    tokens: 2000000000000
+    shortDesc: 2 Trillion Tokens
+    description: "AI data centres claim 1 % of global electricity — equal to all of Argentina"
+    consequence: >-
+      When data centres alone consume 1 % of the world's electricity, every
+      brown-out and rolling blackout hits hospitals, water-treatment plants, and
+      cold-storage food supplies first. Grid operators begin rationing power to
+      residential users.
+    followingEvent: "\U0001F4A1 Planned blackouts become routine. Industrial production slows. Energy poverty spikes."
+    color: '#FFAA00'
+    darkColor: '#cc7700'
+    reference: 'https://www.iea.org/reports/electricity-2024'
+
+  - id: arctic_ice
+    name: First Ice-Free Arctic Summer
+    icon: "\U0001F9CA"
+    tokens: 5000000000000
+    shortDesc: 5 Trillion Tokens
+    description: The Arctic Ocean is ice-free for the first time in recorded history
+    consequence: >-
+      Sea ice reflects 80 % of incoming sunlight back into space. Without it, the
+      dark Arctic Ocean absorbs that heat, accelerating warming by 2–3 × above
+      the global average. Polar vortex destabilisation sends extreme weather to
+      temperate regions.
+    followingEvent: "❄️ Polar vortex collapses. Record cold snaps devastate agriculture at lower latitudes."
+    color: '#B0E0FF'
+    darkColor: '#5aabdd'
+    reference: 'https://www.nature.com/articles/s41586-022-05185-z'
+
+  - id: bee_colony
+    name: Bee Colony Collapse
+    icon: "\U0001F41D"
+    tokens: 10000000000000
+    shortDesc: 10 Trillion Tokens
+    description: 1 billion bees lost to energy-driven habitat destruction
+    consequence: >-
+      Bees pollinate 35 % of human food crops. AI's growing energy demands
+      accelerate pesticide use and destroy wildflower habitats that bee
+      colonies depend on.
+    followingEvent: "\U0001F33E 1-in-3 food items vanish from shelves. Crop yields drop 35 %. Food prices triple globally."
+    color: '#FFD700'
+    darkColor: '#b39800'
+    reference: 'https://www.science.org/doi/10.1126/science.1253124'
+
+  - id: wildfire_crisis
+    name: Permanent Wildfire Season
+    icon: "\U0001F525"
+    tokens: 20000000000000
+    shortDesc: 20 Trillion Tokens
+    description: Wildfire season becomes year-round across three continents
+    consequence: >-
+      Warmer, drier conditions sustained by AI's CO₂ load eliminate the concept
+      of a fire season. Forests in Australia, the American West, and Southern
+      Europe burn continuously. Smoke blankets cities for months, pushing
+      respiratory illness to epidemic levels.
+    followingEvent: "\U0001F32B️ Air-quality emergencies declared in 40+ cities. Outdoor workers face daily health orders."
+    color: '#FF5500'
+    darkColor: '#cc3300'
+    reference: 'https://www.pnas.org/doi/10.1073/pnas.2011048117'
+
+  - id: silent_species
+    name: "Silent Spring: 100 Species Gone"
+    icon: "\U0001F426"
+    tokens: 50000000000000
+    shortDesc: 50 Trillion Tokens
+    description: 100 vertebrate species driven to extinction by AI-linked habitat destruction
+    consequence: >-
+      Habitat loss and climate change driven by AI energy demands erase entire
+      branches of the tree of life. Each lost species unravels the web of
+      interdependence — pest explosions, crop failures, and disease outbreaks
+      follow as predator-prey balances collapse.
+    followingEvent: "\U0001F33F Ecosystems destabilise. Invasive species surge. Crop pests breed unchecked."
+    color: '#66BB6A'
+    darkColor: '#3d7a40'
+    reference: 'https://www.pnas.org/doi/10.1073/pnas.2306987120'
+
+  - id: great_lakes
+    name: Great Lakes Drained
+    icon: "\U0001F4A7"
+    tokens: 100000000000000
+    shortDesc: 100 Trillion Tokens
+    description: "Data-centre cooling drains freshwater equal to Lake Erie"
+    consequence: >-
+      AI data centres consume billions of litres of water annually for cooling.
+      This draws down aquifers and surface supplies that took millennia to
+      accumulate.
+    followingEvent: "\U0001F6B0 2 billion people face water scarcity. Water wars erupt between nations. Agriculture fails."
+    color: '#0077BE'
+    darkColor: '#005490'
+    reference: 'https://www.nature.com/articles/d41586-024-00278-9'
+
+  - id: water_table_collapse
+    name: Global Water Table Collapse
+    icon: "\U0001F335"
+    tokens: 200000000000000
+    shortDesc: 200 Trillion Tokens
+    description: "Major aquifers — Ogallala, Indo-Gangetic, North China Plain — drop below recovery"
+    consequence: >-
+      Underground aquifers that supply half of all irrigation water worldwide
+      have been drawn down past their natural recharge rates. AI data-centre
+      demand pushes many past the point of no return. Regions that once fed
+      nations face permanent desertification.
+    followingEvent: "\U0001F3DC️ Breadbasket nations become dust bowls. 1 billion people face famine. Food nationalism spikes."
+    color: '#C8A96E'
+    darkColor: '#8a6e3e'
+    reference: 'https://www.science.org/doi/10.1126/science.aaf3776'
+
+  - id: amazon_tipping
+    name: Amazon Tipping Point
+    icon: "\U0001F333"
+    tokens: 300000000000000
+    shortDesc: 300 Trillion Tokens
+    description: The Amazon rainforest begins converting to savannah — irreversibly
+    consequence: >-
+      Scientists have long warned that 20–25 % deforestation would tip the Amazon
+      into a self-drying feedback loop. AI's cumulative carbon contribution
+      delivers the final increment of warming. The world's largest carbon sink
+      becomes a carbon source.
+    followingEvent: "\U0001F32A️ Global rainfall patterns shift. Monsoons fail. 3 billion people face drought."
+    color: '#1B5E20'
+    darkColor: '#0d3b12'
+    reference: 'https://www.science.org/doi/10.1126/sciadv.abi4517'
+
+  - id: coral_reef
+    name: Great Barrier Reef Lost
+    icon: "\U0001FAB8"
+    tokens: 500000000000000
+    shortDesc: 500 Trillion Tokens
+    description: "CO₂ triggers mass bleaching — the Great Barrier Reef is gone"
+    consequence: >-
+      Coral reefs support 25 % of all marine species. Ocean acidification from
+      CO₂ emissions destroys these ecosystems, removing the foundation of
+      oceanic food chains.
+    followingEvent: "\U0001F420 500 million people lose their primary food source. Fisheries collapse. Ocean deserts expand."
+    color: '#FF6B6B'
+    darkColor: '#cc3333'
+    reference: 'https://www.nature.com/articles/s41558-017-0012-x'
+
+  - id: permafrost_bomb
+    name: Permafrost Methane Bomb
+    icon: "\U0001F4A8"
+    tokens: 750000000000000
+    shortDesc: 750 Trillion Tokens
+    description: Siberian and Alaskan permafrost releases stored methane at runaway rates
+    consequence: >-
+      Permafrost locks away an estimated 1.5 trillion tonnes of carbon — twice
+      the amount currently in the atmosphere. Thawing driven by AI energy
+      emissions triggers methane release that is 84× more potent than CO₂
+      over 20 years, creating a self-reinforcing feedback loop.
+    followingEvent: "\U0001F321️ Global temperature rises accelerate beyond all IPCC models. Climate targets become fiction."
+    color: '#9E9E9E'
+    darkColor: '#616161'
+    reference: 'https://www.nature.com/articles/s41586-018-0807-z'
+
+  - id: glacier
+    name: Glacier Collapse
+    icon: "\U0001F3D4️"
+    tokens: 1000000000000000
+    shortDesc: 1 Quadrillion Tokens
+    description: Warming equivalent destabilises the West Antarctic Ice Sheet
+    consequence: >-
+      Glaciers are the world's largest freshwater reservoirs. Their loss
+      permanently eliminates drinking water for billions and raises sea levels
+      catastrophically.
+    followingEvent: "\U0001F30A Coastal cities begin flooding. 600 million people displaced. Sea level rises 3 metres."
+    color: '#A8D8EA'
+    darkColor: '#6ba8c4'
+    reference: 'https://www.nature.com/articles/s41558-023-01682-9'
+
+  - id: ocean_acidification
+    name: Ocean Acidification Threshold
+    icon: "\U0001F41F"
+    tokens: 2000000000000000
+    shortDesc: 2 Quadrillion Tokens
+    description: "Ocean pH drops to 7.95 — shellfish and coral larvae can no longer form shells"
+    consequence: >-
+      The ocean has absorbed 30 % of all human CO₂ emissions. As pH drops,
+      the carbonate ions that marine organisms use to build shells and skeletons
+      dissolve. Oysters, mussels, krill, and pteropods — the base of polar
+      food webs — begin failing to reproduce.
+    followingEvent: "\U0001F990 Krill populations crash. Whales, penguins, and polar bears follow into starvation."
+    color: '#0D47A1'
+    darkColor: '#082e6a'
+    reference: 'https://www.nature.com/articles/s41561-023-01163-y'
+
+  - id: sahel_collapse
+    name: Sahel Collapse
+    icon: "☀️"
+    tokens: 5000000000000000
+    shortDesc: 5 Quadrillion Tokens
+    description: "The Sahel belt becomes uninhabitable — 300 million climate refugees displaced"
+    consequence: >-
+      The Sahel region, already at the edge of habitability, tips past the
+      point where subsistence farming is possible. A belt of uninhabitable land
+      stretches across Africa from Senegal to Somalia. Tens of millions of
+      climate refugees overwhelm neighbouring regions.
+    followingEvent: "\U0001F30D Regional governments collapse. Conflict over water and arable land escalates to warfare."
+    color: '#E65100'
+    darkColor: '#b33d00'
+
+  - id: ocean_dead_zone
+    name: Ocean Dead Zone
+    icon: "\U0001F30A"
+    tokens: 10000000000000000
+    shortDesc: 10 Quadrillion Tokens
+    description: Ocean acidification creates a dead zone larger than the Pacific garbage patch
+    consequence: >-
+      CO₂ absorbed by oceans shifts their pH — catastrophic for marine life.
+      Phytoplankton, which produces 50 % of Earth's oxygen, begins dying off.
+    followingEvent: "\U0001F62E‍\U0001F4A8 Atmospheric oxygen concentration drops. Human cognitive function declines. Extinction accelerates."
+    color: '#1A237E'
+    darkColor: '#0d1466'
+    reference: 'https://www.science.org/doi/10.1126/science.aam6321'
+
+  - id: jet_stream_collapse
+    name: Jet Stream Destabilised
+    icon: "\U0001F32A️"
+    tokens: 30000000000000000
+    shortDesc: 30 Quadrillion Tokens
+    description: Arctic amplification breaks the polar jet stream into chaotic loops
+    consequence: >-
+      The jet stream normally separates cold Arctic air from warm temperate
+      air. As the Arctic warms 4× faster than the rest of the planet, the
+      temperature gradient that drives the jet stream weakens. It buckles into
+      extreme meanders, locking weather patterns in place for weeks.
+    followingEvent: "❄️\U0001F321️ Europe freezes in July. Texas floods. Monsoons arrive months late. Harvests fail continent-wide."
+    color: '#7E57C2'
+    darkColor: '#4a2d8a'
+    reference: 'https://www.nature.com/articles/s41561-021-00848-8'
+
+  - id: food_system_stress
+    name: Global Food System Under Siege
+    icon: "\U0001F33E"
+    tokens: 50000000000000000
+    shortDesc: 50 Quadrillion Tokens
+    description: Simultaneous crop failures on three continents push 1 billion into food insecurity
+    consequence: >-
+      Extreme heat waves, erratic monsoons, and drought driven by AI's
+      cumulative emissions hit major grain-producing regions simultaneously.
+      Global food reserves drop below 60 days. Price spikes trigger social
+      unrest across 40+ countries.
+    followingEvent: "\U0001F35E Food nationalism spreads. Export bans fracture global trade. Humanitarian crisis escalates."
+    color: '#8D6E63'
+    darkColor: '#5d4037'
+
+  # ── Near-term milestones (hours → years from April 2026) ──────────────────
+
+  - id: ai_thirst_today
+    name: AI Thirst Today
+    icon: "\U0001F4A7"
+    tokens: 65075000000000000
+    shortDesc: 65.075 Quadrillion Tokens
+    description: "Data centres consume 4.3 billion litres of water — today's share of AI cooling"
+    consequence: >-
+      Each day, global AI inference consumes water equivalent to the daily
+      supply of a city of 1.5 million people. Cooling systems in hyperscale
+      data centres draw on local aquifers and municipal water supplies,
+      competing directly with residential and agricultural demand.
+    followingEvent: "\U0001F6B0 Water stress alerts issued in tech-hub regions. Residents face hosepipe bans during heatwaves."
+    color: '#29B6F6'
+    darkColor: '#0277bd'
+    reference: 'https://www.nature.com/articles/d41586-024-00278-9'
+
+  - id: daily_energy_reckoning
+    name: Daily Energy Reckoning
+    icon: "⚡"
+    tokens: 65080000000000000
+    shortDesc: 65.08 Quadrillion Tokens
+    description: "Today’s AI inference consumes enough energy to power 25,000 homes for a year"
+    consequence: >-
+      The global AI industry now processes tokens at a rate that demands
+      roughly 8.6 trillion tokens worth of energy every day. At current
+      efficiency rates that equates to 2.6 million kWh — enough to power
+      a small town for a year, consumed in 24 hours.
+    followingEvent: "\U0001F3ED Industrial electricity tariffs rise as data-centre demand crowds out manufacturing."
+    color: '#FFA726'
+    darkColor: '#e65100'
+    reference: 'https://www.iea.org/energy-system/technology/data-centres-and-data-transmission-networks'
+
+  - id: carbon_checkpoint
+    name: Carbon Checkpoint
+    icon: "\U0001F321️"
+    tokens: 65100000000000000
+    shortDesc: 65.1 Quadrillion Tokens
+    description: "Cumulative AI emissions now exceed the annual CO₂ output of a mid-sized nation"
+    consequence: >-
+      In just a few days, global AI systems will add token counts equivalent
+      to the annual carbon footprint of a country of 10 million people.
+      The rate is accelerating: what took years to accumulate early in AI's
+      history now happens in weeks.
+    followingEvent: "\U0001F4CA Emissions trackers begin flagging AI as a discrete industrial sector in national inventories."
+    color: '#EF5350'
+    darkColor: '#b71c1c'
+
+  - id: fortnight_forest_impact
+    name: Fortnight Forest Impact
+    icon: "\U0001F333"
+    tokens: 65200000000000000
+    shortDesc: 65.2 Quadrillion Tokens
+    description: "Two weeks of AI token growth equals the carbon sequestration of 100,000 acres of forest"
+    consequence: >-
+      In the time it takes to grow two weeks' worth of tokens, AI systems
+      generate CO₂ that would take 100,000 acres of mature forest a full year
+      to reabsorb. Global deforestation is already outpacing replanting;
+      AI adds a growing supplementary load.
+    followingEvent: "\U0001F333 Forest carbon credits tighten. Offsetting schemes struggle to keep pace with AI emissions."
+    color: '#66BB6A'
+    darkColor: '#2e7d32'
+
+  - id: city_power_month
+    name: City Power Month
+    icon: "\U0001F3D9️"
+    tokens: 65500000000000000
+    shortDesc: 65.5 Quadrillion Tokens
+    description: "Seven weeks of AI inference draws the same electricity as powering London for a month"
+    consequence: >-
+      Over the past seven weeks, global AI has consumed tokens generating
+      electricity demand equivalent to powering a city the size of London for
+      an entire month. Grid operators in high-density tech corridors now model
+      AI load as a primary planning variable, alongside industrial and
+      residential demand.
+    followingEvent: "\U0001F4A1 Power utilities begin curtailment schedules for non-critical AI workloads during peak demand."
+    color: '#AB47BC'
+    darkColor: '#6a1b9a'
+    reference: 'https://www.iea.org/reports/electricity-2024'
+
+  - id: quarterly_climate_cost
+    name: Quarterly Climate Cost
+    icon: "\U0001F30A"
+    tokens: 66000000000000000
+    shortDesc: 66 Quadrillion Tokens
+    description: "AI’s quarterly token growth adds CO₂ equivalent to burning 5 billion kilograms of coal"
+    consequence: >-
+      In less than four months, the world's AI systems will process another
+      quadrillion tokens. The energy bill: carbon equivalent to 5 billion kg
+      of coal burned. Regulators in the EU and US begin mandating AI energy
+      disclosures in quarterly corporate reports.
+    followingEvent: "\U0001F4CB Mandatory AI carbon audits proposed in 40 countries. Data-centre planning approvals stall."
+    color: '#26A69A'
+    darkColor: '#00695c'
+
+  - id: monsoon_disruption_warning
+    name: Monsoon Disruption Warning
+    icon: "\U0001F327️"
+    tokens: 67000000000000000
+    shortDesc: 67 Quadrillion Tokens
+    description: "Climate scientists flag AI energy heat-islands as a measurable monsoon disruptor"
+    consequence: >-
+      Concentrated heat output from mega-data-centre clusters alters local
+      atmospheric moisture patterns. Research links the density of data-centre
+      heat plumes in South and Southeast Asia to measurable shifts in
+      pre-monsoon cloud formation. Delayed monsoons reduce crop yields for
+      hundreds of millions of subsistence farmers.
+    followingEvent: "\U0001F4A7 Monsoon onset delayed by 10–14 days in three major agricultural regions. Rice harvest forecasts cut."
+    color: '#42A5F5'
+    darkColor: '#1565c0'
+    reference: 'https://www.nature.com/articles/s41612-023-00387-4'
+
+  - id: annual_energy_audit
+    name: Annual Energy Audit
+    icon: "\U0001F3ED"
+    tokens: 68000000000000000
+    shortDesc: 68 Quadrillion Tokens
+    description: "One year of AI growth consumes electricity equivalent to all of India for six months"
+    consequence: >-
+      A full year of AI token production adds 3+ quadrillion tokens to the
+      cumulative total. The electricity bill for that year rivals the annual
+      consumption of a G20 nation's residential sector. Power grids in major
+      tech hubs routinely operate above 95 % capacity, leaving no margin
+      for unexpected demand spikes.
+    followingEvent: "\U0001F6A8 Grid fragility incidents rise. Rolling brownouts reported in data-centre-dense regions."
+    color: '#FF7043'
+    darkColor: '#bf360c'
+    reference: 'https://www.iea.org/reports/electricity-2024'
+
+  - id: two_year_carbon_budget
+    name: Two-Year Carbon Budget Warning
+    icon: "\U0001F331"
+    tokens: 72000000000000000
+    shortDesc: 72 Quadrillion Tokens
+    description: "Two years of AI compound growth consumes a measurable slice of the 1.5°C carbon budget"
+    consequence: >-
+      Scientists tracking the remaining carbon budget for 1.5°C identify
+      AI infrastructure as one of the fastest-growing emission categories.
+      Compound growth in token production means each passing year adds
+      proportionally more CO₂, not less. The window for course correction
+      narrows with every billion tokens.
+    followingEvent: "\U0001F6A8 IPCC emergency review triggered. AI emissions added to national carbon accounting frameworks."
+    color: '#8BC34A'
+    darkColor: '#33691e'
+    reference: 'https://www.ipcc.ch/report/ar6/syr/'
+
+  - id: grid_breaking_point
+    name: Grid Infrastructure Breaking Point
+    icon: "\U0001F50B"
+    tokens: 80000000000000000
+    shortDesc: 80 Quadrillion Tokens
+    description: "AI now consumes more electricity than the entire global residential sector did in 2020"
+    consequence: >-
+      At 80 quadrillion tokens, AI's cumulative energy demand has grown to
+      rival the residential electricity consumption of the entire planet circa
+      2020. Existing transmission infrastructure was not designed for this
+      load. Brownouts, grid faults, and demand-rationing become normalised
+      in regions without proactive investment.
+    followingEvent: "\U0001F4A5 Major grid failures reported in three continents. Hospitals and data centres compete for backup power."
+    color: '#F57F17'
+    darkColor: '#e65100'
+    reference: 'https://www.iea.org/energy-system/technology/data-centres-and-data-transmission-networks'
+
+  - id: decade_of_damage
+    name: Decade of Damage
+    icon: "\U0001F30E"
+    tokens: 90000000000000000
+    shortDesc: 90 Quadrillion Tokens
+    description: "Eight years of unchecked AI growth locks in 0.1°C of additional warming"
+    consequence: >-
+      Climate models incorporating AI's compound energy trajectory show that
+      eight years of growth at historical rates locks in an additional
+      0.1°C of warming above already-committed levels. That fraction of a
+      degree translates into millions more people exposed to extreme heat,
+      rising seas, and failing harvests.
+    followingEvent: "\U0001F4CA Climate departure dates brought forward by 3–5 years in tropical regions. Adaptation plans rewritten."
+    color: '#D32F2F'
+    darkColor: '#7f0000'
+    reference: 'https://www.nature.com/articles/s41558-022-01533-z'
+
+  # ── Far-future milestones ─────────────────────────────────────────────────
+
+  - id: mass_extinction
+    name: Sixth Mass Extinction
+    icon: "\U0001F480"
+    tokens: 100000000000000000
+    shortDesc: 100 Quadrillion Tokens
+    description: "AI energy demands push 10,000+ species to irreversible extinction"
+    consequence: >-
+      We are already in the sixth mass extinction. AI's insatiable energy
+      hunger accelerates species loss beyond any recovery. Biodiversity
+      collapses irreversibly.
+    followingEvent: "\U0001F311 Ecosystem services fail. Agriculture collapses. Civilisation as we know it ends. The clock reaches zero."
+    color: '#4A0000'
+    darkColor: '#2a0000'
+    reference: 'https://www.pnas.org/doi/10.1073/pnas.2306987120'
+
+  - id: permafrost_feedback
+    name: Permafrost Runaway Feedback
+    icon: "\U0001F321️"
+    tokens: 200000000000000000
+    shortDesc: 200 Quadrillion Tokens
+    description: "Permafrost thaw becomes self-sustaining — no longer stoppable by human action"
+    consequence: >-
+      With 200 quadrillion tokens of AI compute behind us, the permafrost
+      feedback loop is irreversible. Methane and CO₂ now self-release
+      regardless of human emissions reductions. Temperatures rise beyond
+      every modelled scenario.
+    followingEvent: "\U0001F30B Feedback accelerates. Even zero human emissions cannot stop the warming now."
+    color: '#BF360C'
+    darkColor: '#7f240a'
+    reference: 'https://www.nature.com/articles/s41586-018-0807-z'
+
+  - id: monsoon_failure
+    name: Asian Monsoon Failure
+    icon: "\U0001F327️"
+    tokens: 500000000000000000
+    shortDesc: 500 Quadrillion Tokens
+    description: "The Asian monsoon system fails — 3 billion people lose their primary water source"
+    consequence: >-
+      The Asian monsoon delivers 70–90 % of annual rainfall to South and
+      East Asia. Disrupted atmospheric circulation patterns caused by AI's
+      energy emissions collapse this ancient weather system. India, China,
+      and Southeast Asia enter permanent drought.
+    followingEvent: "\U0001F4A7 3 billion people face water crisis. Nuclear-armed states clash over rivers. Mass migrations begin."
+    color: '#1565C0'
+    darkColor: '#0d3d7a'
+
+  - id: civilization_collapse
+    name: "Civilisation’s Last Stand"
+    icon: "\U0001F3D9️"
+    tokens: 1000000000000000000
+    shortDesc: 1 Quintillion Tokens
+    description: Cascading system failures end industrial civilisation as we know it
+    consequence: >-
+      At one quintillion tokens, the cumulative environmental debt has come
+      due. Power grids fail. Supply chains dissolve. Nation-states lose the
+      ability to maintain basic services. The infrastructure that sustains
+      8 billion human lives begins to collapse.
+    followingEvent: "\U0001F311 Lights go out across continents. The age of AI ends not with intelligence, but with silence."
+    color: '#212121'
+    darkColor: '#0a0a0a'
+
+  - id: biosphere_collapse
+    name: Biosphere Collapse
+    icon: "\U0001F311"
+    tokens: 10000000000000000000
+    shortDesc: 10 Quintillion Tokens
+    description: "Earth’s life-support systems fail — the biosphere can no longer sustain complex life"
+    consequence: >-
+      The biosphere — the thin living layer that maintains Earth's
+      temperature, atmosphere, and water cycles — has been pushed past all
+      tipping points. Complex multicellular life can no longer be sustained.
+      Earth enters a new geological epoch defined by absence.
+    followingEvent: "\U0001F573️ The experiment of intelligence on Earth concludes. The planet heals — in 10 million years."
+    color: '#000000'
+    darkColor: '#000000'
diff --git a/package-lock.json b/package-lock.json
index 822652f..dde3faa 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -11,6 +11,7 @@
         "@playwright/test": "^1.59.1",
         "jest": "^29.7.0",
         "jest-environment-jsdom": "^29.7.0",
+        "js-yaml": "^4.1.0",
         "serve": "^14.2.6"
       }
     },
@@ -527,6 +528,30 @@
         "node": ">=8"
       }
     },
+    "node_modules/@istanbuljs/load-nyc-config/node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/@istanbuljs/load-nyc-config/node_modules/js-yaml": {
+      "version": "3.14.2",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
+      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
     "node_modules/@istanbuljs/schema": {
       "version": "0.1.6",
       "resolved": "https://registry.npmjs.org/@istanbuljs/schema/-/schema-0.1.6.tgz",
@@ -1244,14 +1269,11 @@
       "license": "MIT"
     },
     "node_modules/argparse": {
-      "version": "1.0.10",
-      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
-      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
       "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "sprintf-js": "~1.0.2"
-      }
+      "license": "Python-2.0"
     },
     "node_modules/asynckit": {
       "version": "0.4.0",
@@ -3608,14 +3630,13 @@
       "license": "MIT"
     },
     "node_modules/js-yaml": {
-      "version": "3.14.2",
-      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
-      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
+      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
-        "argparse": "^1.0.7",
-        "esprima": "^4.0.0"
+        "argparse": "^2.0.1"
       },
       "bin": {
         "js-yaml": "bin/js-yaml.js"
diff --git a/package.json b/package.json
index e696ab6..e1ae377 100644
--- a/package.json
+++ b/package.json
@@ -7,12 +7,14 @@
     "test": "jest --coverage",
     "test:ci": "jest --ci --coverage",
     "test:e2e": "playwright test",
-    "test:e2e:ui": "playwright test --ui"
+    "test:e2e:ui": "playwright test --ui",
+    "build:milestones": "node scripts/build-milestones.js"
   },
   "devDependencies": {
     "@playwright/test": "^1.59.1",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
+    "js-yaml": "^4.1.0",
     "serve": "^14.2.6"
   },
   "jest": {
diff --git a/script.js b/script.js
index b773c7d..5bd4817 100644
--- a/script.js
+++ b/script.js
@@ -15,6 +15,7 @@
     HISTORICAL_DATA,
     MILESTONES,
     RATE_SCHEDULE,
+    TOKEN_TIPS,
     formatTokenCount,
     formatTokenCountShort,
     getTriggeredMilestones,
@@ -26,6 +27,7 @@
     getTimeDelta,
     milestoneProgress,
     getRateAtDate,
+    calculateTipImpact,
     generateEquivalences,
     calculatePersonalFootprint,
     sessionEquivalences,
@@ -169,7 +171,8 @@
             <div class="progress-fill" style="width:${pct}%"></div>
           </div>
         </div>
-        ${prediction ? `<div class="milestone-predict">⏱ Predicted: ${escHtml(formatDate(prediction))}</div>` : ''}
+        ${prediction ? `<div class="milestone-predict">⏱ Predicted: ${escHtml(formatDate(prediction))} (${escHtml(getTimeDelta(prediction))})</div>` : ''}
+        ${m.reference ? `<a href="${escHtml(m.reference)}" class="milestone-ref" target="_blank" rel="noopener noreferrer">📎 Source</a>` : ''}
       `;
       grid.appendChild(card);
     });
@@ -205,7 +208,9 @@
   function buildChartData() {
     const tokens = getCurrentTokens();
     const historical = HISTORICAL_DATA.map((d) => ({ x: d.date, y: d.tokensT }));
-    const projection = generateProjectionData(tokens, TOKENS_PER_SECOND, 18).map((d) => ({
+    // 60-month projection with 50 % annual growth in token-production rate,
+    // producing the hockey-stick acceleration observed historically.
+    const projection = generateProjectionData(tokens, TOKENS_PER_SECOND, 60, undefined, 0.5).map((d) => ({
       x: d.date,
       y: +d.tokensT.toFixed(2),
     }));
@@ -282,7 +287,7 @@
         scales: {
           x: {
             type: 'time',
-            time: { unit: 'month', tooltipFormat: 'MMM yyyy', displayFormats: { month: 'MMM yy' } },
+            time: { tooltipFormat: 'MMM yyyy', displayFormats: { month: 'MMM yy', year: 'yyyy', quarter: 'MMM yy' } },
             grid: { color: colors.gridColor },
             ticks: { color: colors.tickColor, maxRotation: 45 },
           },
@@ -674,6 +679,37 @@
     lb.rafId = requestAnimationFrame(lbUpdateFrame);
   }
 
+  // ---- Render token-saving tips ---------------------------
+  function renderTips() {
+    const grid = document.getElementById('tipsGrid');
+    if (!grid) return;
+    grid.innerHTML = '';
+
+    TOKEN_TIPS.forEach((tip) => {
+      const card = document.createElement('div');
+      card.className = 'tip-card';
+      card.id = 'tip-' + escHtml(tip.id);
+      const impact = calculateTipImpact(tip.savingPct, 1); // 1 % of global users
+      const savedTokensStr = formatTokenCountShort(impact.tokensPerDay);
+      const savedCo2Str = formatTokenCountShort(impact.co2KgPerDay);
+      card.innerHTML = `
+        <div class="tip-header">
+          <span class="tip-icon" aria-hidden="true">${tip.icon}</span>
+          <div class="tip-title">${escHtml(tip.title)}</div>
+        </div>
+        <p class="tip-text">${escHtml(tip.tip)}</p>
+        <p class="tip-detail">${escHtml(tip.detail)}</p>
+        <div class="tip-impact">
+          If 1&#x202F;% of global users applied this tip:<br>
+          <strong>${escHtml(savedTokensStr)} tokens/day saved</strong> ·
+          <strong>${escHtml(savedCo2Str)} kg CO₂/day avoided</strong>
+        </div>
+        ${tip.reference ? `<a href="${escHtml(tip.reference)}" class="tip-ref" target="_blank" rel="noopener noreferrer">📎 Learn more</a>` : ''}
+      `;
+      grid.appendChild(card);
+    });
+  }
+
   // ============================================================
   // FUN FEATURES
   // ============================================================
@@ -1368,6 +1404,7 @@
     // Render static sections once
     renderMilestones();
     renderPredictionsTable();
+    renderTips();
 
     // Chart init is isolated so a missing date-adapter or other chart error
     // cannot prevent the counters and life-blocks from running.
diff --git a/scripts/build-milestones.js b/scripts/build-milestones.js
new file mode 100644
index 0000000..561ce12
--- /dev/null
+++ b/scripts/build-milestones.js
@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Build script: milestones.yaml → milestones-data.js
+ *
+ * Usage:  node scripts/build-milestones.js
+ *   (also callable via `npm run build:milestones`)
+ *
+ * Reads milestones.yaml from the repo root, validates the data, and writes
+ * milestones-data.js — a dual-export module consumed by both Node.js (tests)
+ * and the browser (loaded via <script> before death-clock-core.js).
+ */
+
+const fs   = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+const ROOT   = path.join(__dirname, '..');
+const SRC    = path.join(ROOT, 'milestones.yaml');
+const DEST   = path.join(ROOT, 'milestones-data.js');
+
+const REQUIRED_FIELDS = [
+  'id', 'name', 'icon', 'tokens', 'shortDesc',
+  'description', 'consequence', 'followingEvent', 'color', 'darkColor',
+];
+
+// ── Load & parse ─────────────────────────────────────────────────────────────
+const raw = fs.readFileSync(SRC, 'utf8');
+const doc = yaml.load(raw);
+
+if (!doc || !Array.isArray(doc.milestones) || doc.milestones.length === 0) {
+  console.error('ERROR: milestones.yaml must contain a non-empty `milestones` array.');
+  process.exit(1);
+}
+
+// ── Validate ──────────────────────────────────────────────────────────────────
+const milestones = doc.milestones;
+
+milestones.forEach((m, i) => {
+  REQUIRED_FIELDS.forEach((f) => {
+    if (m[f] === undefined || m[f] === null) {
+      console.error(`ERROR: milestone[${i}] (id="${m.id}") is missing required field "${f}".`);
+      process.exit(1);
+    }
+  });
+
+  if (typeof m.tokens !== 'number' || m.tokens <= 0) {
+    console.error(`ERROR: milestone[${i}] (id="${m.id}") has invalid tokens value: ${m.tokens}`);
+    process.exit(1);
+  }
+
+  if (i > 0 && m.tokens <= milestones[i - 1].tokens) {
+    console.error(
+      `ERROR: milestones must be in ascending token order. ` +
+      `milestone[${i}] (id="${m.id}", tokens=${m.tokens}) is not greater than ` +
+      `milestone[${i - 1}] (id="${milestones[i - 1].id}", tokens=${milestones[i - 1].tokens}).`
+    );
+    process.exit(1);
+  }
+
+  if (m.reference !== undefined && typeof m.reference !== 'string') {
+    console.error(`ERROR: milestone[${i}] (id="${m.id}") reference must be a string URL.`);
+    process.exit(1);
+  }
+});
+
+// ── Generate JS ───────────────────────────────────────────────────────────────
+function jsString(s) {
+  // Emit as a template-literal-safe single-quoted JS string.
+  // We use JSON.stringify for reliable escaping.
+  return JSON.stringify(String(s));
+}
+
+function renderMilestone(m) {
+  const lines = [
+    '  {',
+    `    id: ${jsString(m.id)},`,
+    `    name: ${jsString(m.name)},`,
+    `    icon: ${jsString(m.icon)},`,
+    `    tokens: ${m.tokens},`,
+    `    shortDesc: ${jsString(m.shortDesc)},`,
+    `    description: ${jsString(m.description)},`,
+    `    consequence: ${jsString(m.consequence)},`,
+    `    followingEvent: ${jsString(m.followingEvent)},`,
+    `    color: ${jsString(m.color)},`,
+    `    darkColor: ${jsString(m.darkColor)},`,
+  ];
+  if (m.reference) {
+    lines.push(`    reference: ${jsString(m.reference)},`);
+  }
+  lines.push('  }');
+  return lines.join('\n');
+}
+
+const body = milestones.map(renderMilestone).join(',\n');
+
+const output = `'use strict';
+// AUTO-GENERATED from milestones.yaml — do not edit directly.
+// Run \`npm run build:milestones\` to regenerate from milestones.yaml.
+
+const MILESTONES = [
+${body},
+];
+
+/* istanbul ignore next */
+if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { MILESTONES };
+} else if (typeof window !== 'undefined') {
+  window.MilestonesData = { MILESTONES };
+}
+`;
+
+fs.writeFileSync(DEST, output, 'utf8');
+console.log(`✅  Written ${milestones.length} milestones to ${path.relative(ROOT, DEST)}`);
diff --git a/styles.css b/styles.css
index bc77e48..79beb5f 100644
--- a/styles.css
+++ b/styles.css
@@ -794,6 +794,101 @@ tr:hover td { background: var(--surface-2); }
   .lb-grid { --lb-block-size: 8px; --lb-gap: 1px; }
   .lb-grid.lb-zoom { --lb-cols: 10; --lb-block-size: 28px; --lb-gap: 3px; }
 }
+/* ---- Token-Saving Tips Section ---- */
+#tips-section { background: var(--bg-alt); }
+
+.tips-intro {
+  color: var(--text-dim);
+  font-size: .9rem;
+  margin-bottom: 1.5rem;
+  line-height: 1.7;
+  max-width: 680px;
+}
+
+.tips-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: 1.2rem;
+  margin-bottom: 2rem;
+}
+
+.tip-card {
+  background: var(--surface);
+  border: 1px solid var(--border);
+  border-radius: 8px;
+  padding: 1.2rem;
+  display: flex;
+  flex-direction: column;
+  gap: .7rem;
+  transition: border-color .2s, box-shadow .2s;
+}
+
+.tip-card:hover {
+  border-color: var(--accent-3);
+  box-shadow: 0 0 12px rgba(0,204,119,.15);
+}
+
+.tip-header {
+  display: flex;
+  align-items: center;
+  gap: .7rem;
+}
+
+.tip-icon {
+  font-size: 1.6rem;
+  flex-shrink: 0;
+}
+
+.tip-title {
+  font-size: 1rem;
+  font-weight: 700;
+  color: var(--accent-3);
+  line-height: 1.3;
+}
+
+.tip-text {
+  font-size: .85rem;
+  color: var(--text);
+  line-height: 1.6;
+}
+
+.tip-detail {
+  font-size: .78rem;
+  color: var(--text-dim);
+  line-height: 1.6;
+}
+
+.tip-impact {
+  font-size: .78rem;
+  color: var(--text-dim);
+  background: var(--surface-2);
+  border-radius: 4px;
+  padding: .5rem .75rem;
+  line-height: 1.7;
+}
+
+.tip-impact strong { color: var(--accent-3); }
+
+.tip-ref {
+  font-size: .75rem;
+  color: var(--accent-4);
+  text-decoration: none;
+  margin-top: auto;
+}
+
+.tip-ref:hover { text-decoration: underline; }
+
+/* ---- Milestone reference links ---- */
+.milestone-ref {
+  display: inline-block;
+  font-size: .75rem;
+  color: var(--accent-4);
+  text-decoration: none;
+  margin-top: .4rem;
+}
+
+.milestone-ref:hover { text-decoration: underline; }
+
 footer {
   text-align: center;
   padding: 2rem 1rem;
diff --git a/tests/death-clock.test.js b/tests/death-clock.test.js
index 373148f..111bd8d 100644
--- a/tests/death-clock.test.js
+++ b/tests/death-clock.test.js
@@ -7,6 +7,7 @@
  */
 
 const core = require('../death-clock-core');
+const milestonesData = require('../milestones-data');
 
 const {
   formatTokenCount,
@@ -20,6 +21,8 @@ const {
   getTimeDelta,
   milestoneProgress,
   getRateAtDate,
+  calculateTipImpact,
+  TOKEN_TIPS,
   generateEquivalences,
   calculatePersonalFootprint,
   sessionEquivalences,
@@ -469,14 +472,36 @@ describe('Browser window export', () => {
     const vm = require('vm');
     const fs = require('fs');
     const path = require('path');
-    const code = fs.readFileSync(path.join(__dirname, '../death-clock-core.js'), 'utf8');
-    // Run in a sandbox where `module` is undefined and `window` is available.
-    // This exercises the `else if (typeof window !== 'undefined')` branch (lines 443-444).
-    const sandboxWindow = {};
-    vm.runInNewContext(code, { window: sandboxWindow });
+    const coreCode = fs.readFileSync(path.join(__dirname, '../death-clock-core.js'), 'utf8');
+    // Run in a sandbox where `module` is undefined and `window` is available,
+    // with MilestonesData pre-loaded so the MILESTONES branch is fully exercised.
+    const sandboxWindow = { MilestonesData: milestonesData };
+    vm.runInNewContext(coreCode, { window: sandboxWindow });
     expect(typeof sandboxWindow.DeathClockCore).toBe('object');
     expect(typeof sandboxWindow.DeathClockCore.formatTokenCount).toBe('function');
   });
+
+  test('MILESTONES loads from window.MilestonesData in browser context', () => {
+    const vm = require('vm');
+    const fs = require('fs');
+    const path = require('path');
+    const coreCode = fs.readFileSync(path.join(__dirname, '../death-clock-core.js'), 'utf8');
+    const sandboxWindow = { MilestonesData: milestonesData };
+    vm.runInNewContext(coreCode, { window: sandboxWindow });
+    expect(Array.isArray(sandboxWindow.DeathClockCore.MILESTONES)).toBe(true);
+    expect(sandboxWindow.DeathClockCore.MILESTONES.length).toBeGreaterThan(0);
+  });
+
+  test('MILESTONES falls back to empty array when MilestonesData is absent', () => {
+    const vm = require('vm');
+    const fs = require('fs');
+    const path = require('path');
+    const coreCode = fs.readFileSync(path.join(__dirname, '../death-clock-core.js'), 'utf8');
+    const sandboxWindow = {};
+    vm.runInNewContext(coreCode, { window: sandboxWindow });
+    expect(Array.isArray(sandboxWindow.DeathClockCore.MILESTONES)).toBe(true);
+    expect(sandboxWindow.DeathClockCore.MILESTONES.length).toBe(0);
+  });
 });
 
 // ============================================================
@@ -609,6 +634,194 @@ describe('Extended MILESTONES', () => {
   });
 });
 
+// ============================================================
+// getTimeDelta — hours/minutes/seconds granularity
+// ============================================================
+describe('getTimeDelta sub-day granularity', () => {
+  const now = new Date('2026-01-01T00:00:00Z');
+
+  test('returns hours for a 3-hour future date', () => {
+    const future = new Date(now.getTime() + 3 * 60 * 60 * 1000);
+    const result = getTimeDelta(future, now);
+    expect(result).toMatch(/hour/);
+  });
+
+  test('returns singular hour for exactly 1 hour', () => {
+    const future = new Date(now.getTime() + 1 * 60 * 60 * 1000);
+    expect(getTimeDelta(future, now)).toBe('in ~1 hour');
+  });
+
+  test('returns minutes for a 45-minute future', () => {
+    const future = new Date(now.getTime() + 45 * 60 * 1000);
+    expect(getTimeDelta(future, now)).toMatch(/minute/);
+  });
+
+  test('returns singular minute for exactly 1 minute', () => {
+    const future = new Date(now.getTime() + 60 * 1000);
+    expect(getTimeDelta(future, now)).toBe('in ~1 minute');
+  });
+
+  test('returns seconds for a 30-second future', () => {
+    const future = new Date(now.getTime() + 30 * 1000);
+    expect(getTimeDelta(future, now)).toMatch(/second/);
+  });
+
+  test('returns singular second for exactly 1 second', () => {
+    const future = new Date(now.getTime() + 1000);
+    expect(getTimeDelta(future, now)).toBe('in ~1 second');
+  });
+});
+
+// ============================================================
+// generateProjectionData — exponential growth
+// ============================================================
+describe('generateProjectionData with annualGrowthRate', () => {
+  const now = new Date('2026-01-01T00:00:00Z');
+
+  test('linear (growth=0) produces same result as before', () => {
+    const linear = generateProjectionData(0, 1_000_000, 12, now, 0);
+    expect(linear.length).toBe(13);
+    // Last point is 12 months of constant rate
+    const lastLinear = linear[linear.length - 1].tokensT;
+    expect(lastLinear).toBeGreaterThan(0);
+  });
+
+  test('exponential produces larger values than linear over same period', () => {
+    const linear = generateProjectionData(0, 1_000_000, 12, now, 0);
+    const expo   = generateProjectionData(0, 1_000_000, 12, now, 0.5);
+    const lastLinear = linear[linear.length - 1].tokensT;
+    const lastExpo   = expo[linear.length - 1].tokensT;
+    expect(lastExpo).toBeGreaterThan(lastLinear);
+  });
+
+  test('first data point is the same regardless of growth rate', () => {
+    const linear = generateProjectionData(1e15, 1_000_000, 6, now, 0);
+    const expo   = generateProjectionData(1e15, 1_000_000, 6, now, 1.0);
+    expect(linear[0].tokensT).toBeCloseTo(expo[0].tokensT, 2);
+  });
+
+  test('values are monotonically increasing with exponential growth', () => {
+    const data = generateProjectionData(0, 1_000_000, 6, now, 0.5);
+    for (let i = 1; i < data.length; i++) {
+      expect(data[i].tokensT).toBeGreaterThan(data[i - 1].tokensT);
+    }
+  });
+
+  test('negative annualGrowthRate is treated as linear (0)', () => {
+    const result = generateProjectionData(0, 1_000_000, 3, now, -0.5);
+    // Should still return data without errors
+    expect(result.length).toBe(4);
+    result.forEach((d) => expect(typeof d.tokensT).toBe('number'));
+  });
+});
+
+// ============================================================
+// calculateTipImpact
+// ============================================================
+describe('calculateTipImpact', () => {
+  test('returns zeros for invalid savingPct', () => {
+    const r = calculateTipImpact('bad', 10);
+    expect(r.tokensPerDay).toBe(0);
+    expect(r.kWhPerDay).toBe(0);
+  });
+
+  test('returns zeros for invalid percentOfUsers', () => {
+    const r = calculateTipImpact(50, 'bad');
+    expect(r.tokensPerDay).toBe(0);
+  });
+
+  test('returns zeros for negative savingPct', () => {
+    const r = calculateTipImpact(-10, 5);
+    expect(r.tokensPerDay).toBe(0);
+  });
+
+  test('returns zeros for negative percentOfUsers', () => {
+    const r = calculateTipImpact(50, -1);
+    expect(r.tokensPerDay).toBe(0);
+  });
+
+  test('positive values for valid inputs', () => {
+    const r = calculateTipImpact(30, 1);
+    expect(r.tokensPerDay).toBeGreaterThan(0);
+    expect(r.kWhPerDay).toBeGreaterThan(0);
+    expect(r.co2KgPerDay).toBeGreaterThan(0);
+    expect(r.waterLPerDay).toBeGreaterThan(0);
+  });
+
+  test('scales linearly with percentOfUsers', () => {
+    const r1 = calculateTipImpact(30, 1);
+    const r2 = calculateTipImpact(30, 2);
+    expect(r2.tokensPerDay).toBeCloseTo(r1.tokensPerDay * 2, 0);
+  });
+
+  test('scales linearly with savingPct', () => {
+    const r1 = calculateTipImpact(10, 1);
+    const r2 = calculateTipImpact(20, 1);
+    expect(r2.tokensPerDay).toBeCloseTo(r1.tokensPerDay * 2, 0);
+  });
+
+  test('caps savingPct at 100', () => {
+    const r100 = calculateTipImpact(100, 1);
+    const r200 = calculateTipImpact(200, 1);
+    expect(r100.tokensPerDay).toBeCloseTo(r200.tokensPerDay, 0);
+  });
+
+  test('caps percentOfUsers at 100', () => {
+    const r100 = calculateTipImpact(30, 100);
+    const r200 = calculateTipImpact(30, 200);
+    expect(r100.tokensPerDay).toBeCloseTo(r200.tokensPerDay, 0);
+  });
+
+  test('uses custom ratePerSec when provided', () => {
+    const r = calculateTipImpact(100, 100, 1);
+    // 1 token/sec * 86400 sec * 100% saving * 100% users = 86400 tokens
+    expect(r.tokensPerDay).toBeCloseTo(86400, 0);
+  });
+
+  test('falls back to TOKENS_PER_SECOND when ratePerSec is invalid', () => {
+    const rDefault = calculateTipImpact(10, 1);
+    const rExplicit = calculateTipImpact(10, 1, TOKENS_PER_SECOND);
+    expect(rDefault.tokensPerDay).toBeCloseTo(rExplicit.tokensPerDay, 0);
+  });
+});
+
+// ============================================================
+// TOKEN_TIPS
+// ============================================================
+describe('TOKEN_TIPS', () => {
+  test('is a non-empty array', () => {
+    expect(Array.isArray(TOKEN_TIPS)).toBe(true);
+    expect(TOKEN_TIPS.length).toBeGreaterThan(0);
+  });
+
+  test('each tip has required fields', () => {
+    TOKEN_TIPS.forEach((tip) => {
+      expect(typeof tip.id).toBe('string');
+      expect(typeof tip.icon).toBe('string');
+      expect(typeof tip.title).toBe('string');
+      expect(typeof tip.tip).toBe('string');
+      expect(typeof tip.detail).toBe('string');
+      expect(typeof tip.savingPct).toBe('number');
+      expect(tip.savingPct).toBeGreaterThan(0);
+      expect(tip.savingPct).toBeLessThanOrEqual(100);
+    });
+  });
+
+  test('all tip ids are unique', () => {
+    const ids = TOKEN_TIPS.map((t) => t.id);
+    expect(new Set(ids).size).toBe(ids.length);
+  });
+
+  test('optional reference field is a string URL when present', () => {
+    TOKEN_TIPS.forEach((tip) => {
+      if (tip.reference !== undefined) {
+        expect(typeof tip.reference).toBe('string');
+        expect(tip.reference).toMatch(/^https?:\/\//);
+      }
+    });
+  });
+});
+
 // ============================================================
 // generateEquivalences
 // ============================================================
diff --git a/tests/script.test.js b/tests/script.test.js
index 4d2e5eb..98a1704 100644
--- a/tests/script.test.js
+++ b/tests/script.test.js
@@ -34,6 +34,7 @@ const MIN_HTML = `
   <nav id="lb-breadcrumb"></nav>
   <div id="lb-info"></div>
   <div id="lb-container"></div>
+  <div id="tipsGrid"></div>
 `;
 
 function makeChartMock() {
@@ -253,3 +254,31 @@ describe('escHtml (via rendered DOM output)', () => {
     expect(document.getElementById('milestonesGrid').innerHTML).not.toContain('<script>');
   });
 });
+
+// ============================================================
+// renderTips (DOM)
+// ============================================================
+describe('renderTips (DOM)', () => {
+  test('creates a card for each TOKEN_TIP', () => {
+    const grid = document.getElementById('tipsGrid');
+    expect(grid).not.toBeNull();
+    expect(grid.children.length).toBe(coreModule.TOKEN_TIPS.length);
+  });
+
+  test('each tip card has the expected id', () => {
+    coreModule.TOKEN_TIPS.forEach((tip) => {
+      expect(document.getElementById('tip-' + tip.id)).not.toBeNull();
+    });
+  });
+
+  test('tip grid HTML does not contain unescaped script tags', () => {
+    expect(document.getElementById('tipsGrid').innerHTML).not.toContain('<script>');
+  });
+
+  test('tip cards contain the tip title text', () => {
+    const grid = document.getElementById('tipsGrid');
+    coreModule.TOKEN_TIPS.forEach((tip) => {
+      expect(grid.innerHTML).toContain(tip.title);
+    });
+  });
+});