Cognipeer · Bor4brn · Mar 16, 2026
diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
@@ -2,13 +2,17 @@ import { defineConfig } from 'vitepress';
 
 export default defineConfig({
   title: 'Agent Server',
-  description: 'REST API server infrastructure for AI agents - supports agent-sdk and custom implementations',
+  description: 'REST API server infrastructure for AI agents with storage, auth, streaming, and framework adapters.',
   base: '/agent-server/',
   ignoreDeadLinks: true,
+  appearance: false,
+
   themeConfig: {
-    logo: '/logo.svg',
+    logo: '/AgentServer.svg',
+    siteTitle: 'Agent Server',
     nav: [
       { text: 'Guide', link: '/guide/getting-started' },
+      { text: 'Architecture', link: '/guide/architecture' },
       { text: 'API Reference', link: '/api/server' },
       { text: 'Examples', link: '/examples/' },
       {
@@ -34,16 +38,20 @@ export default defineConfig({
           items: [
             { text: 'Express.js', link: '/guide/express' },
             { text: 'Next.js', link: '/guide/nextjs' },
+            { text: 'Custom Adapters', link: '/guide/custom-adapters' },
+            { text: 'Client Integration', link: '/guide/client-integration' },
           ],
         },
         {
           text: 'Features',
           items: [
             { text: 'Storage Providers', link: '/guide/storage' },
             { text: 'Authentication', link: '/guide/authentication' },
+            { text: 'Conversations & Messages', link: '/guide/conversations-messages' },
             { text: 'File Management', link: '/guide/file-management' },
             { text: 'Streaming', link: '/guide/streaming' },
             { text: 'Swagger UI', link: '/guide/swagger' },
+            { text: 'AI Providers', link: '/guide/ai-providers' },
           ],
         },
         {
@@ -86,16 +94,19 @@ export default defineConfig({
       { icon: 'github', link: 'https://github.com/Cognipeer/agent-server' },
     ],
     footer: {
-      message: 'Released under the MIT License.',
-      copyright: 'Copyright © 2025 CognipeerAI',
+      message: 'Agent Server is part of the Cognipeer platform.',
+      copyright: 'Copyright © 2026 Cognipeer',
     },
     search: {
       provider: 'local',
     },
   },
   head: [
-    ['link', { rel: 'icon', type: 'image/svg+xml', href: '/agent-server/favicon.svg' }],
-    ['meta', { name: 'theme-color', content: '#3eaf7c' }],
+    ['link', { rel: 'preconnect', href: 'https://fonts.googleapis.com' }],
+    ['link', { rel: 'preconnect', href: 'https://fonts.gstatic.com', crossorigin: '' }],
+    ['link', { rel: 'stylesheet', href: 'https://fonts.googleapis.com/css2?family=Lexend+Deca:wght@400;500;600;700;800&display=swap' }],
+    ['link', { rel: 'icon', type: 'image/svg+xml', href: '/agent-server/AgentServer.svg' }],
+    ['meta', { name: 'theme-color', content: '#00b5a5' }],
     ['meta', { name: 'og:type', content: 'website' }],
     ['meta', { name: 'og:locale', content: 'en' }],
     ['meta', { name: 'og:site_name', content: 'Agent Server Documentation' }],

diff --git a/docs/.vitepress/theme/custom.css b/docs/.vitepress/theme/custom.css
@@ -0,0 +1,210 @@
+:root {
+  --vp-font-family-base: 'Lexend Deca', 'Segoe UI', sans-serif;
+  --vp-font-family-mono: 'SFMono-Regular', 'SF Mono', 'Menlo', 'Monaco', 'Consolas', monospace;
+
+  --cp-c-ink-1: #212b57;
+  --cp-c-ink-2: #3f4d79;
+  --cp-c-ink-3: #6f7c99;
+  --cp-c-link-1: #1e3d74;
+  --cp-c-link-2: #17305d;
+
+  --vp-c-brand-1: #00b5a5;
+  --vp-c-brand-2: #009689;
+  --vp-c-brand-3: #007c70;
+  --vp-c-brand-soft: rgba(0, 181, 165, 0.14);
+
+  --vp-c-text-1: var(--cp-c-ink-1);
+  --vp-c-text-2: var(--cp-c-ink-2);
+  --vp-c-text-3: var(--cp-c-ink-3);
+
+  --vp-c-bg: #f7f8f8;
+  --vp-c-bg-alt: #f1f3f3;
+  --vp-c-bg-soft: #ebeeee;
+  --vp-c-bg-elv: #ffffff;
+
+  --vp-code-color: var(--cp-c-link-1);
+  --vp-code-link-color: var(--cp-c-link-1);
+  --vp-code-link-hover-color: var(--cp-c-link-2);
+
+  --vp-home-hero-name-color: transparent;
+  --vp-home-hero-name-background: linear-gradient(135deg, #009689 0%, #00b5a5 45%, #07e3d0 100%);
+
+  --vp-button-brand-bg: #00b5a5;
+  --vp-button-brand-hover-bg: #009689;
+  --vp-button-brand-active-bg: #007c70;
+  --vp-button-brand-border: transparent;
+
+  --vp-button-alt-bg: #ffffff;
+  --vp-button-alt-border: rgba(0, 124, 112, 0.18);
+  --vp-button-alt-hover-bg: #f5fffd;
+
+  --vp-custom-block-tip-bg: rgba(0, 181, 165, 0.08);
+  --vp-custom-block-tip-border: rgba(0, 181, 165, 0.28);
+  --vp-custom-block-tip-text: #0d6159;
+}
+
+html,
+body,
+#app {
+  background: #f7f8f8;
+}
+
+.Layout {
+  background: transparent;
+}
+
+.VPNav {
+  background: rgba(255, 255, 255, 0.88) !important;
+  border-bottom: 1px solid rgba(0, 124, 112, 0.12);
+  backdrop-filter: blur(18px);
+}
+
+.VPNavBarTitle .title {
+  gap: 0.8rem;
+}
+
+.VPNavBarTitle .logo {
+  width: 34px;
+  height: 34px;
+  border-radius: 12px;
+}
+
+.VPNavBarTitle .title span:last-child {
+  font-size: 0.98rem;
+  font-weight: 700;
+  letter-spacing: -0.02em;
+  color: var(--vp-c-text-1);
+}
+
+.VPHomeHero .container {
+  align-items: center;
+}
+
+.VPHomeHero .main {
+  max-width: 37rem;
+}
+
+.VPHomeHero .name {
+  font-weight: 800;
+  letter-spacing: -0.04em;
+}
+
+.VPHomeHero .text {
+  max-width: 13ch;
+  font-weight: 700;
+  letter-spacing: -0.045em;
+}
+
+.VPHomeHero .tagline {
+  max-width: 35rem;
+  color: var(--vp-c-text-2);
+  font-size: 1.08rem;
+  line-height: 1.75;
+}
+
+.VPFeature {
+  border: none;
+  border-radius: 24px;
+  background: transparent;
+}
+
+.VPFeature.link:hover {
+  border-color: transparent;
+}
+
+.VPFeature .title {
+  font-size: 1.18rem;
+  line-height: 1.35;
+}
+
+.VPFeature .details {
+  font-size: 0.98rem;
+  line-height: 1.72;
+}
+
+.VPFeature .box {
+  min-height: 100%;
+  border: 1px solid rgba(0, 124, 112, 0.12);
+  border-radius: 12px;
+  background: rgba(255, 255, 255, 0.74);
+}
+
+.VPFeature.link:hover .box {
+  border-color: rgba(0, 124, 112, 0.24);
+  background: rgba(255, 255, 255, 0.92);
+}
+
+.vp-doc h1,
+.vp-doc h2,
+.vp-doc h3 {
+  letter-spacing: -0.03em;
+}
+
+.vp-doc a {
+  color: var(--cp-c-link-1);
+  font-weight: 600;
+  text-decoration-color: rgba(0, 181, 165, 0.35);
+  text-underline-offset: 0.16em;
+}
+
+.vp-doc a:hover,
+.vp-doc a > code,
+.VPNavBarMenuLink:hover,
+.VPNavBarMenuLink.active,
+.VPLocalNav .menu-link:hover,
+.VPLocalNav .menu-link.active,
+.VPSidebarItem .item .link:hover .text,
+.VPDocOutlineItem .outline-link:hover,
+.VPDocOutlineItem.is-active > .outline-link,
+.VPDocPager .link:hover .title {
+  color: var(--cp-c-link-2);
+}
+
+.VPNavBarMenuLink,
+.VPLocalNav .menu-link,
+.VPSidebarItem .item .text,
+.VPDocOutlineItem .outline-link,
+.VPDocPager .title {
+  color: var(--vp-c-text-2);
+}
+
+.VPLocalNav .menu-link[aria-current='true'],
+.VPDocOutlineItem .outline-link.active {
+  color: var(--cp-c-link-2) !important;
+}
+
+.VPSidebarItem.is-active > .item .text,
+.VPSidebarItem.is-active > .item .link > .text,
+.VPSidebarItem .item .link[aria-current='page'] .text,
+.VPSidebarItem .item .link.active .text {
+  color: var(--vp-c-brand-1) !important;
+}
+
+.vp-doc :not(pre, h1, h2, h3, h4, h5, h6) > code,
+.vp-doc a > code,
+.vp-doc td > code,
+.vp-doc th > code {
+  color: var(--cp-c-link-2);
+}
+
+.vp-doc table {
+  display: table;
+  width: 100%;
+  border-collapse: collapse;
+  overflow: hidden;
+  border-radius: 18px;
+}
+
+.vp-doc table th {
+  background: rgba(0, 181, 165, 0.08);
+}
+
+.vp-doc table th,
+.vp-doc table td {
+  border-color: rgba(0, 124, 112, 0.12);
+}
+
+.vp-doc div[class*='language-'] {
+  border: 1px solid rgba(0, 124, 112, 0.14);
+  border-radius: 20px;
+}
diff --git a/docs/.vitepress/theme/index.ts b/docs/.vitepress/theme/index.ts
@@ -0,0 +1,6 @@
+import DefaultTheme from 'vitepress/theme-without-fonts';
+import './custom.css';
+
+export default {
+  extends: DefaultTheme,
+};
diff --git a/docs/contributing.md b/docs/contributing.md
@@ -1,6 +1,8 @@
 # Contributing
 
-Thank you for your interest in contributing to `@cognipeer/agent-server`!
+Thank you for your interest in contributing to `@cognipeer/agent-server`.
+
+Agent Server docs live under `docs/` and are rendered with VitePress using the shared Cognipeer docs shell.
 
 ## Development Setup
 
@@ -23,6 +25,24 @@ npm install
 npm run dev
 ```
 
+4. Run docs locally:
+
+```bash
+npm run docs:dev
+```
+
+## Project Areas
+
+- `src/`: runtime source for the server, adapters, and providers
+- `docs/`: VitePress documentation source
+- `examples/`: integration examples and sample server setups
+
+## Documentation
+
+- Theme config: `docs/.vitepress/config.mts`
+- Theme styling: `docs/.vitepress/theme/`
+- Public docs assets: `docs/public/`
+
 ## Running Tests
 
 ```bash
@@ -33,6 +53,7 @@ npm test
 
 ```bash
 npm run build
+npm run docs:build
 ```
 
 ## Code Style
@@ -48,7 +69,7 @@ npm run lint
 1. Fork the repository
 2. Create a feature branch
 3. Make your changes
-4. Run tests and linting
+4. Run tests, linting, and docs build where relevant
 5. Submit a pull request
 
 ## Reporting Issues