From b02a850ae0d51cbbbcb1fdaab100318ee7d41c67 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 15 May 2026 12:01:20 +0200
Subject: [PATCH 1/8] =?UTF-8?q?feat(landing):=20apply=20Mobbin=20UX=20patt?=
 =?UTF-8?q?erns=20=E2=80=94=20hero=20CTAs,=20install=20$-prefix,=20countup?=
 =?UTF-8?q?=20stats,=20changelog?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Hero: replace Star CTA with Docs ghost CTA (/guide/)
- Hero: update stars fallback 31k → 47k
- Hero: add countUp animation (IntersectionObserver + rAF) on 3 stat values
- Install: add $ prompt prefix on code blocks via CSS ::before
- Add /changelog page with type-coloured badges (accent/cyan/violet) and RSS feed button
- Add doc/research/mobbin-ui-patterns.md (2 sessions, 12 actionable patterns)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 doc/research/mobbin-ui-patterns.md | 270 +++++++++++++++++++++++++++++
 src/components/landing/Hero.astro  |  56 +++++-
 src/pages/changelog/index.astro    | 182 +++++++++++++++++++
 src/styles/landing.css             |   5 +
 4 files changed, 506 insertions(+), 7 deletions(-)
 create mode 100644 doc/research/mobbin-ui-patterns.md
 create mode 100644 src/pages/changelog/index.astro

