From 44649ca2361f867503c1198f00d8b6f9e30ec194 Mon Sep 17 00:00:00 2001
From: Nathanial Henniges <19924836+nathanialhenniges@users.noreply.github.com>
Date: Sat, 4 Apr 2026 01:13:41 -0500
Subject: [PATCH 1/2] chore: refresh docs visual identity and document release
 checklist

- Update documentation fonts to Unbounded and Instrument Sans.
- Introduce "Midnight" theme utilities and waveform animations.
- Update hero gradients and glow effects for better visual consistency.
- Add a standardized release checklist to CLAUDE.md to guide versioning and deployment.
---
 CLAUDE.md                | 12 ++++++++++
 apps/docs/app/global.css | 51 ++++++++++++++++++++++++++++++++--------
 apps/docs/app/layout.tsx | 14 ++++++++---
 3 files changed, 64 insertions(+), 13 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index ec99410..19beaaf 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -138,3 +138,15 @@ Follows [Semantic Versioning (SemVer)](https://semver.org/) — `MAJOR.MINOR.PAT
 - **PATCH** — Bug fixes, security patches, code quality improvements
 
 Version is set in `MARKETING_VERSION` in `project.pbxproj` (4 occurrences). `CURRENT_PROJECT_VERSION` (build number) must also be incremented with each release — Sparkle uses it as the primary version comparator in appcast.xml. Git tags use `v` prefix (e.g., `v1.0.1`). The release workflow triggers on `v*` tag pushes. Homebrew cask, CHANGELOG.md, and GitHub Release notes must all be updated to match.
+
+### Release Checklist
+
+Run through every item before pushing the release tag.
+
+1. **`apps/native/wolfwave.xcodeproj/project.pbxproj`** — bump `MARKETING_VERSION` (4 occurrences) and `CURRENT_PROJECT_VERSION` (4 occurrences). Sparkle uses the build number as its primary comparator.
+2. **`CHANGELOG.md`** — add `## [X.Y.Z] - YYYY-MM-DD` entry in Keep-a-Changelog format.
+3. **`apps/docs/content/docs/changelog.mdx`** — add `## vX.Y.Z — Month DD, YYYY` entry in MDX format.
+4. **Push git tag** — `git tag vX.Y.Z && git push origin vX.Y.Z` — triggers the release workflow (builds, signs, notarizes, creates GitHub Release).
+5. **Homebrew cask** — auto-updated by `update_homebrew.yml` after the GitHub Release is created. Verify the workflow ran successfully.
+
+> After tagging, verify the GitHub Actions release workflow completes cleanly before announcing.
diff --git a/apps/docs/app/global.css b/apps/docs/app/global.css
index ac4e8de..9ec3d60 100644
--- a/apps/docs/app/global.css
+++ b/apps/docs/app/global.css
@@ -39,9 +39,17 @@
   }
 }
 
