diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 3f4037f..358f66a 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -1,81 +1,43 @@
-import { defineConfig } from 'vitepress'
+import { createConfig } from '@codecora/theme/vitepress/config'
 
-export default defineConfig({
+export default createConfig({
+  product: 'cora',
   title: 'Cora',
   description: 'AI-Powered Code Review CLI — BYOK, zero config, runs in your terminal',
-  base: '/docs/cora/',
-
+  accent: 'green',
+  repo: 'cora-cli',
   head: [
-    ['link', { rel: 'icon', type: 'image/svg+xml', href: '/favicon.svg' }],
-    ['link', { rel: 'alternate icon', type: 'image/png', href: '/favicon.png' }],
-    ['meta', { name: 'theme-color', content: '#6366f1' }],
-    ['meta', { property: 'og:type', content: 'website' }],
     ['meta', { property: 'og:title', content: 'Cora — AI Code Review CLI' }],
     ['meta', { property: 'og:description', content: 'BYOK, zero config, runs in your terminal' }],
-    ['meta', { property: 'og:image', content: 'https://codecora.dev/docs/cora/og.png' }],
-    ['meta', { property: 'og:url', content: 'https://codecora.dev/docs/cora/' }],
   ],
-
-  themeConfig: {
-    logo: '/logo.svg',
-
-    nav: [
-      { text: 'Codecora', link: 'https://codecora.dev' },
-      { text: 'Docs', link: '/getting-started' },
-      { text: 'Examples', link: '/examples' },
-      { text: 'Changelog', link: '/changelog' },
-      { text: 'GitHub', link: 'https://github.com/codecoradev/cora-cli' },
-    ],
-
-    sidebar: {
-      '/': [
-        {
-          text: 'Getting Started',
-          items: [
-            { text: 'Quick Start', link: '/getting-started' },
-            { text: 'Installation', link: '/installation' },
-          ],
-        },
-        {
-          text: 'Guides',
-          items: [
-            { text: 'Usage', link: '/usage' },
-            { text: 'Configuration', link: '/configuration' },
-            { text: 'Providers', link: '/providers' },
-            { text: 'CLI Reference', link: '/cli-reference' },
-            { text: 'Examples', link: '/examples' },
-          ],
-        },
-        {
-          text: 'Project',
-          items: [
-            { text: 'Changelog', link: '/changelog' },
-            { text: 'Roadmap', link: '/roadmap' },
-          ],
-        },
-      ],
-    },
-
-    search: {
-      provider: 'local',
-    },
-
-    socialLinks: [
-      { icon: 'github', link: 'https://github.com/codecoradev/cora-cli' },
-    ],
-
-    footer: {
-      message: 'Released under the <a href="https://github.com/codecoradev/cora-cli/blob/develop/LICENSE">MIT License</a>.',
-      copyright: '© 2025-present codecoradev',
-    },
-
-    editLink: {
-      pattern: 'https://github.com/codecoradev/cora-cli/edit/develop/docs/:path',
-      text: 'Edit this page on GitHub',
-    },
-  },
-
   lastUpdated: true,
-
   ignoreDeadLinks: [/^https?:\/\/localhost/],
+  sidebar: {
+    '/': [
+      {
+        text: 'Getting Started',
+        items: [
+          { text: 'Quick Start', link: '/getting-started' },
+          { text: 'Installation', link: '/installation' },
+        ],
+      },
+      {
+        text: 'Guides',
+        items: [
+          { text: 'Usage', link: '/usage' },
+          { text: 'Configuration', link: '/configuration' },
+          { text: 'Providers', link: '/providers' },
+          { text: 'CLI Reference', link: '/cli-reference' },
+          { text: 'Examples', link: '/examples' },
+        ],
+      },
+      {
+        text: 'Project',
+        items: [
+          { text: 'Changelog', link: '/changelog' },
+          { text: 'Roadmap', link: '/roadmap' },
+        ],
+      },
+    ],
+  },
 })
diff --git a/docs/.vitepress/theme/components/FadeIn.vue b/docs/.vitepress/theme/components/FadeIn.vue
deleted file mode 100644
index 7c13e79..0000000
--- a/docs/.vitepress/theme/components/FadeIn.vue
+++ /dev/null
@@ -1,58 +0,0 @@
-<script setup>
-import { ref, onMounted, onUnmounted } from 'vue'
-
-const props = defineProps({
-  tag: { type: String, default: 'div' },
-  delay: { type: Number, default: 0 },
-  duration: { type: Number, default: 600 },
-  direction: { type: String, default: 'up' }, // up, down, left, right
-  distance: { type: Number, default: 24 },
-  once: { type: Boolean, default: true },
-})
-
-const elRef = ref(null)
-const isVisible = ref(false)
-let observer = null
-
-onMounted(() => {
-  observer = new IntersectionObserver(
-    (entries) => {
-      entries.forEach((entry) => {
-        if (entry.isIntersecting) {
-          setTimeout(() => { isVisible.value = true }, props.delay)
-          if (props.once) observer?.unobserve(entry.target)
-        } else if (!props.once) {
-          isVisible.value = false
-        }
-      })
-    },
-    { threshold: 0.1 }
-  )
-  if (elRef.value) observer.observe(elRef.value)
-})
-
-onUnmounted(() => {
-  observer?.disconnect()
-})
-
-const translateMap = {
-  up: `translateY(${props.distance}px)`,
-  down: `translateY(-${props.distance}px)`,
-  left: `translateX(${props.distance}px)`,
-  right: `translateX(-${props.distance}px)`,
-}
-</script>
-
-<template>
-  <component
-    :is="tag"
-    ref="elRef"
-    :style="{
-      opacity: isVisible ? 1 : 0,
-      transform: isVisible ? 'translate(0)' : translateMap[direction],
-      transition: `opacity ${duration}ms cubic-bezier(0.16, 1, 0.3, 1), transform ${duration}ms cubic-bezier(0.16, 1, 0.3, 1)`,
-    }"
-  >
-    <slot />
-  </component>
-</template>
diff --git a/docs/.vitepress/theme/components/LandingPage.vue b/docs/.vitepress/theme/components/LandingPage.vue
deleted file mode 100644
index 976b3ff..0000000
--- a/docs/.vitepress/theme/components/LandingPage.vue
+++ /dev/null
@@ -1,488 +0,0 @@
-<script setup>
-import { ref, onMounted, onUnmounted } from 'vue'
-import TypingText from './TypingText.vue'
-import TerminalDemo from './TerminalDemo.vue'
-import FadeIn from './FadeIn.vue'
-</script>
-
-<template>
-  <div class="landing">
-    <!-- Hero Section -->
-    <section class="hero">
-      <div class="hero-inner">
-        <div class="hero-badge">🧪 Open Source · MIT License</div>
-        <img src="/logo.svg" alt="cora" class="hero-logo" />
-        <h1 class="hero-title">
-          AI Code Review
-          <br />
-          <span class="hero-brand">in your terminal</span>
-        </h1>
-        <p class="hero-subtitle">
-          <TypingText
-            :phrases="[
-              '$ cora review --staged',
-              '$ cora review --base main',
-              '$ cora scan --incremental',
-              '$ cora hook install',
-            ]"
-            :typing-speed="45"
-            :deleting-speed="25"
-            :pause-duration="2500"
-          />
-        </p>
-        <div class="hero-actions">
-          <a href="/getting-started" class="btn btn-primary">Get Started →</a>
-          <a href="https://github.com/codecoradev/cora-cli" class="btn btn-secondary" target="_blank">GitHub</a>
-        </div>
-      </div>
-
-      <FadeIn :delay="400" direction="up" :distance="40">
-        <TerminalDemo :lines="[
-          { prefix: '$', text: 'cora review --staged', type: 'cmd' },
-          { text: '', type: 'muted' },
-          { prefix: '✓', text: ' src/auth/login.rs — 2 issues found', type: 'success' },
-          { prefix: '  ⚠', text: ' Line 42: Potential SQL injection', type: 'warning' },
-          { prefix: '  ⚠', text: ' Line 87: Hardcoded secret detected', type: 'warning' },
-          { prefix: '✓', text: ' src/utils/parser.rs — clean', type: 'success' },
-          { prefix: '✓', text: ' src/api/routes.rs — 1 issue found', type: 'success' },
-          { prefix: '  ✗', text: ' Line 23: Missing error handling', type: 'error' },
-          { text: '', type: 'muted' },
-          { text: '3 issues found in 3 files (1.2s)', type: 'muted' },
-        ]" />
-      </FadeIn>
-    </section>
-
-    <!-- Stats Bar -->
-    <FadeIn :delay="200">
-      <section class="stats-bar">
-        <div class="stat">
-          <span class="stat-value">🦀</span>
-          <span class="stat-label">Rust Native</span>
-        </div>
-        <div class="stat">
-          <span class="stat-value">6+</span>
-          <span class="stat-label">LLM Providers</span>
-        </div>
-        <div class="stat">
-          <span class="stat-value">12</span>
-          <span class="stat-label">Built-in Rules</span>
-        </div>
-        <div class="stat">
-          <span class="stat-value">4</span>
-          <span class="stat-label">Platforms</span>
-        </div>
-        <div class="stat">
-          <span class="stat-value">0ms</span>
-          <span class="stat-label">Cold Start</span>
-        </div>
-      </section>
-    </FadeIn>
-
-    <!-- Install Section -->
-    <FadeIn :delay="100">
-      <section class="install-section">
-        <h2>Install in 5 seconds</h2>
-        <div class="install-cmd">
-          <code>curl -fsSL https://raw.githubusercontent.com/codecoradev/cora-cli/main/install.sh | sh</code>
-        </div>
-      </section>
-    </FadeIn>
-
-    <!-- How It Works -->
-    <section class="how-it-works">
-      <h2>How it works</h2>
-      <div class="steps">
-        <FadeIn :delay="0">
-          <div class="step">
-            <div class="step-number">1</div>
-            <h3>Install</h3>
-            <p>Single binary, no runtime dependencies. One command to install.</p>
-          </div>
-        </FadeIn>
-        <FadeIn :delay="150">
-          <div class="step">
-            <div class="step-number">2</div>
-            <h3>Authenticate</h3>
-            <p><code>cora auth login</code> — pick your LLM provider, enter API key. Done.</p>
-          </div>
-        </FadeIn>
-        <FadeIn :delay="300">
-          <div class="step">
-            <div class="step-number">3</div>
-            <h3>Review</h3>
-            <p><code>cora review</code> — get instant AI feedback on your staged changes.</p>
-          </div>
-        </FadeIn>
-      </div>
-    </section>
-
-    <!-- CTA -->
-    <FadeIn>
-      <section class="cta">
-        <h2>Start reviewing code in seconds</h2>
-        <p>No signup, no subscription. Your code never leaves your machine.</p>
-        <div class="cta-actions">
-          <a href="/getting-started" class="btn btn-primary">Read the Docs →</a>
-          <a href="/examples" class="btn btn-secondary">See Examples</a>
-        </div>
-      </section>
-    </FadeIn>
-  </div>
-</template>
-
-<style scoped>
-.landing {
-  max-width: 960px;
-  margin: 0 auto;
-  padding: 0 24px;
-}
-
-/* Hero */
-.hero {
-  text-align: center;
-  padding: 80px 0 60px;
-}
-
-.hero-inner {
-  margin-bottom: 48px;
-}
-
-.hero-badge {
-  display: inline-block;
-  padding: 6px 16px;
-  border-radius: 100px;
-  font-size: 13px;
-  font-weight: 500;
-  background: var(--vp-c-brand-soft);
-  color: var(--vp-c-brand-1);
-  margin-bottom: 24px;
-  animation: fadeIn 0.6s ease-out;
-}
-
-.hero-logo {
-  display: block;
-  width: 80px;
-  height: 80px;
-  margin: 0 auto 20px;
-  animation: float 3s ease-in-out infinite;
-}
-
-.hero-title {
-  font-size: 48px;
-  font-weight: 800;
-  line-height: 1.15;
-  letter-spacing: -0.02em;
-  margin: 0 0 20px;
-  animation: fadeIn 0.6s ease-out 0.1s both;
-}
-
-.hero-brand {
-  background: linear-gradient(135deg, var(--vp-c-brand-1), #c084fc);
-  -webkit-background-clip: text;
-  background-clip: text;
-  -webkit-text-fill-color: transparent;
-}
-
-.hero-subtitle {
-  font-size: 18px;
-  color: var(--vp-c-text-2);
-  margin: 0 0 32px;
-  min-height: 28px;
-  font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
-  animation: fadeIn 0.6s ease-out 0.2s both;
-}
-
-.hero-actions {
-  display: flex;
-  gap: 12px;
-  justify-content: center;
-  animation: fadeIn 0.6s ease-out 0.3s both;
-}
-
-/* Buttons */
-.btn {
-  display: inline-flex;
-  align-items: center;
-  padding: 10px 24px;
-  border-radius: 8px;
-  font-size: 15px;
-  font-weight: 600;
-  text-decoration: none;
-  transition: all 0.2s ease;
-}
-
-.btn-primary {
-  background: var(--vp-c-brand-2);
-  color: #fff;
-  box-shadow: 0 2px 12px rgba(99, 102, 241, 0.3);
-}
-
-.btn-primary:hover {
-  background: var(--vp-c-brand-1);
-  box-shadow: 0 4px 20px rgba(99, 102, 241, 0.4);
-  transform: translateY(-1px);
-}
-
-.btn-secondary {
-  background: var(--vp-c-bg-soft);
-  color: var(--vp-c-text-1);
-  border: 1px solid var(--vp-c-divider);
-}
-
-.btn-secondary:hover {
-  background: var(--vp-c-bg-mute);
-  border-color: var(--vp-c-brand-1);
-}
-
-/* Stats */
-.stats-bar {
-  display: flex;
-  justify-content: center;
-  gap: 40px;
-  padding: 32px 0;
-  margin: 0 -24px;
-  border-top: 1px solid var(--vp-c-divider);
-  border-bottom: 1px solid var(--vp-c-divider);
-}
-
-.stat {
-  text-align: center;
-}
-
-.stat-value {
-  display: block;
-  font-size: 24px;
-  font-weight: 800;
-  color: var(--vp-c-brand-1);
-}
-
-.stat-label {
-  display: block;
-  font-size: 13px;
-  color: var(--vp-c-text-3);
-  margin-top: 4px;
-}
-
-/* Install */
-.install-section {
-  text-align: center;
-  padding: 60px 0;
-}
-
-.install-section h2 {
-  font-size: 24px;
-  font-weight: 700;
-  margin: 0 0 20px;
-}
-
-.install-cmd {
-  display: inline-block;
-  background: var(--vp-c-black);
-  padding: 16px 28px;
-  border-radius: 10px;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-}
-
-.install-cmd code {
-  font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
-  font-size: 14px;
-  color: #e6edf3;
-}
-
-/* How It Works */
-.how-it-works {
-  padding: 60px 0;
-  text-align: center;
-}
-
-.how-it-works h2 {
-  font-size: 24px;
-  font-weight: 700;
-  margin: 0 0 40px;
-}
-
-.steps {
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 32px;
-}
-
-.step {
-  background: var(--vp-c-bg-soft);
-  border: 1px solid var(--vp-c-divider);
-  border-radius: 12px;
-  padding: 32px 24px;
-  transition: all 0.3s ease;
-}
-
-.step:hover {
-  border-color: var(--vp-c-brand-1);
-  box-shadow: 0 8px 30px rgba(99, 102, 241, 0.1);
-  transform: translateY(-2px);
-}
-
-.step-number {
-  width: 40px;
-  height: 40px;
-  border-radius: 10px;
-  background: var(--vp-c-brand-soft);
-  color: var(--vp-c-brand-1);
-  font-size: 18px;
-  font-weight: 800;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  margin: 0 auto 16px;
-}
-
-.step h3 {
-  font-size: 18px;
-  font-weight: 700;
-  margin: 0 0 8px;
-}
-
-.step p {
-  color: var(--vp-c-text-2);
-  font-size: 14px;
-  line-height: 1.6;
-  margin: 0;
-}
-
-.step code {
-  font-size: 13px;
-  padding: 2px 6px;
-  border-radius: 4px;
-  background: var(--vp-c-bg-mute);
-}
-
-/* CTA */
-.cta {
-  text-align: center;
-  padding: 60px 0 80px;
-}
-
-.cta h2 {
-  font-size: 28px;
-  font-weight: 800;
-  margin: 0 0 12px;
-}
-
-.cta p {
-  color: var(--vp-c-text-2);
-  margin: 0 0 28px;
-}
-
-.cta-actions {
-  display: flex;
-  gap: 12px;
-  justify-content: center;
-}
-
-/* Animations */
-@keyframes fadeIn {
-  from { opacity: 0; transform: translateY(16px); }
-  to { opacity: 1; transform: translateY(0); }
-}
-
-@keyframes float {
-  0%, 100% { transform: translateY(0); }
-  50% { transform: translateY(-6px); }
-}
-
-/* Responsive */
-@media (max-width: 768px) {
-  .landing {
-    padding: 0 16px;
-  }
-
-  .hero {
-    padding: 48px 0 40px;
-  }
-
-  .hero-title {
-    font-size: 28px;
-  }
-
-  .hero-logo {
-    display: block;
-    width: 64px;
-    height: 64px;
-    margin: 0 auto 16px;
-  }
-
-  .hero-badge {
-    font-size: 12px;
-    padding: 4px 12px;
-  }
-
-  .hero-subtitle {
-    font-size: 14px;
-  }
-
-  .hero-actions,
-  .cta-actions {
-    flex-direction: column;
-    align-items: stretch;
-    gap: 10px;
-  }
-
-  .btn {
-    justify-content: center;
-    padding: 12px 20px;
-    font-size: 15px;
-  }
-
-  .stats-bar {
-    gap: 16px;
-    flex-wrap: wrap;
-    padding: 24px 0;
-  }
-
-  .stat-value {
-    font-size: 18px;
-  }
-
-  .stat-label {
-    font-size: 11px;
-  }
-
-  .install-cmd {
-    padding: 12px 16px;
-    max-width: 100%;
-    overflow-x: auto;
-    -webkit-overflow-scrolling: touch;
-  }
-
-  .install-cmd code {
-    font-size: 11px;
-    white-space: nowrap;
-  }
-
-  .steps {
-    grid-template-columns: 1fr;
-    gap: 16px;
-  }
-
-  .step {
-    padding: 24px 20px;
-  }
-
-  .cta h2 {
-    font-size: 22px;
-  }
-}
-
-@media (max-width: 480px) {
-  .hero-title {
-    font-size: 24px;
-  }
-
-  .stats-bar {
-    gap: 12px;
-  }
-
-  .stat {
-    min-width: 60px;
-  }
-}
-</style>
diff --git a/docs/.vitepress/theme/components/TerminalDemo.vue b/docs/.vitepress/theme/components/TerminalDemo.vue
deleted file mode 100644
index 46d440b..0000000
--- a/docs/.vitepress/theme/components/TerminalDemo.vue
+++ /dev/null
@@ -1,166 +0,0 @@
-<script setup>
-import { ref, onMounted, onUnmounted } from 'vue'
-
-const props = defineProps({
-  lines: { type: Array, required: true },
-  speed: { type: Number, default: 40 },
-  loop: { type: Boolean, default: false },
-})
-
-const visibleLines = ref([])
-const containerRef = ref(null)
-let timer = null
-
-onMounted(() => {
-  let i = 0
-  function showNext() {
-    if (i < props.lines.length) {
-      visibleLines.value.push(props.lines[i])
-      i++
-      timer = setTimeout(showNext, props.speed)
-    } else if (props.loop) {
-      timer = setTimeout(() => {
-        visibleLines.value = []
-        i = 0
-        showNext()
-      }, 3000)
-    }
-  }
-  showNext()
-})
-
-onUnmounted(() => {
-  if (timer) clearTimeout(timer)
-})
-</script>
-
-<template>
-  <div ref="containerRef" class="terminal">
-    <div class="terminal-bar">
-      <span class="dot red"></span>
-      <span class="dot yellow"></span>
-      <span class="dot green"></span>
-    </div>
-    <div class="terminal-body">
-      <div
-        v-for="(line, idx) in visibleLines"
-        :key="idx"
-        class="terminal-line"
-        :class="[line.type || '']"
-      >
-        <span v-if="line.prefix" class="prefix">{{ line.prefix }}</span>
-        <span v-html="line.text" />
-      </div>
-    </div>
-  </div>
-</template>
-
-<style scoped>
-.terminal {
-  background: var(--vp-c-black);
-  border-radius: 12px;
-  overflow: hidden;
-  border: 1px solid rgba(255, 255, 255, 0.08);
-  box-shadow: 0 20px 60px rgba(0, 0, 0, 0.4);
-}
-
-.terminal-bar {
-  display: flex;
-  gap: 6px;
-  padding: 10px 14px;
-  background: rgba(255, 255, 255, 0.04);
-  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
-}
-
-.dot {
-  width: 12px;
-  height: 12px;
-  border-radius: 50%;
-}
-
-.dot.red { background: #ff5f57; }
-.dot.yellow { background: #febc2e; }
-.dot.green { background: #28c840; }
-
-.terminal-body {
-  padding: 16px 20px;
-  font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
-  font-size: 13px;
-  line-height: 1.7;
-  min-height: 120px;
-}
-
-.terminal-line {
-  color: #c9d1d9;
-  animation: fadeIn 0.15s ease-out;
-}
-
-.terminal-line .prefix {
-  margin-right: 8px;
-}
-
-.terminal-line.cmd .prefix {
-  color: #58a6ff;
-  font-weight: 600;
-}
-
-.terminal-line.success .prefix {
-  color: #3fb950;
-}
-
-.terminal-line.warning .prefix {
-  color: #d29922;
-}
-
-.terminal-line.error .prefix {
-  color: #f85149;
-}
-
-.terminal-line.muted {
-  color: #8b949e;
-}
-
-.terminal-line.highlight {
-  color: #58a6ff;
-}
-
-.terminal-line.dim {
-  color: #484f58;
-}
-
-@keyframes fadeIn {
-  from { opacity: 0; transform: translateY(4px); }
-  to { opacity: 1; transform: translateY(0); }
-}
-
-@media (max-width: 768px) {
-  .terminal {
-    border-radius: 8px;
-  }
-
-  .terminal-body {
-    padding: 12px 14px;
-    font-size: 11px;
-    line-height: 1.6;
-    min-height: 80px;
-    overflow-x: auto;
-    -webkit-overflow-scrolling: touch;
-  }
-
-  .terminal-bar {
-    padding: 8px 12px;
-  }
-
-  .dot {
-    width: 10px;
-    height: 10px;
-  }
-}
-
-@media (max-width: 480px) {
-  .terminal-body {
-    font-size: 10px;
-    padding: 10px;
-  }
-}
-</style>
diff --git a/docs/.vitepress/theme/components/TypingText.vue b/docs/.vitepress/theme/components/TypingText.vue
deleted file mode 100644
index 91e618d..0000000
--- a/docs/.vitepress/theme/components/TypingText.vue
+++ /dev/null
@@ -1,66 +0,0 @@
-<script setup>
-import { ref, onMounted, onUnmounted } from 'vue'
-
-const props = defineProps({
-  phrases: { type: Array, required: true },
-  typingSpeed: { type: Number, default: 50 },
-  deletingSpeed: { type: Number, default: 30 },
-  pauseDuration: { type: Number, default: 2000 },
-})
-
-const display = ref('')
-const phraseIndex = ref(0)
-let charIndex = 0
-let isDeleting = false
-let timer = null
-
-function tick() {
-  const current = props.phrases[phraseIndex.value]
-  
-  if (!isDeleting) {
-    display.value = current.slice(0, charIndex + 1)
-    charIndex++
-    if (charIndex >= current.length) {
-      isDeleting = true
-      timer = setTimeout(tick, props.pauseDuration)
-      return
-    }
-  } else {
-    display.value = current.slice(0, charIndex - 1)
-    charIndex--
-    if (charIndex <= 0) {
-      isDeleting = false
-      phraseIndex.value = (phraseIndex.value + 1) % props.phrases.length
-    }
-  }
-  
-  timer = setTimeout(tick, isDeleting ? props.deletingSpeed : props.typingSpeed)
-}
-
-onMounted(() => {
-  timer = setTimeout(tick, 500)
-})
-
-onUnmounted(() => {
-  if (timer) clearTimeout(timer)
-})
-</script>
-
-<template>
-  <span class="typing-text">{{ display }}<span class="cursor">▊</span></span>
-</template>
-
-<style scoped>
-.typing-text {
-  font-family: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace;
-}
-
-.cursor {
-  animation: blink 1s step-end infinite;
-  color: var(--vp-c-brand-1);
-}
-
-@keyframes blink {
-  50% { opacity: 0; }
-}
-</style>
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
index c736be7..4ed2add 100644
--- a/docs/.vitepress/theme/index.ts
+++ b/docs/.vitepress/theme/index.ts
@@ -1,13 +1,4 @@
 import DefaultTheme from 'vitepress/theme'
-import { h } from 'vue'
-import LandingPage from './components/LandingPage.vue'
-import './style.css'
+import '@codecora/theme/vitepress/style.css'
 
-export default {
-  extends: DefaultTheme,
-  Layout() {
-    return h(DefaultTheme.Layout, null, {
-      'home-hero-before': () => h(LandingPage),
-    })
-  },
-}
+export default { extends: DefaultTheme }
diff --git a/docs/.vitepress/theme/style.css b/docs/.vitepress/theme/style.css
deleted file mode 100644
index c07774c..0000000
--- a/docs/.vitepress/theme/style.css
+++ /dev/null
@@ -1,41 +0,0 @@
-/* cora brand overrides — dark-first */
-:root {
-  --vp-c-brand-1: #818cf8;
-  --vp-c-brand-2: #6366f1;
-  --vp-c-brand-3: #4f46e5;
-  --vp-c-brand-soft: rgba(99, 102, 241, 0.14);
-}
-
-/* Dark mode (default) */
-.dark {
-  --vp-c-brand-1: #a5b4fc;
-  --vp-c-brand-2: #818cf8;
-  --vp-c-brand-3: #6366f1;
-  --vp-c-brand-soft: rgba(129, 140, 248, 0.14);
-}
-
-/* Hero gradient */
-.VPHero .name clip {
-  background: linear-gradient(135deg, #818cf8, #c084fc);
-  -webkit-background-clip: text;
-  background-clip: text;
-}
-
-/* Slightly wider content area */
-.VPDoc .content-container {
-  max-width: 800px !important;
-}
-
-/* Code blocks — slightly rounded */
-.vp-code-group .tabs {
-  border-radius: 8px 8px 0 0;
-}
-
-/* Feature grid spacing on landing page */
-.VPFeatures .container {
-  max-width: 1152px;
-}
-
-.VPFeature {
-  padding: 16px;
-}
diff --git a/docs/package-lock.json b/docs/package-lock.json
index f02a60a..b99d2dd 100644
--- a/docs/package-lock.json
+++ b/docs/package-lock.json
@@ -6,6 +6,7 @@
     "": {
       "name": "cora-docs",
       "devDependencies": {
+        "@codecora/theme": "github:codecoradev/codecora-theme#feat/add-ci-workflow",
         "vitepress": "^1.6.3",
         "vue": "^3.5.13"
       }
@@ -296,6 +297,20 @@
         "node": ">=6.9.0"
       }
     },
+    "node_modules/@codecora/theme": {
+      "version": "0.1.0",
+      "resolved": "git+ssh://git@github.com/codecoradev/codecora-theme.git#bbde4c21afd92f7410a21d4a4d8f45f70daddb03",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peerDependencies": {
+        "vitepress": "^1.0.0"
+      },
+      "peerDependenciesMeta": {
+        "vitepress": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/@docsearch/css": {
       "version": "3.8.2",
       "resolved": "https://registry.npmjs.org/@docsearch/css/-/css-3.8.2.tgz",
diff --git a/docs/package.json b/docs/package.json
index fa37eeb..97ee615 100644
--- a/docs/package.json
+++ b/docs/package.json
@@ -7,6 +7,7 @@
     "docs:preview": "vitepress preview"
   },
   "devDependencies": {
+    "@codecora/theme": "github:codecoradev/codecora-theme#feat/add-ci-workflow",
     "vitepress": "^1.6.3",
     "vue": "^3.5.13"
   }
diff --git a/docs/providers.md b/docs/providers.md
index 4eccf7d..3ba2843 100644
--- a/docs/providers.md
+++ b/docs/providers.md
@@ -13,7 +13,7 @@ cora supports multiple AI providers. Use your own API key — no subscriptions t
 | OpenAI | `gpt-4o-mini` | `OPENAI_API_KEY` | `OPENAI_BASE_URL` |
 | Anthropic | `claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` | `ANTHROPIC_BASE_URL` |
 | Groq | `llama-3.1-8b-instant` | `GROQ_API_KEY` | `GROQ_BASE_URL` |
-| Ollama | `llama3.1` | — (local) | `OLLAMA_HOST` (default: http://localhost:11434) |
+| Ollama | `llama3.1` | — (local) | `OLLAMA_HOST` (default: `http://localhost:11434`) |
 | Z.AI | `glm-5.1` | `ZAI_API_KEY` | `ZAI_BASE_URL` |
 
 ## Auto-Detection