diff --git a/doc/research/mobbin-ui-patterns.md b/doc/research/mobbin-ui-patterns.md
new file mode 100644
index 0000000..f9ce480
--- /dev/null
+++ b/doc/research/mobbin-ui-patterns.md
@@ -0,0 +1,270 @@
+# Recherche Mobbin — Patterns UI/UX pour RTK landing
+
+**Date** : 2026-05-14
+**Périmètre** : Landing rtk-ai.app (/, section Hero, Install, Demo)
+**Source** : Mobbin via MCP `mcp__mobbin__search_screens` (mode fast, platform web)
+**Scope OUT** : Social proof, comparisons, docs UX, changelog, sub-product Vox/ICM (voir sessions 2-3)
+
+## Limites Mobbin observées
+
+Mobbin couvre bien les **SaaS developer tools web** (Resend, Neon, Modal, AWS) mais pas les landing pages CLI pur (Bun, Warp, Homebrew). Les patterns de terminal asciinema n'apparaissent pas. Les résultats sont utiles mais restent dans le registre "API platform" plutôt que "CLI proxy". Pour chaque thème, 3-5 screens sur 8 étaient pertinents.
+
+---
+
+## Thème 1 — Hero CLI / dev tool landing
+
+**Queries** : `"developer tool landing hero CLI install"` — 5 résultats utiles / 8
+
+### Top 3 screens (design engineer pass)
+
+**Resend** — [mobbin.com/screens/72bd36ac...](https://mobbin.com/screens/72bd36ac-0d76-4f93-b5a2-1a73afb92d92)
+Fond noir (#0a0a0a), typographie serif display très grande ("Email for developers"), texte gauche-aligné, visuel 3D droit (cube géométrique animé). Nav plate avec 7 items + 2 CTAs à droite (filled "Get Started" + ghost "Documentation"). Décision UX clé : le lien vers la doc est en ghost CTA au même niveau que le CTA commercial, ce qui réduit la friction pour les devs qui veulent explorer avant d'acheter.
+
+**AutoSend** — [mobbin.com/screens/1f4da970...](https://mobbin.com/screens/1f4da970-2f42-4d98-95fd-684378cfc617)
+Layout left-text / right-illustration, headline "Email for Developers, Marketers, & AI Agents", sous-headline 1 ligne, 2 CTAs (SIGN UP rempli + TALK TO FOUNDERS ghost). En dessous du fold : compteur live temps-réel ("795,110 emails sent in the last 7 days") + logo strip clients. La métrique live est un signal de preuve très dense en un seul chiffre — évite la liste de features.
+
+**Vapi** — [mobbin.com/screens/c960e4d4...](https://mobbin.com/screens/c960e4d4-12cc-4211-ac97-83136a5c152f)
+"Voice AI agents for developers", headline centré, fond noir, animation equalizer sonore en arrière-plan (représente visuellement ce que fait le produit). Bouton central "TALK TO VAPI" = CTA qui EST la démo. Logo strip clients sous le fold. Le background animé remplace le screenshot produit — zéro bruit, tout dit en 4 mots + animation.
+
+### Patterns actionnables pour RTK
+
+1. **Ghost CTA "Docs" au même niveau que le CTA commercial**
+   Le hero RTK a actuellement le bouton principal (install) sans lien docs équivalent. Ajouter un ghost CTA "Read the docs" ou "See the guide" aligné avec le CTA principal réduit la friction des devs qui préfèrent lire avant d'agir.
+   Référence : `src/pages/index.astro` section Hero (CTA block)
+   Effort : XS
+
+2. **Métrique live comme seul proof-point au-dessus de la section preuve**
+   Au lieu d'attendre la section Proof, mettre une métrique chiffrée sous le hero immédiat : "X tokens saved today" ou "X% reduction mesurée sur cargo test". Un seul chiffre, en variant (--text-muted), en dessous des CTAs.
+   Référence : `src/pages/index.astro` juste sous le hero, avant la section Problem
+   Effort : S (nécessite décision sur quelle métrique afficher)
+
+3. **Animation de fond qui REPRÉSENTE la valeur (pas juste décore)**
+   RTK compresse des outputs. L'animation de fond pourrait montrer du texte/tokens qui "disparaissent" ou "se condensent" — plutôt qu'une illustration décorative. Coût : CSS ou canvas léger.
+   Référence : `src/pages/index.astro` section Hero, `src/styles/landing.css`
+   Effort : M (conception + implémentation CSS/canvas)
+
+### Patterns à éviter
+
+- **Illustration 3D générique côté droit** : les cubes et sphères 3D (Resend, Google AI Studio) sont indifférenciés sur le segment dev tools en 2026. Si RTK n'a pas d'asset visuel fort, mieux vaut du texte/terminal pur qu'un asset 3D banal.
+- **Headline "for developers" générique** : "Email for developers", "Voice AI for developers" — le segment dev tools est saturé de ce pattern. RTK doit ancrer immédiatement sur la valeur mesurée : -60-90% tokens, pas "for developers".
+
+### Questions ouvertes
+- La métrique "tokens saved" est-elle mesurable en temps réel ou seulement comme benchmark ? Si pas de données live, quelle métrique fixe utiliser (nb downloads, nb cmds exécutées avec rtk gain)?
+
+---
+
+## Thème 2 — Install / copy-paste blocks
+
+**Queries** : `"install command code block copy button developer"` — 5 résultats utiles / 8
+
+### Top 3 screens (design engineer pass)
+
+**Neon** — [mobbin.com/screens/94fb6fc0...](https://mobbin.com/screens/94fb6fc0-0fb0-4358-b6da-534a1f5addb9)
+Quickstart multi-étapes dans un panel modal. Étape "Start your app" montre 4 tabs (npm / yarn / bun / **pnpm** actif + soulignement) avec le code dans le bloc en dessous et une icône copy à droite de la commande. Fond de bloc : légèrement grisé (#f5f5f5). La tab active est soulignée, pas en filled-pill. Décision UX clé : les package manager tabs sont un composant discret (juste des textes + underline), pas des boutons — réduction maximale du bruit visuel autour de la commande.
+
+**Modal** — [mobbin.com/screens/1052aa52...](https://mobbin.com/screens/1052aa52-940d-4600-b211-d2bac1cdf7fa)
+Onboarding "Create your first app" avec accordion numéroté (1, 2). Étape 1 dépliée montre un bloc terminal dark (`#1a1a1a`) avec 2 commandes préfixées `$` en vert clair + fond sombre. La commande suit naturellement la prose d'explication. Décision UX : numéroter les étapes + accordions déroule la complexité sans l'afficher d'un coup — anti-anxiété pour un premier contact.
+
+**Apollo** — [mobbin.com/screens/50326c28...](https://mobbin.com/screens/50326c28-ee66-41be-baf7-69b3417f38eb)
+"Add the Apollo code snippet" : grand bloc code fond blanc + bordure légère, bouton **Copy** texte simple en bas à droite du bloc. Section "How to install?" en accordéon juste dessous avec 5 étapes numérotées en prose. Le Copy button est placé DANS le bloc, pas flottant — il appartient au bloc visuellement.
+
+### Patterns actionnables pour RTK
+
+1. **Package manager tabs (brew / cargo / npm) avec underline actif, pas boutons**
+   RTK a 3 méthodes d'install. Le pattern Neon (tabs texte + underline actif) est plus élégant que des pills-buttons. Le bloc de commande change selon la tab active (JS simple, pas de lib). Copy icon à droite de chaque commande.
+   Référence : `src/pages/index.astro` section Install, `src/styles/landing.css`
+   Effort : S
+
+2. **Bloc terminal dark avec préfixe `$` en couleur accent**
+   Le fond du bloc install doit être sombre (`var(--bg-card)` minimum, idéalement plus sombre type `#0a0f1e`) avec le `$` en `var(--accent)` (#00e599) et la commande en `var(--text)`. Distingue clairement ce qui est à taper de ce qui est output.
+   Référence : `src/pages/index.astro` section Install, `src/styles/global.css` tokens déjà en place
+   Effort : XS
+
+3. **Copy button natif dans le bloc (pas flottant)**
+   Positionner l'icône copy comme élément du bloc (padding-right du bloc), pas en position:absolute flottant. Sur hover du bloc, copy apparaît. Au click : icône switch vers ✓ pendant 1.5s, puis retour. Pas de toast "Copied!" — le changement d'icône suffit.
+   Référence : `src/pages/index.astro`, `src/styles/landing.css`
+   Effort : S
+
+### Patterns à éviter
+
+- **Bloc code trop large avec du code applicatif** (Apollo) : RTK affiche 1 commande, pas 40 lignes de JavaScript. Ne pas grossir le bloc pour "faire professionnel" — la concision EST le produit.
+- **Tabs en pills/filled-buttons** : crée du bruit autour de la commande principale. L'eye-tracking va sur les boutons, pas sur la commande.
+
+### Questions ouvertes
+- Afficher 1 seule tab par défaut (brew sur macOS) avec détection UA ? Ou toujours montrer les 3 tabs sans détection ?
+- Le hook CI (GitHub Actions) mérite-t-il sa propre tab ou une section séparée dans la doc ?
+
+---
+
+## Thème 3 — Terminal demos web
+
+**Queries** : `"terminal animation demo developer tool landing"` — 4 résultats utiles / 8
+**Limites observées** : Aucun résultat montrant un vrai terminal asciinema ou CLI animated capture. Mobbin couvre des demos interactifs produit, pas des replays de sessions shell.
+
+### Top 3 screens (design engineer pass)
+
+**AWS Lambda** — [mobbin.com/screens/ccc2e1c7...](https://mobbin.com/screens/ccc2e1c7-2a2c-430d-8a72-d9085e2f1646)
+Section "How it works" avec tabs runtime (.NET / Java / **Node.js** actif / Python / Ruby / Custom). Bloc code statique en dessous avec numéros de ligne. Bouton "Run" en accent orange + "Next: Lambda responds to events" enchaîné. Décision UX : la démo n'est pas dans le hero — elle est dans une section dédiée plus bas. Le hero vend, la section "How it works" prouve. Séparation claire des rôles.
+
+**ElevenLabs** — [mobbin.com/screens/1a733d7d...](https://mobbin.com/screens/1a733d7d-6f0c-4671-9570-90220cff2c82)
+Produit-dans-le-hero : interface voix interactive directement dans la landing (text input + liste de voix + bouton Play). Le produit EST la démo, instantanément. Tabs produits en haut (ElevenCreative / ElevenAgents) + context "Text to Speech" en haut à droite. Décision UX audacieuse : zéro friction pour tester, mais nécessite un produit qui fonctionne côté serveur live.
+
+**Codecademy** — [mobbin.com/screens/01dbfb5f...](https://mobbin.com/screens/01dbfb5f-536a-4770-b9d7-2f752d10913b)
+Split-pane éditeur : code à gauche (dark, syntaxe colorée, tabs fichiers) + preview navigateur à droite. Bouton "Save + Run" en accent jaune, centré en bas. Pattern classique learn-by-doing : le code ET son résultat visible simultanément. Adapté à l'apprentissage, pas directement à une landing CLI.
+
+### Patterns actionnables pour RTK
+
+1. **Section "How it works" avec mode tabs (avant/après ou par commande type)**
+   Plutôt qu'une animation terminal full-auto, créer une section "Before / After RTK" avec 2 panels statiques : gauche = `cargo test` raw output (200 lignes), droite = `rtk cargo test` output condensé (5 lignes). Tabs par type de commande (git / cargo / gh). Click sur un tab remplace les deux panels. Zéro animation requise, impact maximal sur la valeur perçue.
+   Référence : `src/pages/index.astro` section Demo, `src/styles/landing.css`
+   Effort : S/M
+
+2. **Séparation hero (vend) / section demo (prouve)**
+   AWS Lambda le fait bien : le hero est une accroche value prop, la démo est 2 sections plus bas. RTK a tendance à vouloir tout montrer above the fold. Laisser la section Demo en dessous de la section Problem (pas dans le hero) allège le hero et donne à la démo l'espace pour respirer.
+   Référence : `src/pages/index.astro` (ordre des sections)
+   Effort : XS (réorganisation, pas code)
+
+3. **Animation CSS lightweight "token counter" plutôt que terminal replay**
+   Un compteur de tokens qui diminue (ex: 15,000 → 1,200) avec une transition CSS `counter()` ou `countUp.js` est plus léger, plus lisible, et plus percutant qu'un replay de session shell. L'animation dure 2s, se rejoue au scroll-into-view. Poids < 2KB.
+   Référence : `src/pages/index.astro` section Demo ou Hero, `src/styles/landing.css`
+   Effort : S
+
+### Patterns à éviter
+
+- **Produit-dans-le-hero style ElevenLabs** : nécessite un backend live capable d'exécuter RTK. Risque de latence, de coût serveur, et de fallback horrible si ça freeze. Pour une CLI tool, le risque dépasse le bénéfice.
+- **Terminal replay GIF autoplay** : les GIFs >200KB ralentissent LCP (Core Web Vitals). Si on utilise un replay, c'est une vidéo `<video autoplay muted loop>` < 500KB WebP/H264, pas un GIF.
+- **Split-pane éditeur interactif** (Codecademy) : sur-engineering pour une landing page d'un outil CLI. La valeur RTK est dans la réduction d'output, pas dans l'édition de code.
+
+### Questions ouvertes
+- La section Demo actuelle utilise-t-elle déjà un GIF ou une vidéo ? Vérifier le poids dans `public/assets/` avant de choisir la technique.
+- Le "before/after" est-il reproductible automatiquement à chaque release (extrait du vrai output RTK) ou manuel ?
+
+---
+
+## Session 2 : Social proof, Comparaisons, Changelog
+
+---
+
+## Thème 4 — Social proof / community trust
+
+**Queries** : `"github stars badge developer tool homepage"` (2 résultats pertinents / 8, réinterprétés OAuth) puis `"developer testimonial community size trust landing page"` (4 résultats pertinents / 8)
+**Limites observées** : Le terme "github" déclenche majoritairement des résultats d'intégration GitHub OAuth (Clay, Fibery, Felt) au lieu de badges social proof sur landing pages. Mobbin insuffisant pour ce thème, 2 reformulations épuisées.
+
+### Références Session 1 applicables
+
+Chatbase (logo strip + compteur "2M+ chatbots"), Vapi (strip désaturé sous CTA), et Resend ("Join 200,000+ developers" dans le sous-headline) sont déjà analysés en Thème 1. Les 3 patterns s'appliquent à la preuve sociale RTK.
+
+### Patterns actionnables pour RTK
+
+1. **Compteur de downloads build-time sous les CTAs hero**
+   Cargo.io et Homebrew exposent des chiffres en build-time. Format : "Used by X developers" en `var(--text-muted)`. Sous 1000 downloads, afficher "Early adopters" plutôt qu'un chiffre. Valeur statique au build, pas de requête HTTP en runtime.
+   Référence : `src/pages/index.astro` section Hero (sous le CTA block)
+   Effort : S
+
+2. **Logo strip désaturé si noms connus disponibles**
+   4-6 avatars GitHub de devs connus, désaturés. Si les utilisateurs connus sont absents, sauter ce pattern (un strip d'inconnus détruit la crédibilité).
+   Référence : `src/pages/index.astro` section Proof
+   Effort : XS (si noms connus disponibles)
+
+### Patterns à éviter
+
+- **Badge shield.io GitHub stars** : requête externe non cachée, LCP impact. Si on affiche les stars, valeur statique build-time.
+- **Citations longues avec avatars** : RTK n'a pas encore de corpus de testimonials suffisant pour ce pattern.
+
+---
+
+## Thème 5 — Comparison tables / before-after
+
+**Queries** : `"before after comparison table developer tool landing"` (4 résultats pertinents / 8)
+**Limites observées** : Résultats majoritairement tables de pricing ou diff viewers internes. Tables "avant/après ROI" peu représentées dans Mobbin.
+
+### Top 3 screens (design engineer pass)
+
+**Google Workspace** — "CURRENT EDITION / SWITCH TO" : 2 colonnes côte à côte. Colonne gauche fond neutre, colonne droite fond légèrement accentué avec outline coloré. Chaque ligne = une feature, check ou cross. L'asymétrie visuelle guide le regard sans caption explicatif. Applicable directement pour "Sans RTK / Avec RTK".
+
+**Neon** — "Compare plans" avec lignes alternées légèrement teintées. Features différenciatrices en gras, identiques en check simple. Réduit la charge cognitive en mettant en évidence uniquement ce qui change.
+
+**Linear** — 2 panels "before / after" côte à côte + flèche centrale. La direction temporelle est imposée visuellement sans caption.
+
+### Patterns actionnables pour RTK
+
+1. **Panel "Sans RTK / Avec RTK" à 2 colonnes, fond asymétrique**
+   Gauche : `cargo test` raw output (200 lignes, scrollable, texte en `var(--text-dim)`). Droite : `rtk cargo test` (5 lignes, texte en `var(--text)`, bordure `1px solid var(--accent)`). Label "Avant / Après" en `var(--text-muted)` au-dessus de chaque panel.
+   Référence : `src/pages/index.astro` section Demo, `src/styles/landing.css`
+   Effort : S
+
+2. **Badge de réduction en overlay sur le panel droit**
+   "-90% tokens" en badge centré sur la bordure haute du panel droit, fond `var(--bg-card)`, texte `var(--accent)`. Zéro prose requise pour expliquer la valeur, le chiffre se lit seul.
+   Référence : `src/pages/index.astro` section Demo
+   Effort : XS
+
+### Patterns à éviter
+
+- **Feature table RTK vs commandes brutes** : RTK n'a pas de tiers de fonctionnalités. L'output réduit est le seul différenciateur réel, le before/after le montre mieux qu'un tableau.
+
+---
+
+## Thème 7 — Changelog / release notes UX
+
+**Queries** : `"changelog release notes developer tool product updates"` (4 résultats pertinents / 8)
+**Limites observées** : 4/8 résultats étaient des UIs de version history pour restauration de documents (Manus, WRITER, Substack), pas des changelogs publics. Pattern sous-représenté dans Mobbin.
+
+### Top 3 screens (design engineer pass)
+
+**GitBook** — Page "Changelog" dans la nav docs. Heading "Changelog", sous-titre "New updates and improvements", bouton "RSS feed" visible en haut à droite (pas enfoui dans les settings). Entrées par date, chaque entrée avec sous-titre de type ("Product feature") et CTA "Read the documentation". Le changelog est une page ordinaire de la doc, navigable comme toutes les autres. Pour RTK, c'est le pattern le plus proche de `rss-entries.ts` + Starlight.
+
+**Suno** — Modal "What's New?" avec badges de type colorés ("New Feature"), date, description courte, lien "Learn more". Le format badge type + date + description + lien est réutilisable dans une page `/changelog` statique même si le modal in-app ne s'applique pas à une CLI.
+
+### Patterns actionnables pour RTK
+
+1. **Page `/changelog` dans Starlight avec bouton RSS visible**
+   RTK a déjà `src/data/rss-entries.ts` qui alimente `/rss.xml`. Ce qui manque est une page lisible par un humain. Créer une page Starlight qui liste les entrées avec format : date | badge-type | description | lien, avec un lien "RSS feed" visible en haut (href vers `/rss.xml`).
+   Référence : `src/data/rss-entries.ts`, `astro.config.mjs` (sidebar Starlight), `src/content/docs/`
+   Effort : S/M
+
+2. **Badges de type colorés dans les entrées changelog**
+   `release` en `var(--accent)`, `new_feature` en `var(--cyan)`, `performance` en `var(--violet)`. Cohérent avec les tokens produits existants. Rend le scanning rapide sans lire chaque description.
+   Référence : `src/data/rss-entries.ts` (champ `type`), `src/styles/global.css`
+   Effort : XS
+
+### Patterns à éviter
+
+- **Modal "What's New?" in-app** : RTK est un CLI, aucune surface in-app pour ce type de notification.
+- **Version history UI** (Manus, WRITER, Lovable) : restauration de documents, pas un changelog public produit.
+
+---
+
+## Synthèse : 12 patterns P1 (Sessions 1 et 2)
+
+### Session 1 : Hero, Install, Demo
+
+| # | Pattern | Section | Effort | Impact |
+|---|---------|---------|--------|--------|
+| 1 | Ghost CTA "Docs" aligné avec le CTA principal | Hero | XS | Réduit friction dev |
+| 2 | Bloc terminal dark, $ en --accent, copy in-bloc | Install | XS | Clarté + confiance |
+| 3 | Package manager tabs (brew/cargo/npm) underline style | Install | S | Réduit confusion install |
+| 4 | Before/after output panels + mode tabs | Demo | S/M | Prouve la valeur immédiatement |
+| 5 | Séparation hero (vend) / demo (prouve) — ordre sections | Structure | XS | Allège le hero |
+| 6 | Compteur token animé CSS au scroll | Demo ou Hero | S | Impact visuel fort, poids nul |
+
+### Session 2 : Social proof, Comparaisons, Changelog
+
+| # | Pattern | Section | Effort | Impact |
+|---|---------|---------|--------|--------|
+| 7 | Compteur downloads build-time sous les CTAs hero | Hero | S | Preuve sociale sans requête externe |
+| 8 | Logo strip désaturé si devs connus disponibles | Hero/Proof | XS | Crédibilité sans bruit visuel |
+| 9 | Panel before/after 2 colonnes fond asymétrique + tabs | Demo | S | Valeur mesurée visuellement évidente |
+| 10 | Badge "-90% tokens" overlay panel droit | Demo | XS | Chiffre sans prose |
+| 11 | Page /changelog Starlight avec lien RSS exposé | Docs | S/M | Distribution et rétention utilisateurs |
+| 12 | Badges type colorés (release/feature/perf) dans changelog | Changelog | XS | Scanning rapide de l'historique |
+
+---
+
+## Références complémentaires (liste plate)
+
+- Resend hero: https://mobbin.com/screens/72bd36ac-0d76-4f93-b5a2-1a73afb92d92 — dark hero for devs, ghost docs CTA
+- Google AI Studio code panel: https://mobbin.com/screens/7bdd4070-16aa-4056-bf9e-11add8bd2e35 — language selector + copy UX
+- Felt API tokens: https://mobbin.com/screens/f32e50c7-20dd-4feb-bfed-21d748a991b3 — copy-token modal pattern
+- Vapi hero: https://mobbin.com/screens/c960e4d4-12cc-4211-ac97-83136a5c152f — animation background = product value
+- Chatbase hero: https://mobbin.com/screens/a4425cb6-c493-43b8-aa1a-14898a35ccaf — logo strip + animated product preview
+- Savee multi-install: https://mobbin.com/screens/a4425cb6-c493-43b8-aa1a-14898a35ccaf — 4 platform buttons in a row
diff --git a/src/components/landing/Hero.astro b/src/components/landing/Hero.astro
index decadc5..c31ae55 100644
--- a/src/components/landing/Hero.astro
+++ b/src/components/landing/Hero.astro
@@ -7,7 +7,7 @@ interface Props {
 }
 const { lang } = Astro.props
 
-let stars = 31000
+let stars = 47000
 
 try {
   const headers: Record<string, string> = { 'User-Agent': 'rtk-landing' }
@@ -22,6 +22,9 @@ try {
 } catch {}
 
 const starsLabel = stars >= 1000 ? `${(stars / 1000).toFixed(1)}k` : String(stars)
+const countupStars = stars >= 1000 ? (stars / 1000).toFixed(1) : String(stars)
+const starsDecimals = stars >= 1000 ? '1' : '0'
+const starsSuffix = stars >= 1000 ? 'k' : ''
 ---
 <section class="hero">
   <div class="hero-inner">
@@ -40,26 +43,25 @@ const starsLabel = stars >= 1000 ? `${(stars / 1000).toFixed(1)}k` : String(star
 
       <div class="hero-stats">
         <div class="stat">
-          <span class="stat-value">89%</span>
+          <span class="stat-value" data-countup="89" data-suffix="%">89%</span>
           <span class="stat-label">avg noise removed</span>
         </div>
         <div class="stat-sep"></div>
         <div class="stat">
-          <span class="stat-value">2,900+</span>
+          <span class="stat-value" data-countup="2900" data-suffix="+" data-comma>2,900+</span>
           <span class="stat-label">commands measured</span>
         </div>
         <div class="stat-sep"></div>
         <div class="stat">
-          <span class="stat-value" id="github-stars-count">{starsLabel}</span>
+          <span class="stat-value" id="github-stars-count" data-countup={countupStars} data-suffix={starsSuffix} data-decimal={starsDecimals}>{starsLabel}</span>
           <span class="stat-label">GitHub stars</span>
         </div>
       </div>
 
       <div class="hero-cta">
         <a href="#install" class="btn btn-primary">{t('hero.cta_install', lang)}</a>
-        <a href="https://github.com/rtk-ai/rtk" class="btn btn-ghost" target="_blank" rel="noopener">
-          <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true"><polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/></svg>
-          <span>{t('hero.cta_star', lang)}</span>
+        <a href="/guide/" class="btn btn-ghost">
+          {t('ui.nav_docs', lang)}
         </a>
       </div>
     </div>
@@ -123,6 +125,46 @@ const starsLabel = stars >= 1000 ? `${(stars / 1000).toFixed(1)}k` : String(star
   </div>
 </section>
 
+<script>
+  const els = document.querySelectorAll<HTMLElement>('[data-countup]')
+
+  const observer = new IntersectionObserver(
+    (entries) => {
+      entries.forEach((entry) => {
+        if (!entry.isIntersecting) return
+        observer.unobserve(entry.target)
+        const el = entry.target as HTMLElement
+        const target = parseFloat(el.dataset.countup ?? '0')
+        const suffix = el.dataset.suffix ?? ''
+        const comma = 'comma' in el.dataset
+        const decimals = parseInt(el.dataset.decimal ?? '0')
+        const duration = 1400
+        const t0 = performance.now()
+
+        const tick = (now: number) => {
+          const p = Math.min((now - t0) / duration, 1)
+          const eased = 1 - Math.pow(1 - p, 3)
+          const val = eased * target
+          let text: string
+          if (decimals > 0) {
+            text = val.toFixed(decimals)
+          } else if (comma) {
+            text = Math.round(val).toLocaleString()
+          } else {
+            text = String(Math.round(val))
+          }
+          el.textContent = text + suffix
+          if (p < 1) requestAnimationFrame(tick)
+        }
+        requestAnimationFrame(tick)
+      })
+    },
+    { threshold: 0.3 }
+  )
+
+  els.forEach((el) => observer.observe(el))
+</script>
+
 <style>
 .hero {
   max-width: var(--max-w);
diff --git a/src/pages/changelog/index.astro b/src/pages/changelog/index.astro
new file mode 100644
index 0000000..d792ff8
--- /dev/null
+++ b/src/pages/changelog/index.astro
@@ -0,0 +1,182 @@
+---
+import Layout from '../../layouts/Layout.astro'
+import SiteHeader from '../../components/global/SiteHeader.astro'
+import SiteFooter from '../../components/global/SiteFooter.astro'
+import { rssEntries } from '../../data/rss-entries'
+
+const badgeColor: Record<string, string> = {
+  release:     'var(--accent)',
+  new_feature: 'var(--cyan)',
+  new_page:    'var(--cyan)',
+  new_doc:     'var(--cyan)',
+  performance: 'var(--violet)',
+}
+
+const badgeLabel: Record<string, string> = {
+  release:     'Release',
+  new_feature: 'New feature',
+  new_page:    'New page',
+  new_doc:     'New doc',
+  performance: 'Performance',
+}
+---
+<Layout
+  title="Changelog — RTK"
+  description="New releases, features, and improvements to RTK — the CLI proxy that reduces AI coding token usage by 60-90%."
+>
+  <SiteHeader lang="en" />
+  <main id="main-content">
+    <div class="changelog-wrap">
+
+      <div class="changelog-header">
+        <div>
+          <h1>Changelog</h1>
+          <p class="changelog-sub">New updates and improvements to RTK.</p>
+        </div>
+        <a href="/rss.xml" class="rss-btn" aria-label="RSS feed">
+          <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" aria-hidden="true">
+            <path d="M4 11a9 9 0 019 9"/><path d="M4 4a16 16 0 0116 16"/>
+            <circle cx="5" cy="19" r="1" fill="currentColor" stroke="none"/>
+          </svg>
+          RSS feed
+        </a>
+      </div>
+
+      <ol class="changelog-list">
+        {rssEntries.map((entry) => (
+          <li class="changelog-entry">
+            <time class="entry-date">{entry.date}</time>
+            <span
+              class="entry-badge"
+              style={`color:${badgeColor[entry.type] ?? 'var(--text-muted)'};border-color:${badgeColor[entry.type] ?? 'var(--border)'}`}
+            >
+              {badgeLabel[entry.type] ?? entry.type}
+            </span>
+            <div class="entry-body">
+              <a href={entry.link} class="entry-title" target="_blank" rel="noopener">
+                {entry.title}
+              </a>
+              <p class="entry-desc">{entry.description}</p>
+            </div>
+          </li>
+        ))}
+      </ol>
+
+    </div>
+  </main>
+  <SiteFooter />
+</Layout>
+
+<style>
+.changelog-wrap {
+  max-width: 760px;
+  margin: 0 auto;
+  padding: 100px 24px 80px;
+}
+
+.changelog-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: flex-start;
+  gap: 16px;
+  margin-bottom: 48px;
+}
+
+h1 {
+  font-size: 2rem;
+  font-weight: 600;
+  letter-spacing: -0.02em;
+  color: var(--text-bright);
+  margin: 0 0 8px;
+}
+
+.changelog-sub {
+  color: var(--text-muted);
+  font-size: 0.95rem;
+  margin: 0;
+}
+
+.rss-btn {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--text-muted);
+  font-size: 0.78rem;
+  font-family: var(--font-mono);
+  text-decoration: none;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-sm);
+  padding: 6px 12px;
+  white-space: nowrap;
+  flex-shrink: 0;
+  transition: color 0.15s, border-color 0.15s;
+}
+.rss-btn:hover {
+  color: var(--accent);
+  border-color: var(--accent);
+}
+
+.changelog-list {
+  list-style: none;
+  padding: 0;
+  margin: 0;
+}
+
+.changelog-entry {
+  display: grid;
+  grid-template-columns: 110px auto 1fr;
+  gap: 12px 16px;
+  align-items: start;
+  padding: 20px 0;
+  border-bottom: 1px solid var(--border);
+}
+
+.entry-date {
+  font-family: var(--font-mono);
+  font-size: 0.72rem;
+  color: var(--text-dim);
+  white-space: nowrap;
+  padding-top: 3px;
+}
+
+.entry-badge {
+  font-family: var(--font-mono);
+  font-size: 0.65rem;
+  font-weight: 700;
+  padding: 2px 8px;
+  border-radius: var(--radius-pill);
+  border: 1px solid;
+  white-space: nowrap;
+}
+
+.entry-body { min-width: 0; }
+
+.entry-title {
+  display: block;
+  font-size: 0.93rem;
+  font-weight: 600;
+  color: var(--text);
+  text-decoration: none;
+  margin-bottom: 6px;
+  transition: color 0.15s;
+}
+.entry-title:hover { color: var(--accent); }
+
+.entry-desc {
+  font-size: 0.83rem;
+  color: var(--text-muted);
+  line-height: 1.65;
+  margin: 0;
+}
+
+@media (max-width: 600px) {
+  .changelog-entry {
+    grid-template-columns: 1fr auto;
+    grid-template-rows: auto auto;
+  }
+  .entry-date { grid-column: 1; }
+  .entry-badge { grid-column: 2; }
+  .entry-body { grid-column: 1 / -1; }
+  .changelog-header { flex-direction: column; }
+}
+</style>
diff --git a/src/styles/landing.css b/src/styles/landing.css
index 0e1627c..477b2b0 100644
--- a/src/styles/landing.css
+++ b/src/styles/landing.css
@@ -456,6 +456,11 @@ section h2 {
   min-width: 0;
 }
 
+.code-block code::before {
+  content: '$ ';
+  font-weight: 600;
+}
+
 .code-block-wide {
   max-width: 360px;
   margin: 0 auto;

From acfc732a964c0847c7d970ca10eb367d23646ca7 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 15 May 2026 12:59:12 +0200
Subject: [PATCH 2/8] =?UTF-8?q?fix(hero):=20docs=20CTA=20url=20/guide/=20?=
 =?UTF-8?q?=E2=86=92=20/docs/?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/landing/Hero.astro | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/landing/Hero.astro b/src/components/landing/Hero.astro
index c31ae55..ce3c93b 100644
--- a/src/components/landing/Hero.astro
+++ b/src/components/landing/Hero.astro
@@ -60,7 +60,7 @@ const starsSuffix = stars >= 1000 ? 'k' : ''
 
       <div class="hero-cta">
         <a href="#install" class="btn btn-primary">{t('hero.cta_install', lang)}</a>
-        <a href="/guide/" class="btn btn-ghost">
+        <a href="/docs/" class="btn btn-ghost">
           {t('ui.nav_docs', lang)}
         </a>
       </div>

From 53f7344935970be0fd1516179fae9f50a7e592a0 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 15 May 2026 12:59:58 +0200
Subject: [PATCH 3/8] =?UTF-8?q?fix(footer):=20changelog=20link=20=E2=86=92?=
 =?UTF-8?q?=20/changelog/=20(was=20GitHub=20CHANGELOG.md)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/global/SiteFooter.astro | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/global/SiteFooter.astro b/src/components/global/SiteFooter.astro
index 271570a..9c40af2 100644
--- a/src/components/global/SiteFooter.astro
+++ b/src/components/global/SiteFooter.astro
@@ -93,7 +93,7 @@ try {
           <li><a href="/docs/getting-started/quick-start/">Quick Start</a></li>
           <li><a href="/docs/what-rtk-covers/">What RTK Optimizes</a></li>
           <li><a href="/docs/troubleshooting/">Troubleshooting</a></li>
-          <li><a href="https://github.com/rtk-ai/rtk/blob/master/CHANGELOG.md" target="_blank" rel="noopener">Changelog</a></li>
+          <li><a href="/changelog/">Changelog</a></li>
         </ul>
       </div>
 

From 0a55884121fbd86997c8cf65b92dae089c594f96 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 15 May 2026 13:03:40 +0200
Subject: [PATCH 4/8] feat(changelog): two tabs + full width + GitHub releases

- Add "What's new" / "Releases" tabs (ARIA-compliant, vanilla JS)
- Fetch GitHub releases at build time (rtk-ai/rtk, per_page=30)
- Fallback to GitHub link if API unavailable
- max-width: var(--max-w) to match header/footer width (was 760px)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/pages/changelog/index.astro | 171 ++++++++++++++++++++++++++++----
 1 file changed, 150 insertions(+), 21 deletions(-)

diff --git a/src/pages/changelog/index.astro b/src/pages/changelog/index.astro
index d792ff8..1cf44f1 100644
--- a/src/pages/changelog/index.astro
+++ b/src/pages/changelog/index.astro
@@ -4,6 +4,36 @@ import SiteHeader from '../../components/global/SiteHeader.astro'
 import SiteFooter from '../../components/global/SiteFooter.astro'
 import { rssEntries } from '../../data/rss-entries'
 
+interface GhRelease {
+  tag: string
+  name: string
+  date: string
+  url: string
+  prerelease: boolean
+}
+
+let releases: GhRelease[] = []
+
+try {
+  const headers: Record<string, string> = { 'User-Agent': 'rtk-landing' }
+  const token = process.env.GITHUB_TOKEN
+  if (token) headers['Authorization'] = `Bearer ${token}`
+
+  const res = await fetch('https://api.github.com/repos/rtk-ai/rtk/releases?per_page=30', { headers })
+  if (res.ok) {
+    const data = await res.json()
+    releases = data.map((r: Record<string, unknown>) => ({
+      tag: r.tag_name as string,
+      name: (r.name as string) || (r.tag_name as string),
+      date: new Date(r.published_at as string).toLocaleDateString('en-US', {
+        year: 'numeric', month: 'short', day: 'numeric',
+      }),
+      url: r.html_url as string,
+      prerelease: r.prerelease as boolean,
+    }))
+  }
+} catch {}
+
 const badgeColor: Record<string, string> = {
   release:     'var(--accent)',
   new_feature: 'var(--cyan)',
@@ -42,34 +72,93 @@ const badgeLabel: Record<string, string> = {
         </a>
       </div>
 
-      <ol class="changelog-list">
-        {rssEntries.map((entry) => (
-          <li class="changelog-entry">
-            <time class="entry-date">{entry.date}</time>
-            <span
-              class="entry-badge"
-              style={`color:${badgeColor[entry.type] ?? 'var(--text-muted)'};border-color:${badgeColor[entry.type] ?? 'var(--border)'}`}
-            >
-              {badgeLabel[entry.type] ?? entry.type}
-            </span>
-            <div class="entry-body">
-              <a href={entry.link} class="entry-title" target="_blank" rel="noopener">
-                {entry.title}
-              </a>
-              <p class="entry-desc">{entry.description}</p>
-            </div>
-          </li>
-        ))}
-      </ol>
+      <div class="changelog-tabs" role="tablist" aria-label="Changelog sections">
+        <button class="tab-btn tab-btn--active" role="tab" aria-selected="true" aria-controls="panel-updates" id="tab-updates">
+          What's new
+        </button>
+        <button class="tab-btn" role="tab" aria-selected="false" aria-controls="panel-releases" id="tab-releases">
+          Releases
+        </button>
+      </div>
+
+      <div id="panel-updates" role="tabpanel" aria-labelledby="tab-updates">
+        <ol class="changelog-list">
+          {rssEntries.map((entry) => (
+            <li class="changelog-entry">
+              <time class="entry-date">{entry.date}</time>
+              <span
+                class="entry-badge"
+                style={`color:${badgeColor[entry.type] ?? 'var(--text-muted)'};border-color:${badgeColor[entry.type] ?? 'var(--border)'}`}
+              >
+                {badgeLabel[entry.type] ?? entry.type}
+              </span>
+              <div class="entry-body">
+                <a href={entry.link} class="entry-title" target="_blank" rel="noopener">
+                  {entry.title}
+                </a>
+                <p class="entry-desc">{entry.description}</p>
+              </div>
+            </li>
+          ))}
+        </ol>
+      </div>
+
+      <div id="panel-releases" role="tabpanel" aria-labelledby="tab-releases" hidden>
+        {releases.length > 0 ? (
+          <ol class="changelog-list">
+            {releases.map((r) => (
+              <li class="changelog-entry">
+                <time class="entry-date">{r.date}</time>
+                <span
+                  class="entry-badge"
+                  style={`color:var(--accent);border-color:var(--accent)`}
+                >
+                  {r.prerelease ? 'Pre-release' : 'Release'}
+                </span>
+                <div class="entry-body">
+                  <a href={r.url} class="entry-title" target="_blank" rel="noopener">
+                    {r.name !== r.tag ? `${r.name} (${r.tag})` : r.tag}
+                  </a>
+                </div>
+              </li>
+            ))}
+          </ol>
+        ) : (
+          <p class="releases-fallback">
+            See all releases on <a href="https://github.com/rtk-ai/rtk/releases" target="_blank" rel="noopener">GitHub</a>.
+          </p>
+        )}
+      </div>
 
     </div>
   </main>
   <SiteFooter />
 </Layout>
 
+<script>
+  const tabs = document.querySelectorAll<HTMLButtonElement>('.tab-btn')
+  const panels = document.querySelectorAll<HTMLElement>('[role="tabpanel"]')
+
+  tabs.forEach((tab) => {
+    tab.addEventListener('click', () => {
+      const target = tab.getAttribute('aria-controls')!
+
+      tabs.forEach((t) => {
+        t.classList.remove('tab-btn--active')
+        t.setAttribute('aria-selected', 'false')
+      })
+      panels.forEach((p) => { p.hidden = true })
+
+      tab.classList.add('tab-btn--active')
+      tab.setAttribute('aria-selected', 'true')
+      document.getElementById(target)!.hidden = false
+    })
+  })
+</script>
+
 <style>
 .changelog-wrap {
-  max-width: 760px;
+  max-width: var(--max-w);
   margin: 0 auto;
   padding: 100px 24px 80px;
 }
@@ -79,7 +168,7 @@ const badgeLabel: Record<string, string> = {
   justify-content: space-between;
   align-items: flex-start;
   gap: 16px;
-  margin-bottom: 48px;
+  margin-bottom: 32px;
 }
 
 h1 {
@@ -116,6 +205,33 @@ h1 {
   border-color: var(--accent);
 }
 
+.changelog-tabs {
+  display: flex;
+  gap: 0;
+  border-bottom: 1px solid var(--border);
+  margin-bottom: 0;
+}
+
+.tab-btn {
+  background: none;
+  border: none;
+  border-bottom: 2px solid transparent;
+  margin-bottom: -1px;
+  padding: 10px 20px;
+  font-family: var(--font-mono);
+  font-size: 0.78rem;
+  color: var(--text-dim);
+  cursor: pointer;
+  transition: color 0.15s, border-color 0.15s;
+}
+.tab-btn:hover {
+  color: var(--text);
+}
+.tab-btn--active {
+  color: var(--accent);
+  border-bottom-color: var(--accent);
+}
+
 .changelog-list {
   list-style: none;
   padding: 0;
@@ -169,6 +285,19 @@ h1 {
   margin: 0;
 }
 
+.releases-fallback {
+  padding: 40px 0;
+  color: var(--text-muted);
+  font-size: 0.9rem;
+}
+.releases-fallback a {
+  color: var(--accent);
+  text-decoration: none;
+}
+.releases-fallback a:hover {
+  text-decoration: underline;
+}
+
 @media (max-width: 600px) {
   .changelog-entry {
     grid-template-columns: 1fr auto;

From 85e2086bf3f4420e1405b2ab449e7a26d84422dd Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 15 May 2026 13:21:18 +0200
Subject: [PATCH 5/8] fix(changelog): tab buttons appearance + full width
 container

- Tab buttons: add appearance:none + border-radius:0 to kill browser defaults
- Container: hardcode 1140px + width:100% + box-sizing + import landing.css
  to match other sub-pages (savings, vs, faq)
- Add focus-visible outline for accessibility

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/pages/changelog/index.astro | 15 ++++++++++++++-
 1 file changed, 14 insertions(+), 1 deletion(-)

diff --git a/src/pages/changelog/index.astro b/src/pages/changelog/index.astro
index 1cf44f1..ca177c1 100644
--- a/src/pages/changelog/index.astro
+++ b/src/pages/changelog/index.astro
@@ -157,10 +157,14 @@ const badgeLabel: Record<string, string> = {
 </script>
 
 <style>
+  @import '../../styles/landing.css';
+
 .changelog-wrap {
-  max-width: var(--max-w);
+  max-width: 1140px;
+  width: 100%;
   margin: 0 auto;
   padding: 100px 24px 80px;
+  box-sizing: border-box;
 }
 
 .changelog-header {
@@ -213,9 +217,13 @@ h1 {
 }
 
 .tab-btn {
+  appearance: none;
+  -webkit-appearance: none;
   background: none;
   border: none;
   border-bottom: 2px solid transparent;
+  border-radius: 0;
+  outline: none;
   margin-bottom: -1px;
   padding: 10px 20px;
   font-family: var(--font-mono);
@@ -223,10 +231,15 @@ h1 {
   color: var(--text-dim);
   cursor: pointer;
   transition: color 0.15s, border-color 0.15s;
+  -webkit-font-smoothing: antialiased;
 }
 .tab-btn:hover {
   color: var(--text);
 }
+.tab-btn:focus-visible {
+  outline: 1px solid var(--accent);
+  outline-offset: 2px;
+}
 .tab-btn--active {
   color: var(--accent);
   border-bottom-color: var(--accent);

From a90177cc22607da222618a6dd9d36d0f10158599 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Fri, 15 May 2026 14:34:30 +0200
Subject: [PATCH 6/8] feat(faq): left/right two-column layout + clean AI
 writing markers
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Sidebar nav (sticky, 200px) with left-border active state
- Right panels show only the active section (vanilla JS tab pattern)
- Mobile: sidebar flips to horizontal pill tabs
- Remove all em dashes (11 instances) replaced with parens or restructured
- Fix 3 staccato sequences (Q5, Q7, Q20)
- Replace jargon: "context pollution" → clutter, "key differentiator" → natural phrasing
- Hero subheading em dash → colon

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/pages/faq/index.astro | 270 ++++++++++++++++++++++++++++++++++----
 1 file changed, 244 insertions(+), 26 deletions(-)

diff --git a/src/pages/faq/index.astro b/src/pages/faq/index.astro
index 55a5212..a4b2f2c 100644
--- a/src/pages/faq/index.astro
+++ b/src/pages/faq/index.astro
@@ -6,33 +6,115 @@ import SearchModal from '../../components/global/SearchModal.astro'
 
 const buildDate = new Date().toISOString().split('T')[0]
 
-const faqItems = [
+const faqSections = [
   {
-    q: 'What is RTK (Rust Token Killer)?',
-    a: 'RTK is an open-source CLI tool that compresses command outputs before they reach the AI context window. It reduces token usage by 60-90% with zero configuration changes, enabling longer AI coding sessions and lower API costs. RTK is written in Rust, MIT licensed, and works transparently with Claude Code, Cursor, and any terminal-based AI assistant.',
-  },
-  {
-    q: 'How many tokens does RTK actually save?',
-    a: 'Based on measurements across 2,900+ real-world commands, RTK removes an average of 89% of CLI output noise. Command-level savings: cargo test (91.8% savings), git status (80.8%), find (78.3%), grep (49.5%). A developer who ran 15,720 commands saved 138 million tokens over several weeks, tracked live via rtk gain.',
-  },
-  {
-    q: 'Is RTK free? Are there usage limits?',
-    a: 'RTK is completely free. It is open source under the MIT license, with source code available on GitHub at github.com/rtk-ai/rtk. There are no usage limits, no API keys required, no telemetry, and no accounts. RTK Cloud (waitlist) will offer additional team features.',
+    title: 'How it works',
+    id: 'how-it-works',
+    items: [
+      {
+        q: 'What is RTK (Rust Token Killer)?',
+        a: 'RTK is an open-source CLI tool that compresses command outputs before they reach the AI context window. It reduces token usage by 60–90% with zero configuration changes, enabling longer AI coding sessions and lower API costs. Written in Rust, MIT licensed, it works transparently with Claude Code, Cursor, and any terminal-based AI assistant.',
+      },
+      {
+        q: 'How does RTK work?',
+        a: 'RTK sits between your terminal and your AI tool. When you run rtk git status, it captures the raw output, applies token-optimized filters, and returns only what the AI actually needs (no boilerplate, no repeated context, no verbose headers). The filtering adds less than 10ms of latency and requires no changes to your existing commands.',
+      },
+      {
+        q: 'Does RTK modify my code or git history?',
+        a: 'Never. RTK only intercepts and filters what commands print to stdout. It does not touch your source files, your git repository, or any data at rest.',
+      },
+      {
+        q: 'What is context engineering, and where does RTK fit?',
+        a: 'Context engineering is the practice of managing what information AI models receive across an entire coding session. RTK operates at Layer 1 (the CLI level), filtering noise before it ever enters the context window. This makes it the only token optimization tool that works regardless of billing plan, IDE, or AI provider.',
+      },
+      {
+        q: 'What is the performance overhead of RTK?',
+        a: 'RTK adds under 10ms per command. For operations that take seconds (test suites, builds, git diffs), the overhead is effectively zero. Single static binary, no daemon, no background process, no network calls during filtering.',
+      },
+    ],
   },
   {
-    q: 'Which AI coding tools and commands does RTK support?',
-    a: 'RTK works with Claude Code (Anthropic), Cursor, Gemini CLI, Aider, and any AI assistant that reads terminal output. It supports all major CLI commands: cargo test, pytest, go test, git diff, git status, git log, grep, find, ls, pnpm list, tsc, eslint, prisma, docker, kubectl, and more.',
+    title: 'Token savings',
+    id: 'token-savings',
+    items: [
+      {
+        q: 'How many tokens does RTK actually save?',
+        a: 'Based on measurements across 2,900+ real-world commands, RTK removes an average of 89% of CLI output noise. Command-level savings: cargo test (91.8%), git status (80.8%), find (78.3%), grep (49.5%). A developer who ran 15,720 commands saved 138 million tokens over several weeks, tracked live via rtk gain.',
+      },
+      {
+        q: 'Which commands have the highest token savings?',
+        a: 'Test runners deliver the most dramatic reductions. rtk vitest run saves up to 99.6% by surfacing only failing tests, while rtk cargo test cuts ~90% by suppressing passing logs. Git operations fall in the 75–92% range (git log saves 92.3% on a 100-commit span). Build and lint outputs: 70–87%.',
+      },
+      {
+        q: 'How do I track my savings?',
+        a: 'Run rtk gain to see cumulative savings, average efficiency rate, and per-command breakdown. Use rtk gain -p for a per-project view, or rtk discover to analyze your Claude Code session history and identify commands you\'re running without RTK.',
+      },
+      {
+        q: 'Why does reducing tokens improve AI output quality, not just cost?',
+        a: 'When a context window fills with git status boilerplate, passing test logs, and verbose headers, the AI loses focus on the actual code. Stripping that noise keeps your real code changes proportionally larger in the window, which reduces hallucination and off-topic suggestions well before you factor in cost.',
+      },
+    ],
   },
   {
-    q: 'How does RTK work without changing my workflow?',
-    a: 'Running rtk init --claude-code installs a PreToolUse hook in Claude Code settings that automatically rewrites Bash commands to rtk equivalents. For other AI tools, rtk init --global installs a shell hook that works at the process level. Either way, you keep using your normal commands. RTK intercepts and compresses the output before it enters the context window, with no manual changes to prompts or workflows needed.',
+    title: 'Installation & compatibility',
+    id: 'installation',
+    items: [
+      {
+        q: 'How do I install RTK?',
+        a: 'Three options: run the one-liner curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh, install via Homebrew with brew install rtk, or build from source with cargo install rtk. All three produce the same single binary with no runtime dependencies.',
+      },
+      {
+        q: 'Does RTK work on Windows?',
+        a: 'Yes. Pre-built binaries for Windows are available on the GitHub Releases page. You can also install via cargo install rtk with the Rust toolchain on Windows.',
+      },
+      {
+        q: 'Which AI coding tools does RTK support?',
+        a: 'RTK works with Claude Code (native PreToolUse/PostToolUse hooks), Cursor, Gemini CLI, Cline, Windsurf, GitHub Copilot, Codex, Aider, Kilo Code, OpenCode, and any tool that reads terminal output. That\'s 13 agents total, each with automatic command rewriting.',
+      },
+      {
+        q: 'Does RTK work with Claude Max and Pro subscriptions?',
+        a: 'Yes, and it\'s a meaningful differentiator. API-level token optimization tools cannot intercept traffic on Claude Max/Pro plans because there is no API key to hook into. RTK operates at the terminal level, upstream of any billing mode, so it works whether you are on API, Max, or Pro.',
+      },
+      {
+        q: 'Does RTK work in CI/CD pipelines?',
+        a: 'Yes. RTK is a static binary with no daemon, no authentication, and no setup beyond placing the binary in your PATH. Add it to your CI environment and prefix commands: rtk cargo test, rtk cargo build, rtk lint all work identically to local usage.',
+      },
+      {
+        q: 'How does RTK work without changing my workflow?',
+        a: 'Running rtk init --claude-code installs a PreToolUse hook in Claude Code settings that automatically rewrites Bash commands to rtk equivalents. For other tools, rtk init --global installs a shell hook at the process level. Your existing commands stay the same; RTK intercepts and compresses the output before it reaches the context window.',
+      },
+      {
+        q: 'Does RTK affect code quality or AI reasoning accuracy?',
+        a: 'No. RTK removes verbose boilerplate and repetitive output noise, not meaningful content. Test failures, error messages, diffs, and stack traces are preserved in full. The AI receives the same essential information with 89% less noise, which typically improves reasoning accuracy by cutting out irrelevant clutter.',
+      },
+    ],
   },
   {
-    q: 'Does RTK affect code quality or AI reasoning accuracy?',
-    a: 'No. RTK removes verbose boilerplate and repetitive output noise, not meaningful content. Test failures, error messages, diffs, and stack traces are preserved in full. The AI receives the same essential information with 89% less noise, which typically improves reasoning quality by reducing context pollution.',
+    title: 'Privacy & open source',
+    id: 'privacy',
+    items: [
+      {
+        q: 'Is RTK free? Are there usage limits?',
+        a: 'RTK is completely free and open source under the MIT license (source on GitHub), with no usage limits, no API keys, and no account required. RTK Cloud (currently on waitlist) will add team features.',
+      },
+      {
+        q: 'Does RTK collect my code or commands?',
+        a: 'No. All output processing happens locally. The optional anonymous telemetry tracks only which command categories you use and aggregate savings counts, never file contents, command arguments, or any identifiable information. It\'s opt-in and off by default.',
+      },
+      {
+        q: 'How do I disable RTK telemetry?',
+        a: 'Set telemetry = false in your .rtk.toml configuration file, or run rtk config set telemetry false. It was designed opt-in and GDPR-compliant from day one.',
+      },
+      {
+        q: 'Is RTK safe for corporate environments?',
+        a: 'Yes. RTK is a local binary that makes no network calls during filtering, with source code open on GitHub and fully auditable. Telemetry is opt-in and captures no content data. Many teams already run it in CI/CD pipelines and enterprise environments.',
+      },
+    ],
   },
 ]
 
+const allItems = faqSections.flatMap((s) => s.items)
+
 const schemaOrg = [
   {
     '@context': 'https://schema.org',
@@ -47,7 +129,7 @@ const schemaOrg = [
     '@type': 'FAQPage',
     url: 'https://www.rtk-ai.app/faq/',
     dateModified: buildDate,
-    mainEntity: faqItems.map(({ q, a }) => ({
+    mainEntity: allItems.map(({ q, a }) => ({
       '@type': 'Question',
       name: q,
       acceptedAnswer: { '@type': 'Answer', text: a },
@@ -74,19 +156,39 @@ const schemaOrg = [
       </nav>
       <h1>Frequently asked questions.</h1>
       <p class="subpage-sub">
-        Everything you need to know about RTK — what it does, how it works, and what it costs (nothing).
+        Everything you need to know about RTK: what it does, how it works, and what it costs (nothing).
       </p>
     </section>
 
     <section class="faq-page-section">
       <div class="section-inner">
-        <div class="faq-list">
-          {faqItems.map(({ q, a }) => (
-            <details class="faq-item">
-              <summary class="faq-question">{q}</summary>
-              <p class="faq-answer">{a}</p>
-            </details>
-          ))}
+        <div class="faq-layout">
+          <nav class="faq-sidebar" aria-label="FAQ categories">
+            {faqSections.map((section, i) => (
+              <button
+                class={`faq-nav-item${i === 0 ? ' faq-nav-item--active' : ''}`}
+                data-target={section.id}
+                type="button"
+              >
+                {section.title}
+              </button>
+            ))}
+          </nav>
+
+          <div class="faq-panels">
+            {faqSections.map((section, i) => (
+              <div class="faq-panel" id={`panel-${section.id}`} hidden={i !== 0 || undefined}>
+                <div class="faq-list">
+                  {section.items.map(({ q, a }) => (
+                    <details class="faq-item">
+                      <summary class="faq-question">{q}</summary>
+                      <p class="faq-answer">{a}</p>
+                    </details>
+                  ))}
+                </div>
+              </div>
+            ))}
+          </div>
         </div>
       </div>
     </section>
@@ -106,6 +208,30 @@ const schemaOrg = [
 
   <SiteFooter />
   <SearchModal />
+
+  <script>
+    const navItems = document.querySelectorAll<HTMLButtonElement>('.faq-nav-item')
+    const panels = document.querySelectorAll<HTMLElement>('.faq-panel')
+
+    navItems.forEach((btn) => {
+      btn.addEventListener('click', () => {
+        const target = btn.dataset.target
+
+        // Update nav active state
+        navItems.forEach((b) => b.classList.remove('faq-nav-item--active'))
+        btn.classList.add('faq-nav-item--active')
+
+        // Show matching panel, hide others
+        panels.forEach((panel) => {
+          if (panel.id === `panel-${target}`) {
+            panel.removeAttribute('hidden')
+          } else {
+            panel.setAttribute('hidden', '')
+          }
+        })
+      })
+    })
+  </script>
 </Layout>
 
 <style is:global>
@@ -155,4 +281,96 @@ const schemaOrg = [
 
 <style>
   .faq-page-section { background: var(--bg-card); }
+
+  /* Two-column layout */
+  .faq-layout {
+    display: grid;
+    grid-template-columns: 200px 1fr;
+    gap: 60px;
+    align-items: start;
+  }
+
+  /* Left sidebar */
+  .faq-sidebar {
+    position: sticky;
+    top: 100px;
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+  }
+
+  .faq-nav-item {
+    font-size: 0.88rem;
+    color: var(--text-dim);
+    padding: 8px 0 8px 14px;
+    display: block;
+    width: 100%;
+    text-align: left;
+    background: none;
+    border: none;
+    border-left: 2px solid transparent;
+    cursor: pointer;
+    transition: color 0.15s, border-color 0.15s;
+    font-family: inherit;
+    line-height: 1.4;
+  }
+
+  .faq-nav-item:hover {
+    color: var(--text);
+  }
+
+  .faq-nav-item--active {
+    color: var(--accent);
+    border-left-color: var(--accent);
+  }
+
+  /* Right panels */
+  .faq-panels {
+    min-width: 0;
+  }
+
+  .faq-panel[hidden] {
+    display: none;
+  }
+
+  /* Mobile: horizontal pill tabs */
+  @media (max-width: 768px) {
+    .faq-layout {
+      grid-template-columns: 1fr;
+      gap: 24px;
+    }
+
+    .faq-sidebar {
+      position: static;
+      flex-direction: row;
+      overflow-x: auto;
+      gap: 8px;
+      padding-bottom: 4px;
+      scrollbar-width: none;
+    }
+
+    .faq-sidebar::-webkit-scrollbar {
+      display: none;
+    }
+
+    .faq-nav-item {
+      flex-shrink: 0;
+      width: auto;
+      padding: 6px 14px;
+      border: 1px solid var(--border);
+      border-left: 1px solid var(--border);
+      border-radius: var(--radius-pill);
+      white-space: nowrap;
+      font-size: 0.84rem;
+    }
+
+    .faq-nav-item:hover {
+      border-color: var(--text-dim);
+    }
+
+    .faq-nav-item--active {
+      border-color: var(--accent);
+      color: var(--accent);
+    }
+  }
 </style>

From ba079c5161e6015e746dabf74c9afb1474cb88a7 Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Sun, 24 May 2026 18:07:12 +0200
Subject: [PATCH 7/8] fix: content accuracy + Apache 2.0 + dead links + design
 gradients
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Commands: rtk init --claude-code → rtk init --global (Claude Code),
  rtk init --cursor → rtk init --global --cursor — matches official docs
- License: MIT → Apache 2.0 across all pages, schemas, footer, translations
- Binary URL: /releases → /releases/latest (skips pre-releases)
- CTA copy: "cut token costs" → "reduce CLI output noise … leading to cost savings"
- Dead links: /docs/what-rtk-covers/ → /docs/resources/what-rtk-covers/,
  /docs/troubleshooting/ → /docs/resources/troubleshooting/
- Design: hero-accent "Fix it." gains accent→cyan gradient text
- Docs: z-index fix for Starlight language select overlapping TOC panel
- FAQ: token savings answer links to savings page

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/global/SiteFooter.astro    | 16 ++++++++--------
 src/components/landing/Hero.astro         |  5 ++++-
 src/components/landing/Install.astro      |  8 ++++----
 src/components/pages/LandingPage.astro    | 10 +++++-----
 src/components/pages/ProductIcmPage.astro |  6 +++---
 src/components/pages/ProductVoxPage.astro |  6 +++---
 src/data/translations.ts                  |  2 +-
 src/pages/faq/index.astro                 |  8 ++++----
 src/pages/savings/index.astro             |  2 +-
 src/pages/team/index.astro                |  2 +-
 src/styles/starlight-overrides.css        | 18 ++++++++++++++++++
 11 files changed, 52 insertions(+), 31 deletions(-)

diff --git a/src/components/global/SiteFooter.astro b/src/components/global/SiteFooter.astro
index 9c40af2..6ed22db 100644
--- a/src/components/global/SiteFooter.astro
+++ b/src/components/global/SiteFooter.astro
@@ -28,7 +28,7 @@ try {
     <div class="footer-cta-inner">
       <div class="footer-cta-text">
         <p class="footer-cta-title">Less noise. Better context.</p>
-        <p class="footer-cta-sub">Install rtk and cut token costs by <strong>60-90%</strong> with zero config changes.</p>
+        <p class="footer-cta-sub">Install rtk and reduce CLI output noise by <strong>60-90%</strong> — leading to cost savings with zero config changes.</p>
       </div>
       <div class="footer-cta-actions">
         <a href="/#install" class="btn btn-primary btn-sm">Install rtk</a>
@@ -50,7 +50,7 @@ try {
           <img src="/brand/logo.png" alt="rtk logo" width="22" height="22" style="border-radius:var(--radius-xs);">
           <span>rtk</span>
         </a>
-        <p class="footer-tagline">Rust Token Killer — reduce AI coding token usage by 60-90% with zero config.</p>
+        <p class="footer-tagline">Rust Token Killer — reduce CLI output noise by 60-90% before it reaches the AI context window.</p>
         <div class="footer-version">
           <span class="footer-version-badge">
             <IconStar size={12} filled />
@@ -78,7 +78,7 @@ try {
           <li><a href="/#install">Homebrew</a></li>
           <li><a href="/#install">One-liner (curl)</a></li>
           <li><a href="/#install">Via Cargo</a></li>
-          <li><a href="https://github.com/rtk-ai/rtk/releases" target="_blank" rel="noopener">Pre-built Binaries</a></li>
+          <li><a href="https://github.com/rtk-ai/rtk/releases/latest" target="_blank" rel="noopener">Pre-built Binaries</a></li>
           <li><a href="/docs/">Getting Started</a></li>
           <li><a href="/savings/">Token Savings</a></li>
         </ul>
@@ -91,8 +91,8 @@ try {
           <li><a href="/docs/">Guide</a></li>
           <li><a href="/docs/getting-started/installation/">Installation</a></li>
           <li><a href="/docs/getting-started/quick-start/">Quick Start</a></li>
-          <li><a href="/docs/what-rtk-covers/">What RTK Optimizes</a></li>
-          <li><a href="/docs/troubleshooting/">Troubleshooting</a></li>
+          <li><a href="/docs/resources/what-rtk-covers/">What RTK Optimizes</a></li>
+          <li><a href="/docs/resources/troubleshooting/">Troubleshooting</a></li>
           <li><a href="/changelog/">Changelog</a></li>
         </ul>
       </div>
@@ -116,7 +116,7 @@ try {
         </ul>
         <h3 class="footer-col-title" style="margin-top:24px;">Legal</h3>
         <ul class="footer-col-links">
-          <li><a href="https://github.com/rtk-ai/rtk/blob/master/LICENSE" target="_blank" rel="noopener">MIT License</a></li>
+          <li><a href="https://github.com/rtk-ai/rtk/blob/master/LICENSE" target="_blank" rel="noopener">Apache 2.0 License</a></li>
           <li><a href="https://github.com/rtk-ai/rtk/blob/master/CONTRIBUTING.md" target="_blank" rel="noopener">Contributing</a></li>
         </ul>
       </div>
@@ -130,7 +130,7 @@ try {
           <li><a href="https://discord.gg/RySmvNF5kF" target="_blank" rel="noopener">Discord Server</a></li>
           <li><a href="https://github.com/rtk-ai/rtk/issues" target="_blank" rel="noopener">Report Issues</a></li>
           <li><a href="https://github.com/rtk-ai/rtk/discussions" target="_blank" rel="noopener">Discussions</a></li>
-          <li><a href="https://twitter.com/intent/tweet?url=https://www.rtk-ai.app&text=Cut+Claude+Code+token+costs+by+60-90%25+with+RTK" target="_blank" rel="noopener">Share on X</a></li>
+          <li><a href="https://twitter.com/intent/tweet?url=https://www.rtk-ai.app&text=RTK+reduces+CLI+output+noise+by+60-90%25+before+it+hits+the+AI+context+window" target="_blank" rel="noopener">Share on X</a></li>
           <li><a href="https://ko-fi.com/patrickszymkowiak" target="_blank" rel="noopener">Support the project</a></li>
         </ul>
       </div>
@@ -142,7 +142,7 @@ try {
   <div class="footer-bottom">
     <div class="footer-bottom-inner">
       <p class="footer-bottom-left">
-        <span class="footer-copyright">MIT License</span>
+        <span class="footer-copyright">Apache 2.0</span>
         <span class="footer-bottom-sep">&middot;</span>
         Built by RTK Team
         <span class="footer-bottom-sep">&middot;</span>
diff --git a/src/components/landing/Hero.astro b/src/components/landing/Hero.astro
index ce3c93b..9d779f6 100644
--- a/src/components/landing/Hero.astro
+++ b/src/components/landing/Hero.astro
@@ -202,7 +202,10 @@ const starsSuffix = stars >= 1000 ? 'k' : ''
 }
 
 .hero-accent {
-  color: var(--accent);
+  background: linear-gradient(135deg, var(--accent) 0%, var(--cyan) 100%);
+  -webkit-background-clip: text;
+  -webkit-text-fill-color: transparent;
+  background-clip: text;
 }
 
 .hero-sub {
diff --git a/src/components/landing/Install.astro b/src/components/landing/Install.astro
index c820efa..a876a0e 100644
--- a/src/components/landing/Install.astro
+++ b/src/components/landing/Install.astro
@@ -11,13 +11,13 @@ const personas = [
   {
     id: 'claude-code',
     tabKey: 'install.tab.cc',
-    initCmd: 'rtk init --claude-code',
+    initCmd: 'rtk init --global',
     noteKey: 'install.note.cc',
   },
   {
     id: 'cursor',
     tabKey: 'install.tab.cursor',
-    initCmd: 'rtk init --cursor',
+    initCmd: 'rtk init --global --cursor',
     noteKey: 'install.note.cursor',
   },
   {
@@ -85,7 +85,7 @@ const personas = [
         <h3>{t('install.binaries', lang)}</h3>
         <p>{t('install.binaries_desc', lang)}</p>
         <div class="code-block">
-          <a href="https://github.com/rtk-ai/rtk/releases" target="_blank" rel="noopener" class="releases-link">{t('install.releases', lang)}</a>
+          <a href="https://github.com/rtk-ai/rtk/releases/latest" target="_blank" rel="noopener" class="releases-link">{t('install.releases', lang)}</a>
         </div>
       </div>
     </div>
@@ -118,7 +118,7 @@ const personas = [
         </div>
         <div class="install-step">
           <span class="install-step-num">2</span>
-          <code id="install-step-2-cmd">rtk init --claude-code</code>
+          <code id="install-step-2-cmd">rtk init --global</code>
         </div>
         <div class="install-step">
           <span class="install-step-num">3</span>
diff --git a/src/components/pages/LandingPage.astro b/src/components/pages/LandingPage.astro
index 29019e5..ba9c838 100644
--- a/src/components/pages/LandingPage.astro
+++ b/src/components/pages/LandingPage.astro
@@ -53,7 +53,7 @@ const schemaOrg = {
       '@id': 'https://www.rtk-ai.app/#software',
       name: 'RTK — Rust Token Killer',
       description:
-        'RTK compresses CLI command outputs before they reach the AI context window, reducing token usage by 60-90% with zero config changes. Open source, MIT licensed, written in Rust.',
+        'RTK compresses CLI command outputs before they reach the AI context window, reducing token output by 60-90% with zero config changes. Open source, Apache 2.0 licensed, written in Rust.',
       url: 'https://www.rtk-ai.app',
       applicationCategory: 'DeveloperApplication',
       operatingSystem: 'macOS, Linux, Windows',
@@ -67,7 +67,7 @@ const schemaOrg = {
         priceCurrency: 'USD',
         availability: 'https://schema.org/InStock',
       },
-      license: 'https://opensource.org/licenses/MIT',
+      license: 'https://www.apache.org/licenses/LICENSE-2.0',
       downloadUrl: 'https://github.com/rtk-ai/rtk',
       author: { '@id': 'https://www.rtk-ai.app/#organization' },
       featureList: [
@@ -104,7 +104,7 @@ const schemaOrg = {
           '@type': 'HowToStep',
           position: 2,
           name: 'Activate the auto-rewrite hook',
-          text: 'Run rtk init --claude-code for Claude Code (installs a PreToolUse hook) or rtk init --global for other AI tools (installs a shell hook). Both transparently rewrite commands to rtk equivalents, compressing output before it reaches the context window.',
+          text: 'Run rtk init --global for Claude Code and most AI tools (installs a PreToolUse hook that transparently rewrites commands to rtk equivalents). For Cursor, use rtk init --global --cursor. Your existing workflow stays unchanged; RTK intercepts commands and compresses output before it reaches the context window.',
           url: 'https://www.rtk-ai.app/#install',
         },
         {
@@ -121,7 +121,7 @@ const schemaOrg = {
       '@id': 'https://www.rtk-ai.app/#webpage',
       url: 'https://www.rtk-ai.app/',
       name: 'RTK — Rust Token Killer',
-      description: 'RTK reduces AI coding token usage by 60-90% — measured across 2,900+ real commands. 89% avg noise removed, 3x longer sessions, zero config. Free, open source, MIT, written in Rust.',
+      description: 'RTK reduces CLI output noise by 60-90% before it reaches the AI context window — measured across 2,900+ real commands. 89% avg noise removed, 3x longer sessions, zero config. Free, open source, Apache 2.0, written in Rust.',
       inLanguage: 'en',
       dateModified: buildDate,
       isPartOf: { '@type': 'WebSite', name: 'RTK', url: 'https://www.rtk-ai.app' },
@@ -136,7 +136,7 @@ const schemaOrg = {
 ---
 <Layout
   title="RTK — Rust Token Killer"
-  description="RTK reduces AI coding token usage by 60-90% — measured across 2,900+ real commands. 89% avg noise removed, 3x longer sessions, zero config. MIT licensed."
+  description="RTK reduces CLI output noise by 60-90% before it hits the AI context window — measured across 2,900+ real commands. 89% avg noise removed, 3x longer sessions, zero config. Apache 2.0."
   schemaOrg={schemaOrg}
 >
   <a href="#main-content" class="skip-to-content">Skip to content</a>
diff --git a/src/components/pages/ProductIcmPage.astro b/src/components/pages/ProductIcmPage.astro
index f3e161c..3839881 100644
--- a/src/components/pages/ProductIcmPage.astro
+++ b/src/components/pages/ProductIcmPage.astro
@@ -23,7 +23,7 @@ const schema = {
     datePublished: '2025-09-01',
     dateModified: buildDate,
     offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD', availability: 'https://schema.org/InStock' },
-    license: 'https://opensource.org/licenses/MIT',
+    license: 'https://www.apache.org/licenses/LICENSE-2.0',
     downloadUrl: 'https://github.com/rtk-ai/icm',
     author: { '@type': 'Organization', name: 'RTK AI', url: 'https://www.rtk-ai.app' },
     featureList: [
@@ -44,7 +44,7 @@ const schema = {
         name: 'What is ICM — Infinite Context Memory?',
         acceptedAnswer: {
           '@type': 'Answer',
-          text: 'ICM is permanent persistent memory for AI agents. It is a single Rust binary with SQLite storage that exposes 22 MCP tools. ICM provides three memory systems: episodic memories with temporal decay (4 importance levels), semantic knowledge graphs with typed relations, and a correction feedback system. It auto-configures 14 AI editors including Claude Code, Cursor, Windsurf, VS Code, Gemini Code Assist, Zed, Amp, Amazon Q, Cline, Roo Code, Kilo Code, Codex CLI, and OpenCode. 100% local, zero API keys required, MIT licensed.',
+          text: 'ICM is permanent persistent memory for AI agents. It is a single Rust binary with SQLite storage that exposes 22 MCP tools. ICM provides three memory systems: episodic memories with temporal decay (4 importance levels), semantic knowledge graphs with typed relations, and a correction feedback system. It auto-configures 14 AI editors including Claude Code, Cursor, Windsurf, VS Code, Gemini Code Assist, Zed, Amp, Amazon Q, Cline, Roo Code, Kilo Code, Codex CLI, and OpenCode. 100% local, zero API keys required, Apache 2.0 licensed.',
         },
       },
       {
@@ -135,7 +135,7 @@ const schema = {
 
     <!-- Hero -->
     <section class="hero">
-      <div class="hero-badge">Open Source &middot; MIT License &middot; Written in Rust</div>
+      <div class="hero-badge">Open Source &middot; Apache 2.0 &middot; Written in Rust</div>
       <h1>Your AI forgets everything.<br><span class="gradient-text">ICM fixes that.</span></h1>
       <p class="hero-sub">
         <strong>ICM</strong> gives AI agents real persistent memory.
diff --git a/src/components/pages/ProductVoxPage.astro b/src/components/pages/ProductVoxPage.astro
index c8bc43b..1ad050c 100644
--- a/src/components/pages/ProductVoxPage.astro
+++ b/src/components/pages/ProductVoxPage.astro
@@ -23,7 +23,7 @@ const schema = {
       datePublished: '2025-06-01',
       dateModified: buildDate,
       offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD', availability: 'https://schema.org/InStock' },
-      license: 'https://opensource.org/licenses/MIT',
+      license: 'https://www.apache.org/licenses/LICENSE-2.0',
       downloadUrl: 'https://github.com/rtk-ai/vox',
       author: { '@type': 'Organization', name: 'RTK AI', url: 'https://www.rtk-ai.app' },
       featureList: [
@@ -44,7 +44,7 @@ const schema = {
           name: 'What is Vox for Claude Code?',
           acceptedAnswer: {
             '@type': 'Answer',
-            text: 'Vox is a local-first text-to-speech CLI for Claude Code. It reads task completions aloud, provides spoken summaries, and supports voice cloning from a 10-second audio sample. Three TTS backends are available: macOS say (~50ms latency), MLX-powered qwen neural (~500ms, Apple Silicon), and pure-Rust qwen-native (~300ms, Metal and CUDA GPU). Zero API calls, fully local, MIT licensed.',
+            text: 'Vox is a local-first text-to-speech CLI for Claude Code. It reads task completions aloud, provides spoken summaries, and supports voice cloning from a 10-second audio sample. Three TTS backends are available: macOS say (~50ms latency), MLX-powered qwen neural (~500ms, Apple Silicon), and pure-Rust qwen-native (~300ms, Metal and CUDA GPU). Zero API calls, fully local, Apache 2.0 licensed.',
           },
         },
         {
@@ -134,7 +134,7 @@ const schema = {
 
     <!-- Hero -->
     <section class="hero">
-      <div class="hero-badge">Open Source &middot; MIT License &middot; Written in Rust</div>
+      <div class="hero-badge">Open Source &middot; Apache 2.0 &middot; Written in Rust</div>
       <h1>Give Claude Code<br><span class="gradient-text">a voice.</span></h1>
       <p class="hero-sub">
         Hear when tasks finish, get spoken summaries, clone your own voice.
diff --git a/src/data/translations.ts b/src/data/translations.ts
index e821fba..113eba9 100644
--- a/src/data/translations.ts
+++ b/src/data/translations.ts
@@ -26,7 +26,7 @@ export const T: Record<string, Record<Lang, string>> = {
   'nav.cloud':   { en: 'Cloud',   fr: 'Cloud',    es: 'Cloud',         de: 'Cloud',       zh: '云端',  ja: 'クラウド' },
   'nav.install': { en: 'Install', fr: 'Installer', es: 'Instalar',     de: 'Installieren', zh: '安装', ja: 'インストール' },
 
-  'hero.badge_oss': { en: 'Open Source · MIT · Rust', fr: 'Open Source · MIT · Rust', es: 'Open Source · MIT · Rust', de: 'Open Source · MIT · Rust', zh: '开源 · MIT · Rust', ja: 'オープンソース · MIT · Rust' },
+  'hero.badge_oss': { en: 'Open Source · Apache 2.0 · Rust', fr: 'Open Source · Apache 2.0 · Rust', es: 'Open Source · Apache 2.0 · Rust', de: 'Open Source · Apache 2.0 · Rust', zh: '开源 · Apache 2.0 · Rust', ja: 'オープンソース · Apache 2.0 · Rust' },
   'hero.title_1':   { en: 'Your AI agent is drowning', fr: 'Votre agent IA se noie', es: 'Tu agente IA se ahoga', de: 'Dein KI-Agent ertrinkt', zh: '你的 AI 代理正淹没在', ja: 'AI エージェントは' },
   'hero.title_2':   { en: 'in CLI noise.', fr: 'dans le bruit CLI.', es: 'en ruido del CLI.', de: 'im CLI-Rauschen.', zh: 'CLI 噪音中。', ja: 'CLI ノイズに埋もれている。' },
   'hero.title_3':   { en: 'Fix it.', fr: 'Résolvez ça.', es: 'Arréglalo.', de: 'Beheb das.', zh: '解决它。', ja: '解決しよう。' },
diff --git a/src/pages/faq/index.astro b/src/pages/faq/index.astro
index a4b2f2c..02e40bf 100644
--- a/src/pages/faq/index.astro
+++ b/src/pages/faq/index.astro
@@ -13,7 +13,7 @@ const faqSections = [
     items: [
       {
         q: 'What is RTK (Rust Token Killer)?',
-        a: 'RTK is an open-source CLI tool that compresses command outputs before they reach the AI context window. It reduces token usage by 60–90% with zero configuration changes, enabling longer AI coding sessions and lower API costs. Written in Rust, MIT licensed, it works transparently with Claude Code, Cursor, and any terminal-based AI assistant.',
+        a: 'RTK is an open-source CLI tool that compresses command outputs before they reach the AI context window. It reduces CLI output noise by 60–90% with zero configuration changes, enabling longer AI coding sessions and lower API costs. Written in Rust, Apache 2.0 licensed, it works transparently with Claude Code, Cursor, and any terminal-based AI assistant.',
       },
       {
         q: 'How does RTK work?',
@@ -39,7 +39,7 @@ const faqSections = [
     items: [
       {
         q: 'How many tokens does RTK actually save?',
-        a: 'Based on measurements across 2,900+ real-world commands, RTK removes an average of 89% of CLI output noise. Command-level savings: cargo test (91.8%), git status (80.8%), find (78.3%), grep (49.5%). A developer who ran 15,720 commands saved 138 million tokens over several weeks, tracked live via rtk gain.',
+        a: 'Based on measurements across 2,900+ real-world commands, RTK removes an average of 89% of CLI output noise. Command-level savings: cargo test (91.8%), git status (80.8%), find (78.3%), grep (49.5%). A developer who ran 15,720 commands saved 138 million tokens over several weeks, tracked live via rtk gain. See the full breakdown on the savings page.',
       },
       {
         q: 'Which commands have the highest token savings?',
@@ -81,7 +81,7 @@ const faqSections = [
       },
       {
         q: 'How does RTK work without changing my workflow?',
-        a: 'Running rtk init --claude-code installs a PreToolUse hook in Claude Code settings that automatically rewrites Bash commands to rtk equivalents. For other tools, rtk init --global installs a shell hook at the process level. Your existing commands stay the same; RTK intercepts and compresses the output before it reaches the context window.',
+        a: 'Running rtk init --global installs a PreToolUse hook in Claude Code settings that automatically rewrites Bash commands to rtk equivalents. For Cursor, use rtk init --global --cursor. Your existing commands stay the same; RTK intercepts and compresses the output before it reaches the context window.',
       },
       {
         q: 'Does RTK affect code quality or AI reasoning accuracy?',
@@ -95,7 +95,7 @@ const faqSections = [
     items: [
       {
         q: 'Is RTK free? Are there usage limits?',
-        a: 'RTK is completely free and open source under the MIT license (source on GitHub), with no usage limits, no API keys, and no account required. RTK Cloud (currently on waitlist) will add team features.',
+        a: 'RTK is completely free and open source under the Apache 2.0 license (source on GitHub), with no usage limits, no API keys, and no account required. RTK Cloud (currently on waitlist) will add team features.',
       },
       {
         q: 'Does RTK collect my code or commands?',
diff --git a/src/pages/savings/index.astro b/src/pages/savings/index.astro
index c2c67d3..5c28294 100644
--- a/src/pages/savings/index.astro
+++ b/src/pages/savings/index.astro
@@ -36,7 +36,7 @@ const schemaOrg = [
     description: 'Token savings measurements across 2,900+ real-world developer commands. Data covers cargo, git, grep, find, and other CLI tools used in AI-assisted development sessions.',
     url: 'https://www.rtk-ai.app/savings/',
     creator: { '@type': 'Organization', name: 'RTK AI', url: 'https://www.rtk-ai.app' },
-    license: 'https://opensource.org/licenses/MIT',
+    license: 'https://www.apache.org/licenses/LICENSE-2.0',
     temporalCoverage: '2025/2026',
     variableMeasured: [
       { '@type': 'PropertyValue', name: 'Average CLI noise removed', value: '89%' },
diff --git a/src/pages/team/index.astro b/src/pages/team/index.astro
index 1dd4063..fc4df36 100644
--- a/src/pages/team/index.astro
+++ b/src/pages/team/index.astro
@@ -83,7 +83,7 @@ const schemaOrg = {
 ---
 <Layout
   title="Team — RTK AI Labs | rtk-ai"
-  description="Meet RTK AI Labs, the team behind RTK: the Rust Token Killer for AI coding agents. Written in Rust, MIT licensed, zero telemetry, built for developers."
+  description="Meet RTK AI Labs, the team behind RTK: the Rust Token Killer for AI coding agents. Written in Rust, Apache 2.0 licensed, zero telemetry, built for developers."
   image="/og-image.jpg"
   schemaOrg={schemaOrg}
 >
diff --git a/src/styles/starlight-overrides.css b/src/styles/starlight-overrides.css
index faab5cd..cd390bc 100644
--- a/src/styles/starlight-overrides.css
+++ b/src/styles/starlight-overrides.css
@@ -181,3 +181,21 @@ starlight-toc a:hover {
 .starlight-aside--caution .starlight-aside__content {
   color: var(--sl-color-orange-high);
 }
+
+/* ── Language select dropdown z-index fix ───────────────────────────── */
+starlight-locale-select,
+.sl-hidden-locale-list,
+[aria-label="Select language"] + *,
+.locale-select-dropdown {
+  z-index: 200 !important;
+  position: relative;
+}
+
+/* Ensure the locale select sits above right-sidebar and TOC */
+.header sl-select,
+header sl-select,
+.header [data-type="locale"],
+header [data-type="locale"] {
+  position: relative;
+  z-index: 200;
+}

From c48e4b7ecb1270bc2fe0b45b581daf3ddd32aadf Mon Sep 17 00:00:00 2001
From: Florian BRUNIAUX <florian@bruniaux.com>
Date: Sun, 24 May 2026 22:03:11 +0200
Subject: [PATCH 8/8] feat: animated CTA, 2 new demo slides, FAQ link, docs
 i18n fix
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- landing.css: pulse glow animation on .btn-primary (2.8s cycle,
  stops on hover with intensified glow)
- DemoSlideshow: add vitest run (-98%) and ls -la (-80%) slides —
  6 total, dots updated, outputs match RTK docs exactly
- FAQ: token savings answer now links to /savings/ with inline link
  rendered below the answer (optional link field in data structure)
- starlight-overrides.css: hide Starlight's built-in locale selector
  (starlight-locale-select) — we use our own globe dropdown in the
  custom header, preventing overlap with the On this page panel

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 src/components/landing/DemoSlideshow.astro | 90 ++++++++++++++++++++++
 src/pages/faq/index.astro                  | 12 ++-
 src/styles/landing.css                     | 20 ++++-
 src/styles/starlight-overrides.css         | 20 ++---
 4 files changed, 123 insertions(+), 19 deletions(-)

diff --git a/src/components/landing/DemoSlideshow.astro b/src/components/landing/DemoSlideshow.astro
index 172155f..af02fed 100644
--- a/src/components/landing/DemoSlideshow.astro
+++ b/src/components/landing/DemoSlideshow.astro
@@ -19,6 +19,8 @@ const { lang } = Astro.props
         <button class="slide-tab" data-slide="1">git diff</button>
         <button class="slide-tab" data-slide="2">git status</button>
         <button class="slide-tab" data-slide="3">find</button>
+        <button class="slide-tab" data-slide="4">vitest run</button>
+        <button class="slide-tab" data-slide="5">ls -la</button>
       </div>
 
       <div class="slideshow-viewport">
@@ -207,6 +209,92 @@ src/parser/ error.rs formatter.rs</code></pre>
             </div>
           </div>
         </div>
+        <!-- Slide 4: vitest run -->
+        <div class="slide" data-index="4">
+          <div class="demo-grid">
+            <div class="demo-card">
+              <div class="demo-card-header">
+                <span class="demo-dot red"></span>
+                <span class="demo-label">vitest run</span>
+                <span class="demo-tokens">~3,400 tokens</span>
+              </div>
+              <pre><code> ✓ src/utils/format.test.ts (3)
+ ✓ src/utils/parse.test.ts (8)
+ ✓ src/api/users.test.ts (12)
+ ✓ src/api/orders.test.ts (9)
+ ✗ src/components/Cart.test.tsx (2)
+   × CartTotal renders with discounts
+     AssertionError: expected 42.00 to equal 37.80
+   × CartTotal handles empty cart
+     TypeError: Cannot read prop 'total' of undefined
+ ✓ src/hooks/useAuth.test.ts (5)
+ ✓ src/hooks/useCart.test.ts (7)
+ ✓ src/pages/Checkout.test.tsx (4)
+ ✓ src/pages/Home.test.tsx (6)
+
+ Test Files  1 failed | 7 passed (8)
+      Tests  2 failed | 54 passed (56)
+   Start at  14:22:41
+   Duration  4.2s (transform 210ms, setup 95ms)</code></pre>
+            </div>
+            <div class="demo-card demo-after">
+              <div class="demo-card-header">
+                <span class="demo-dot green"></span>
+                <span class="demo-label">rtk vitest run</span>
+                <span class="demo-tokens">~51 tokens</span>
+                <span class="demo-savings">-98%</span>
+              </div>
+              <pre><code>&#x2717; 2 failures in 1 file
+
+src/components/Cart.test.tsx
+  &#x2717; CartTotal renders with discounts
+    expected 42.00 to equal 37.80
+  &#x2717; CartTotal handles empty cart
+    Cannot read prop 'total' of undefined
+
+2 failed | 54 passed (4.2s)</code></pre>
+            </div>
+          </div>
+        </div>
+
+        <!-- Slide 5: ls -la -->
+        <div class="slide" data-index="5">
+          <div class="demo-grid">
+            <div class="demo-card">
+              <div class="demo-card-header">
+                <span class="demo-dot red"></span>
+                <span class="demo-label">ls -la</span>
+                <span class="demo-tokens">~210 tokens</span>
+              </div>
+              <pre><code>total 64
+drwxr-xr-x  14 user  staff   448B  3 Sep 09:12 .
+drwxr-xr-x  24 user  staff   768B  1 Sep 15:30 ..
+-rw-r--r--   1 user  staff  1.2K 30 Aug 11:45 .gitignore
+-rw-r--r--   1 user  staff  2.3K  2 Sep 16:22 Cargo.toml
+drwxr-xr-x   3 user  staff    96B 28 Aug 09:10 docs
+drwxr-xr-x   2 user  staff    64B  1 Sep 11:25 examples
+-rw-r--r--   1 user  staff   18K  3 Sep 09:12 index.html
+-rw-r--r--   1 user  staff   892B 29 Aug 14:33 install.sh
+-rw-r--r--   1 user  staff  1.1K 28 Aug 09:08 LICENSE
+-rw-r--r--   1 user  staff  3.4K  2 Sep 09:15 README.md
+drwxr-xr-x  18 user  staff   576B  3 Sep 09:11 src
+drwxr-xr-x   4 user  staff   128B  1 Sep 16:47 tests</code></pre>
+            </div>
+            <div class="demo-card demo-after">
+              <div class="demo-card-header">
+                <span class="demo-dot green"></span>
+                <span class="demo-label">rtk ls -la</span>
+                <span class="demo-tokens">~42 tokens</span>
+                <span class="demo-savings">-80%</span>
+              </div>
+              <pre><code>src/ (18 files)  tests/ (4 files)
+docs/ (3 files)  examples/ (2 files)
+
+Cargo.toml  README.md  install.sh
+index.html  LICENSE  .gitignore</code></pre>
+            </div>
+          </div>
+        </div>
       </div>
 
       <div class="slideshow-controls">
@@ -218,6 +306,8 @@ src/parser/ error.rs formatter.rs</code></pre>
           <span class="dot" data-slide="1"></span>
           <span class="dot" data-slide="2"></span>
           <span class="dot" data-slide="3"></span>
+          <span class="dot" data-slide="4"></span>
+          <span class="dot" data-slide="5"></span>
         </div>
         <button class="slide-arrow slide-next" aria-label={t('aria.next', lang)}>
           <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="9 18 15 12 9 6"/></svg>
diff --git a/src/pages/faq/index.astro b/src/pages/faq/index.astro
index 02e40bf..957b669 100644
--- a/src/pages/faq/index.astro
+++ b/src/pages/faq/index.astro
@@ -39,7 +39,8 @@ const faqSections = [
     items: [
       {
         q: 'How many tokens does RTK actually save?',
-        a: 'Based on measurements across 2,900+ real-world commands, RTK removes an average of 89% of CLI output noise. Command-level savings: cargo test (91.8%), git status (80.8%), find (78.3%), grep (49.5%). A developer who ran 15,720 commands saved 138 million tokens over several weeks, tracked live via rtk gain. See the full breakdown on the savings page.',
+        a: 'Based on measurements across 2,900+ real-world commands, RTK removes an average of 89% of CLI output noise. Command-level savings: cargo test (91.8%), git status (80.8%), find (78.3%), grep (49.5%). A developer who ran 15,720 commands saved 138 million tokens over several weeks, tracked live via rtk gain.',
+        link: { href: '/savings/', text: 'See the full breakdown →' },
       },
       {
         q: 'Which commands have the highest token savings?',
@@ -179,10 +180,13 @@ const schemaOrg = [
             {faqSections.map((section, i) => (
               <div class="faq-panel" id={`panel-${section.id}`} hidden={i !== 0 || undefined}>
                 <div class="faq-list">
-                  {section.items.map(({ q, a }) => (
+                  {section.items.map((item) => (
                     <details class="faq-item">
-                      <summary class="faq-question">{q}</summary>
-                      <p class="faq-answer">{a}</p>
+                      <summary class="faq-question">{item.q}</summary>
+                      <p class="faq-answer">{item.a}</p>
+                      {item.link && (
+                        <a href={item.link.href} class="faq-link">{item.link.text}</a>
+                      )}
                     </details>
                   ))}
                 </div>
diff --git a/src/styles/landing.css b/src/styles/landing.css
index 477b2b0..069affe 100644
--- a/src/styles/landing.css
+++ b/src/styles/landing.css
@@ -234,15 +234,23 @@
 
 .btn-sm { padding: 6px 14px; font-size: 0.8rem; }
 
+@keyframes btn-glow-pulse {
+  0%, 100% { box-shadow: 0 0 0 0 rgba(0, 229, 153, 0); }
+  50%       { box-shadow: 0 0 16px 4px rgba(0, 229, 153, 0.28); }
+}
+
 .btn-primary {
   background: var(--accent);
   color: var(--bg);
   border-color: var(--accent);
   font-weight: 700;
+  animation: btn-glow-pulse 2.8s ease-in-out infinite;
 }
 .btn-primary:hover {
   background: var(--accent-hover);
   border-color: var(--accent-hover);
+  animation: none;
+  box-shadow: 0 0 20px 6px rgba(0, 229, 153, 0.35);
 }
 
 .btn-ghost {
@@ -708,10 +716,20 @@ section h2 {
   font-size: 0.9rem;
   line-height: 1.7;
   color: var(--text-muted);
-  padding: 0 20px 18px;
+  padding: 0 20px 10px;
   margin: 0;
 }
 
+.faq-link {
+  display: inline-block;
+  margin: 0 20px 18px;
+  font-size: 0.85rem;
+  color: var(--accent);
+  text-decoration: none;
+  font-weight: 600;
+}
+.faq-link:hover { text-decoration: underline; }
+
 /* === Viking Illustrations === */
 .viking-illustration {
   width: 100%;
diff --git a/src/styles/starlight-overrides.css b/src/styles/starlight-overrides.css
index cd390bc..87f1563 100644
--- a/src/styles/starlight-overrides.css
+++ b/src/styles/starlight-overrides.css
@@ -182,20 +182,12 @@ starlight-toc a:hover {
   color: var(--sl-color-orange-high);
 }
 
-/* ── Language select dropdown z-index fix ───────────────────────────── */
+/* ── Hide Starlight's built-in locale selector ───────────────────────
+   We use our own custom header with a globe dropdown.
+   Starlight still generates locale links — hide them to prevent overlap
+   with the right sidebar / "On this page" panel.                      */
 starlight-locale-select,
 .sl-hidden-locale-list,
-[aria-label="Select language"] + *,
-.locale-select-dropdown {
-  z-index: 200 !important;
-  position: relative;
-}
-
-/* Ensure the locale select sits above right-sidebar and TOC */
-.header sl-select,
-header sl-select,
-.header [data-type="locale"],
-header [data-type="locale"] {
-  position: relative;
-  z-index: 200;
+[data-pagefind-ignore] starlight-locale-select {
+  display: none !important;
 }