+/* Midnight background utilities */
+.bg-midnight {
+  background-color: #080810;
+}
+.bg-midnight-card {
+  background-color: #0e0e1a;
+}
+
 /* Hero gradient text */
 .gradient-text {
-  background: linear-gradient(135deg, hsl(217 91% 60%), hsl(195 90% 55%), hsl(217 91% 60%));
+  background: linear-gradient(135deg, #7c3aed, #22d3ee, #a855f7);
   background-size: 200% 200%;
   -webkit-background-clip: text;
   -webkit-text-fill-color: transparent;
@@ -64,21 +72,44 @@
   height: 500px;
   background: radial-gradient(
     ellipse at center,
-    hsla(217 91% 60% / 0.08) 0%,
-    hsla(200 90% 55% / 0.04) 40%,
+    rgba(124, 58, 237, 0.12) 0%,
+    rgba(34, 211, 238, 0.05) 45%,
     transparent 70%
   );
   pointer-events: none;
   z-index: 0;
 }
 
-.dark .hero-glow {
-  background: radial-gradient(
-    ellipse at center,
-    hsla(217 91% 60% / 0.06) 0%,
-    hsla(200 90% 55% / 0.03) 40%,
-    transparent 70%
-  );
+/* Waveform animation */
+.waveform {
+  display: flex;
+  align-items: center;
+  gap: 3px;
+  height: 48px;
+}
+
+.waveform-bar {
+  width: 4px;
+  border-radius: 2px;
+  background: linear-gradient(to top, #7c3aed, #22d3ee);
+  animation: wave-bounce var(--duration, 1.2s) ease-in-out infinite alternate;
+  animation-delay: var(--delay, 0s);
+  height: 6px;
+}
+
+@keyframes wave-bounce {
+  0%   { height: 6px; opacity: 0.4; }
+  100% { height: var(--peak, 40px); opacity: 1; }
+}
+
+/* Now Playing card pulse */
+.now-playing-pulse {
+  animation: card-pulse 3s ease-in-out infinite;
+}
+
+@keyframes card-pulse {
+  0%, 100% { box-shadow: 0 0 0 0 rgba(124, 58, 237, 0); }
+  50%       { box-shadow: 0 0 30px 4px rgba(124, 58, 237, 0.25); }
 }
 
 /* Feature cards */
diff --git a/apps/docs/app/layout.tsx b/apps/docs/app/layout.tsx
index af19354..35b9899 100644
--- a/apps/docs/app/layout.tsx
+++ b/apps/docs/app/layout.tsx
@@ -1,10 +1,18 @@
-import { Inter } from "next/font/google";
+import { Unbounded, Instrument_Sans } from "next/font/google";
 import type { Metadata } from "next";
 import { Provider } from "@/components/provider";
 import "./global.css";
 
-const inter = Inter({
+const unbounded = Unbounded({
   subsets: ["latin"],
+  variable: "--font-unbounded",
+  display: "swap",
+});
+
+const instrumentSans = Instrument_Sans({
+  subsets: ["latin"],
+  variable: "--font-instrument",
+  display: "swap",
 });
 
 export const metadata: Metadata = {
@@ -52,7 +60,7 @@ export const metadata: Metadata = {
 
 export default function Layout({ children }: LayoutProps<"/">) {
   return (
-    <html lang="en" className={inter.className} suppressHydrationWarning>
+    <html lang="en" className={`${unbounded.variable} ${instrumentSans.variable}`} suppressHydrationWarning>
       <body className="flex flex-col min-h-screen">
         <Provider>{children}</Provider>
       </body>

From 8e863f3ed6ccdb2d765aeac75bd5d8374a1db31d Mon Sep 17 00:00:00 2001
From: Nathanial Henniges <19924836+nathanialhenniges@users.noreply.github.com>
Date: Sat, 4 Apr 2026 01:17:07 -0500
Subject: [PATCH 2/2] feat(docs): redesign landing page as dark marketing page
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Full rewrite of the docs home page with a midnight-studio aesthetic
targeting streamers. Adds animated waveform bars, a pulsing Now Playing
card mockup, proof bar pills, ADHD-friendly copy, and a developer callout
section — alongside the already-committed font and CSS changes.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 apps/docs/app/(home)/page.tsx | 433 +++++++++++++++++++++++++---------
 1 file changed, 327 insertions(+), 106 deletions(-)

diff --git a/apps/docs/app/(home)/page.tsx b/apps/docs/app/(home)/page.tsx
index be673ed..92c6b9c 100644
--- a/apps/docs/app/(home)/page.tsx
+++ b/apps/docs/app/(home)/page.tsx
@@ -1,132 +1,282 @@
 import Link from "next/link";
-import { Music, MessageSquare, Radio, Wifi, Shield, Cpu, Zap, Download, BookOpen, ArrowRight } from "lucide-react";
+import { MessageSquare, Radio, Wifi, Shield, Download, ArrowRight, Github } from "lucide-react";
 import { getAssetPath } from "@/lib/utils";
 
+// Animated waveform bars — CSS-driven, no client JS needed
+function WaveformBars() {
+  const bars = [
+    { peak: "18px", duration: "0.9s", delay: "0s" },
+    { peak: "32px", duration: "1.1s", delay: "0.1s" },
+    { peak: "40px", duration: "1.3s", delay: "0.05s" },
+    { peak: "28px", duration: "0.8s", delay: "0.2s" },
+    { peak: "44px", duration: "1.2s", delay: "0.15s" },
+    { peak: "36px", duration: "1.0s", delay: "0.25s" },
+    { peak: "44px", duration: "1.4s", delay: "0.0s" },
+    { peak: "30px", duration: "0.95s", delay: "0.18s" },
+    { peak: "40px", duration: "1.15s", delay: "0.08s" },
+    { peak: "22px", duration: "1.05s", delay: "0.3s" },
+    { peak: "34px", duration: "0.85s", delay: "0.12s" },
+    { peak: "18px", duration: "1.25s", delay: "0.22s" },
+  ];
+  return (
+    <div className="waveform" aria-hidden="true">
+      {bars.map((bar, i) => (
+        <div
+          key={i}
+          className="waveform-bar"
+          style={
+            {
+              "--peak": bar.peak,
+              "--duration": bar.duration,
+              "--delay": bar.delay,
+            } as React.CSSProperties
+          }
+        />
+      ))}
+    </div>
+  );
+}
+
+// Pulsing "Now Playing" card mockup
+function NowPlayingCard() {
+  return (
+    <div
+      className="now-playing-pulse rounded-2xl border border-violet-500/30 p-4 w-64 shrink-0"
+      style={{ backgroundColor: "#0e0e1a" }}
+    >
+      <div className="flex items-center gap-3 mb-3">
+        {/* Album art placeholder */}
+        <div
+          className="w-12 h-12 rounded-lg shrink-0"
+          style={{
+            background: "linear-gradient(135deg, #7c3aed, #22d3ee)",
+            opacity: 0.9,
+          }}
+        />
+        <div className="min-w-0">
+          <p className="text-white text-sm font-semibold truncate font-[family-name:var(--font-unbounded)]">
+            Blinding Lights
+          </p>
+          <p className="text-slate-400 text-xs truncate">The Weeknd</p>
+        </div>
+      </div>
+      {/* Progress bar */}
+      <div className="h-1 rounded-full" style={{ backgroundColor: "#1e1e2e" }}>
+        <div
+          className="h-1 rounded-full"
+          style={{
+            width: "62%",
+            background: "linear-gradient(to right, #7c3aed, #22d3ee)",
+          }}
+        />
+      </div>
+      <div className="flex justify-between mt-1">
+        <span className="text-slate-500 text-xs">2:07</span>
+        <span className="text-slate-500 text-xs">3:20</span>
+      </div>
+    </div>
+  );
+}
+
 const features = [
-  {
-    icon: Music,
-    title: "Apple Music",
-    description: "Real-time track detection via ScriptingBridge. Artist, title, album, and artwork — instantly.",
-    color: "text-sky-500 dark:text-sky-400",
-    bg: "bg-sky-500/10 dark:bg-sky-500/10",
-  },
   {
     icon: MessageSquare,
     title: "Twitch Chat Bot",
-    description: "!song and !lastsong commands via Twitch's modern EventSub + Helix API. No deprecated IRC.",
-    color: "text-blue-500 dark:text-blue-400",
-    bg: "bg-blue-500/10 dark:bg-blue-500/10",
+    description:
+      "!song in chat shows exactly what's playing. Powered by Twitch's modern EventSub API.",
+    accent: "#7c3aed",
   },
   {
     icon: Radio,
-    title: "Discord Rich Presence",
-    description: "\"Listening to Apple Music\" on your Discord profile with dynamic album art and playback progress.",
-    color: "text-indigo-500 dark:text-indigo-400",
-    bg: "bg-indigo-500/10 dark:bg-indigo-500/10",
+    title: "Discord Status",
+    description:
+      "Show \"Listening to Apple Music\" with album art and live progress. Like Spotify — but your library.",
+    accent: "#22d3ee",
   },
   {
     icon: Wifi,
-    title: "Now-Playing Widget",
-    description: "Live now-playing data for OBS overlays, web widgets, and custom integrations via WebSocket.",
-    color: "text-cyan-500 dark:text-cyan-400",
-    bg: "bg-cyan-500/10 dark:bg-cyan-500/10",
+    title: "Stream Overlay",
+    description:
+      "Live now-playing data over WebSocket. Drop it into OBS, browser source, or your custom widget.",
+    accent: "#a855f7",
+  },
+  {
+    icon: Shield,
+    title: "Privacy First",
+    description:
+      "All tokens in macOS Keychain. App Sandboxed. Nothing phoned home. Your music stays yours.",
+    accent: "#7c3aed",
   },
 ] as const;
 
 const steps = [
-  { number: "1", title: "Download", description: "Grab the latest DMG from GitHub Releases." },
-  { number: "2", title: "Configure", description: "Follow the onboarding wizard to connect Twitch, Discord, and your overlays." },
-  { number: "3", title: "Enjoy", description: "Play music and it shows up on Twitch, Discord, and your widgets automatically." },
-] as const;
-
-const highlights = [
-  { icon: Zap, title: "Zero Dependencies", description: "Built entirely with native Apple frameworks. No Electron, no bloat." },
-  { icon: Shield, title: "Secure by Default", description: "All tokens in macOS Keychain. App Sandbox enabled. Hardened Runtime." },
-  { icon: Cpu, title: "Modern APIs", description: "Twitch EventSub + Helix, Discord IPC, and ScriptingBridge. No workarounds." },
+  {
+    number: "1",
+    title: "Download",
+    description: "Grab the DMG from GitHub Releases. Under 10MB.",
+  },
+  {
+    number: "2",
+    title: "Connect",
+    description: "One-time setup wizard links Twitch, Discord, and OBS.",
+  },
+  {
+    number: "3",
+    title: "Stream",
+    description: "Hit play. Everything updates automatically.",
+  },
 ] as const;
 
 export default function HomePage() {
   return (
-    <main className="flex-1">
-      {/* Hero Section */}
-      <section className="relative overflow-hidden px-6 pt-24 pb-20 sm:pt-32 sm:pb-32">
+    <main className="flex-1 bg-midnight text-white">
+      {/* Hero */}
+      <section className="relative overflow-hidden px-6 pt-24 pb-16 sm:pt-32 sm:pb-24">
         <div className="hero-glow" aria-hidden="true" />
-        <div className="mx-auto max-w-4xl text-center relative z-10">
-          <div className="mb-8 flex justify-center">
-             <div className="rounded-2xl bg-slate-900/5 dark:bg-white/5 p-4 backdrop-blur-sm ring-1 ring-slate-900/10 dark:ring-white/10 shadow-xl">
-               <img src={getAssetPath("/logo.svg")} alt="WolfWave Logo" className="h-16 w-auto" />
-             </div>
-          </div>
-          <h1 className="text-4xl sm:text-6xl lg:text-7xl font-extrabold tracking-tight leading-[1.05] mb-8">
-            <span className="gradient-text">Your Music,</span>
-            <br />
-            <span className="text-slate-900 dark:text-white">Everywhere.</span>
-          </h1>
-          <p className="text-lg sm:text-xl text-slate-600 dark:text-slate-400 leading-relaxed max-w-2xl mx-auto mb-12">
-            Native macOS menu bar app that shares your Apple Music with Twitch,
-            Discord, and now-playing widgets. Fast, lightweight, and private.
-          </p>
-          <div className="flex flex-col sm:flex-row items-center justify-center gap-4">
-            <Link
-              href="/docs/installation"
-              className="w-full sm:w-auto inline-flex items-center justify-center gap-2 bg-fd-primary text-fd-primary-foreground px-8 py-3 rounded-xl text-base font-semibold shadow-lg hover:shadow-fd-primary/20 hover:scale-[1.02] active:scale-[0.98] transition-all"
-            >
-              <Download className="w-5 h-5" />
-              Get WolfWave
-            </Link>
-            <Link
-              href="/docs"
-              className="w-full sm:w-auto inline-flex items-center justify-center gap-2 border-2 border-slate-200 dark:border-slate-800 text-slate-700 dark:text-slate-300 px-8 py-3 rounded-xl text-base font-semibold hover:bg-slate-50 dark:hover:bg-slate-800/50 hover:border-slate-300 dark:hover:border-slate-700 transition-all"
-            >
-              <BookOpen className="w-5 h-5" />
-              Documentation
-            </Link>
+        <div className="mx-auto max-w-5xl relative z-10">
+          <div className="flex flex-col lg:flex-row items-center gap-12 lg:gap-16">
+            {/* Left: text */}
+            <div className="flex-1 text-center lg:text-left">
+              {/* Version badge */}
+              <div className="inline-flex items-center gap-2 rounded-full px-3 py-1 text-xs font-medium mb-6 border"
+                style={{ borderColor: "rgba(124,58,237,0.4)", backgroundColor: "rgba(124,58,237,0.08)", color: "#a855f7" }}>
+                <span className="w-1.5 h-1.5 rounded-full bg-violet-400 animate-pulse inline-block" />
+                v1.2.0 — Free &amp; Open Source
+              </div>
+
+              <h1
+                className="text-4xl sm:text-5xl lg:text-6xl font-extrabold tracking-tight leading-[1.08] mb-6"
+                style={{ fontFamily: "var(--font-unbounded)" }}
+              >
+                <span className="gradient-text">Your Music,</span>
+                <br />
+                <span className="text-white">Live Everywhere.</span>
+              </h1>
+
+              <p className="text-slate-400 text-lg leading-relaxed max-w-md mx-auto lg:mx-0 mb-8"
+                style={{ fontFamily: "var(--font-instrument)" }}>
+                macOS menu bar app. Apple Music plays — Twitch chat, Discord,
+                and your stream overlay all update. Automatically.
+              </p>
+
+              <div className="flex flex-col sm:flex-row items-center justify-center lg:justify-start gap-3">
+                <Link
+                  href="/docs/installation"
+                  className="w-full sm:w-auto inline-flex items-center justify-center gap-2 px-7 py-3 rounded-xl text-sm font-semibold text-white transition-all hover:scale-[1.02] active:scale-[0.98]"
+                  style={{ background: "linear-gradient(135deg, #7c3aed, #a855f7)" }}
+                >
+                  <Download className="w-4 h-4" />
+                  Get Started Free
+                </Link>
+                <a
+                  href="https://github.com/mrdemonwolf/wolfwave"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                  className="w-full sm:w-auto inline-flex items-center justify-center gap-2 px-7 py-3 rounded-xl text-sm font-semibold transition-all hover:scale-[1.02]"
+                  style={{
+                    border: "1px solid rgba(255,255,255,0.12)",
+                    color: "#94a3b8",
+                    backgroundColor: "rgba(255,255,255,0.04)",
+                  }}
+                >
+                  <Github className="w-4 h-4" />
+                  View on GitHub
+                </a>
+              </div>
+            </div>
+
+            {/* Right: visual */}
+            <div className="flex flex-col items-center gap-6 shrink-0">
+              <NowPlayingCard />
+              <WaveformBars />
+              <p className="text-xs text-slate-600 tracking-wider uppercase">Live preview</p>
+            </div>
           </div>
         </div>
       </section>
 
-      {/* Features Grid */}
-      <section className="px-6 pb-24">
+      {/* Proof bar */}
+      <div className="border-y px-6 py-4" style={{ borderColor: "rgba(255,255,255,0.06)", backgroundColor: "rgba(255,255,255,0.02)" }}>
+        <div className="mx-auto max-w-5xl flex flex-wrap items-center justify-center gap-3">
+          {["Free Forever", "macOS 14+", "No Account Needed", "~10MB", "Open Source"].map((pill) => (
+            <span
+              key={pill}
+              className="text-xs font-medium px-3 py-1 rounded-full"
+              style={{ backgroundColor: "rgba(124,58,237,0.08)", color: "#94a3b8", border: "1px solid rgba(124,58,237,0.2)" }}
+            >
+              {pill}
+            </span>
+          ))}
+        </div>
+      </div>
+
+      {/* Features */}
+      <section className="px-6 py-20">
         <div className="mx-auto max-w-5xl">
-          <div className="grid sm:grid-cols-2 lg:grid-cols-4 gap-6">
+          <h2
+            className="text-2xl sm:text-3xl font-bold text-center mb-3 text-white"
+            style={{ fontFamily: "var(--font-unbounded)" }}
+          >
+            Everything a streamer needs
+          </h2>
+          <p className="text-center text-slate-500 text-sm mb-12">
+            One app. Four integrations. Zero monthly fees.
+          </p>
+          <div className="grid sm:grid-cols-2 lg:grid-cols-4 gap-5">
             {features.map((feature) => (
               <div
                 key={feature.title}
-                className="feature-card group bg-white/50 dark:bg-white/5 backdrop-blur-sm p-6 rounded-2xl border border-slate-200 dark:border-slate-800 hover:border-fd-primary/50 dark:hover:border-fd-primary/50 transition-all duration-300"
+                className="feature-card bg-midnight-card group p-5 rounded-2xl transition-all"
               >
-                <div className={`shrink-0 w-12 h-12 rounded-xl ${feature.bg} ${feature.color} inline-flex items-center justify-center mb-4 group-hover:scale-110 transition-transform`}>
-                  <feature.icon className="w-6 h-6" />
-                </div>
-                <div className="min-w-0">
-                  <h3 className="font-bold text-base text-slate-900 dark:text-white mb-2">
-                    {feature.title}
-                  </h3>
-                  <p className="text-sm text-slate-500 dark:text-slate-400 leading-relaxed">
-                    {feature.description}
-                  </p>
+                <div
+                  className="w-10 h-10 rounded-xl inline-flex items-center justify-center mb-4"
+                  style={{ backgroundColor: `${feature.accent}18`, color: feature.accent }}
+                >
+                  <feature.icon className="w-5 h-5" />
                 </div>
+                <h3 className="font-bold text-sm text-white mb-2">
+                  {feature.title}
+                </h3>
+                <p className="text-xs text-slate-500 leading-relaxed"
+                  style={{ fontFamily: "var(--font-instrument)" }}>
+                  {feature.description}
+                </p>
               </div>
             ))}
           </div>
         </div>
       </section>
 
-      {/* Get Started Steps */}
-      <section className="px-6 pb-24 bg-slate-50/50 dark:bg-slate-900/20 py-20">
-        <div className="mx-auto max-w-4xl">
-          <h2 className="text-2xl sm:text-3xl font-bold text-center mb-12 text-slate-900 dark:text-white">
-            Get Started in Minutes
+      {/* How it works */}
+      <section className="px-6 py-20" style={{ backgroundColor: "#0a0a14" }}>
+        <div className="mx-auto max-w-3xl">
+          <h2
+            className="text-2xl sm:text-3xl font-bold text-center mb-3 text-white"
+            style={{ fontFamily: "var(--font-unbounded)" }}
+          >
+            Up and running in 3 steps
           </h2>
+          <p className="text-center text-slate-500 text-sm mb-14">
+            No terminal. No config files. Just click through the wizard.
+          </p>
           <div className="grid sm:grid-cols-3 gap-8">
             {steps.map((step) => (
-              <div key={step.number} className="relative text-center group">
-                <div className="w-12 h-12 rounded-2xl bg-fd-primary text-fd-primary-foreground inline-flex items-center justify-center text-lg font-bold mb-4 shadow-lg shadow-fd-primary/20 group-hover:rotate-3 transition-transform">
+              <div key={step.number} className="text-center group">
+                <div
+                  className="w-14 h-14 rounded-2xl inline-flex items-center justify-center text-xl font-bold text-white mb-5 transition-transform group-hover:scale-110"
+                  style={{
+                    background: "linear-gradient(135deg, #7c3aed, #22d3ee)",
+                    fontFamily: "var(--font-unbounded)",
+                  }}
+                >
                   {step.number}
                 </div>
-                <h3 className="font-bold text-lg mb-2 text-slate-900 dark:text-white">
+                <h3 className="font-bold text-base text-white mb-2"
+                  style={{ fontFamily: "var(--font-unbounded)" }}>
                   {step.title}
                 </h3>
-                <p className="text-sm text-slate-500 dark:text-slate-400 leading-relaxed px-4">
+                <p className="text-sm text-slate-500 leading-relaxed"
+                  style={{ fontFamily: "var(--font-instrument)" }}>
                   {step.description}
                 </p>
               </div>
@@ -135,34 +285,105 @@ export default function HomePage() {
         </div>
       </section>
 
-      {/* Why WolfWave */}
-      <section className="px-6 py-24 border-t border-slate-100 dark:border-slate-800/50">
-        <div className="mx-auto max-w-4xl">
-          <h2 className="text-2xl sm:text-3xl font-bold text-center mb-12 text-slate-900 dark:text-white">
-            Built for Performance
-          </h2>
-          <div className="grid sm:grid-cols-3 gap-10">
-            {highlights.map((item) => (
-              <div key={item.title} className="text-center group">
-                <div className="w-14 h-14 rounded-2xl bg-slate-100 dark:bg-slate-800 text-slate-600 dark:text-slate-400 inline-flex items-center justify-center mb-4 group-hover:bg-fd-primary group-hover:text-white transition-colors duration-300">
-                  <item.icon className="w-7 h-7" />
-                </div>
-                <h3 className="font-bold text-lg mb-2 text-slate-900 dark:text-white">
-                  {item.title}
-                </h3>
-                <p className="text-sm text-slate-500 dark:text-slate-400 leading-relaxed">
-                  {item.description}
+      {/* For Developers */}
+      <section className="px-6 py-20">
+        <div className="mx-auto max-w-3xl">
+          <div
+            className="rounded-2xl p-8 border"
+            style={{
+              backgroundColor: "rgba(124,58,237,0.06)",
+              borderColor: "rgba(124,58,237,0.25)",
+            }}
+          >
+            <div className="flex items-start gap-4">
+              <div
+                className="w-10 h-10 rounded-xl shrink-0 inline-flex items-center justify-center"
+                style={{ background: "linear-gradient(135deg, #7c3aed, #22d3ee)" }}
+              >
+                <span className="text-white text-sm font-bold" style={{ fontFamily: "var(--font-unbounded)" }}>{"{}"}</span>
+              </div>
+              <div>
+                <h2 className="font-bold text-white text-lg mb-2"
+                  style={{ fontFamily: "var(--font-unbounded)" }}>
+                  For Developers
+                </h2>
+                <p className="text-slate-400 text-sm leading-relaxed mb-5"
+                  style={{ fontFamily: "var(--font-instrument)" }}>
+                  Open source, zero external dependencies, native Swift. The WebSocket API is
+                  fully documented — build your own overlay, integrate with anything, or just
+                  poke around.
                 </p>
+                <div className="flex flex-wrap gap-3">
+                  <Link
+                    href="/docs/architecture"
+                    className="inline-flex items-center gap-1.5 text-xs font-semibold text-violet-400 hover:text-violet-300 transition-colors"
+                  >
+                    Architecture
+                    <ArrowRight className="w-3 h-3" />
+                  </Link>
+                  <Link
+                    href="/docs/development"
+                    className="inline-flex items-center gap-1.5 text-xs font-semibold text-violet-400 hover:text-violet-300 transition-colors"
+                  >
+                    Development Guide
+                    <ArrowRight className="w-3 h-3" />
+                  </Link>
+                  <Link
+                    href="/docs/security"
+                    className="inline-flex items-center gap-1.5 text-xs font-semibold text-violet-400 hover:text-violet-300 transition-colors"
+                  >
+                    Security
+                    <ArrowRight className="w-3 h-3" />
+                  </Link>
+                </div>
               </div>
-            ))}
+            </div>
+          </div>
+        </div>
+      </section>
+
+      {/* CTA Footer */}
+      <section className="px-6 py-24 text-center" style={{ backgroundColor: "#080810" }}>
+        <div className="mx-auto max-w-2xl">
+          {/* Logo */}
+          <div className="flex justify-center mb-6">
+            <div
+              className="rounded-2xl p-3"
+              style={{ backgroundColor: "rgba(255,255,255,0.04)", border: "1px solid rgba(255,255,255,0.08)" }}
+            >
+              <img src={getAssetPath("/logo.svg")} alt="WolfWave" className="h-10 w-auto" />
+            </div>
           </div>
-          <div className="text-center mt-16">
+          <h2
+            className="text-3xl sm:text-4xl font-extrabold text-white mb-4"
+            style={{ fontFamily: "var(--font-unbounded)" }}
+          >
+            Start streaming smarter.
+          </h2>
+          <p className="text-slate-500 text-base mb-10"
+            style={{ fontFamily: "var(--font-instrument)" }}>
+            Free forever. No account. Just music.
+          </p>
+          <div className="flex flex-col sm:flex-row items-center justify-center gap-3">
+            <Link
+              href="/docs/installation"
+              className="w-full sm:w-auto inline-flex items-center justify-center gap-2 px-8 py-3.5 rounded-xl text-sm font-semibold text-white transition-all hover:scale-[1.02] active:scale-[0.98]"
+              style={{ background: "linear-gradient(135deg, #7c3aed, #a855f7)" }}
+            >
+              <Download className="w-4 h-4" />
+              Download WolfWave
+            </Link>
             <Link
               href="/docs"
-              className="inline-flex items-center gap-2 text-base text-fd-primary hover:gap-3 transition-all font-semibold"
+              className="w-full sm:w-auto inline-flex items-center justify-center gap-2 px-8 py-3.5 rounded-xl text-sm font-semibold transition-all hover:scale-[1.02]"
+              style={{
+                border: "1px solid rgba(255,255,255,0.1)",
+                color: "#94a3b8",
+                backgroundColor: "rgba(255,255,255,0.03)",
+              }}
             >
-              Explore the documentation
-              <ArrowRight className="w-5 h-5" />
+              Read the Docs
+              <ArrowRight className="w-4 h-4" />
             </Link>
           </div>
         </div>