-
-
Cookbook
-
- Practical examples and complete applications built with Hindsight.
-
-
-
## Recipes
**Contents**
- [What is Hindsight and how does it differ from RAG?](#what-is-hindsight-and-how-does-it-differ-from-rag)
@@ -64,7 +65,7 @@ Unlike vector databases (just search) or RAG systems (document retrieval), Hinds
### Which integrations are supported?
-
+Browse all supported integrations in the [Integrations Hub](/integrations).
---
diff --git a/hindsight-docs/src/pages/integrations/index.module.css b/hindsight-docs/src/pages/integrations/index.module.css
new file mode 100644
index 00000000..abd08684
--- /dev/null
+++ b/hindsight-docs/src/pages/integrations/index.module.css
@@ -0,0 +1,408 @@
+/* ── Full-width hero ─────────────────────────────────────────────────────── */
+.heroSection {
+ width: 100%;
+ padding: 5rem 1.5rem 4rem;
+ text-align: center;
+ background: radial-gradient(ellipse 80% 60% at 50% 0%, rgba(0, 116, 217, 0.12) 0%, transparent 70%),
+ var(--ifm-background-color);
+ border-bottom: 1px solid var(--ifm-color-emphasis-200);
+}
+
+[data-theme='dark'] .heroSection {
+ background: radial-gradient(ellipse 80% 60% at 50% 0%, rgba(0, 116, 217, 0.18) 0%, transparent 70%),
+ var(--ifm-background-color);
+ border-bottom-color: rgba(255, 255, 255, 0.07);
+}
+
+.heroTitle {
+ font-size: 3.2rem;
+ font-weight: 800;
+ background: linear-gradient(135deg, #0074d9, #009296);
+ -webkit-background-clip: text;
+ -webkit-text-fill-color: transparent;
+ background-clip: text;
+ letter-spacing: -0.03em;
+ line-height: 1.1;
+ margin-bottom: 0.75rem;
+}
+
+.heroSubtitle {
+ font-size: 1.05rem;
+ color: var(--ifm-color-emphasis-600);
+ max-width: 500px;
+ margin: 0 auto 2.25rem;
+ line-height: 1.7;
+}
+
+/* ── Search ──────────────────────────────────────────────────────────────── */
+.searchWrapper {
+ position: relative;
+ max-width: 640px;
+ margin: 0 auto;
+}
+
+.searchInput {
+ width: 100%;
+ box-sizing: border-box;
+ padding: 1.05rem 3.5rem 1.05rem 1.5rem;
+ border-radius: 14px;
+ border: 2px solid var(--ifm-color-emphasis-300);
+ background: var(--ifm-background-surface-color);
+ color: var(--ifm-font-color-base);
+ font-size: 1.1rem;
+ font-family: inherit;
+ outline: none;
+ transition: border-color 0.15s ease, box-shadow 0.15s ease;
+ box-shadow: 0 4px 24px rgba(0, 0, 0, 0.08);
+}
+
+.searchInput::placeholder {
+ color: var(--ifm-color-emphasis-400);
+}
+
+.searchInput:focus {
+ border-color: #0074d9;
+ box-shadow: 0 0 0 4px rgba(0, 116, 217, 0.15), 0 4px 24px rgba(0, 0, 0, 0.08);
+}
+
+[data-theme='dark'] .searchInput {
+ background: #242428;
+ border-color: rgba(255, 255, 255, 0.15);
+ box-shadow: 0 4px 24px rgba(0, 0, 0, 0.4);
+}
+
+[data-theme='dark'] .searchInput:focus {
+ border-color: #4da6ff;
+ box-shadow: 0 0 0 4px rgba(77, 166, 255, 0.18), 0 4px 24px rgba(0, 0, 0, 0.4);
+}
+
+.searchClear {
+ position: absolute;
+ right: 1rem;
+ top: 50%;
+ transform: translateY(-50%);
+ background: var(--ifm-color-emphasis-200);
+ border: none;
+ color: var(--ifm-color-emphasis-600);
+ cursor: pointer;
+ font-size: 1rem;
+ line-height: 1;
+ width: 24px;
+ height: 24px;
+ border-radius: 50%;
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ transition: background 0.1s;
+}
+
+.searchClear:hover {
+ background: var(--ifm-color-emphasis-300);
+}
+
+/* ── Hero stats ──────────────────────────────────────────────────────────── */
+.heroStats {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.6rem;
+ font-size: 0.82rem;
+ color: var(--ifm-color-emphasis-500);
+ margin-top: 1.25rem;
+}
+
+.stat strong {
+ color: var(--ifm-color-emphasis-800);
+}
+
+[data-theme='dark'] .stat strong {
+ color: var(--ifm-color-emphasis-700);
+}
+
+.statDivider {
+ color: var(--ifm-color-emphasis-300);
+}
+
+/* ── Page container ──────────────────────────────────────────────────────── */
+.page {
+ max-width: 1200px;
+ margin: 0 auto;
+ padding: 2.5rem 1.5rem 5rem;
+}
+
+/* ── Toolbar (filters + count) ───────────────────────────────────────────── */
+.toolbar {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ margin-bottom: 1.75rem;
+ flex-wrap: wrap;
+ gap: 0.75rem;
+}
+
+.filterGroup {
+ display: flex;
+ align-items: center;
+ gap: 0.4rem;
+}
+
+.filterPill {
+ display: inline-flex;
+ align-items: center;
+ font-size: 0.82rem;
+ font-weight: 500;
+ padding: 0.3rem 0.85rem;
+ border-radius: 999px;
+ border: 1px solid var(--ifm-color-emphasis-300);
+ background: transparent;
+ color: var(--ifm-color-emphasis-700);
+ cursor: pointer;
+ transition: all 0.15s ease;
+ font-family: inherit;
+}
+
+.filterPill:hover {
+ border-color: var(--ifm-color-primary);
+ color: var(--ifm-color-primary);
+}
+
+.filterPillActive {
+ background: var(--ifm-color-primary);
+ border-color: var(--ifm-color-primary);
+ color: #fff !important;
+}
+
+[data-theme='dark'] .filterPill {
+ border-color: rgba(255, 255, 255, 0.15);
+ color: var(--ifm-color-emphasis-600);
+}
+
+/* ── Result count ────────────────────────────────────────────────────────── */
+.resultCount {
+ font-size: 0.8rem;
+ color: var(--ifm-color-emphasis-400);
+ margin: 0;
+}
+
+/* ── Grid ────────────────────────────────────────────────────────────────── */
+.grid {
+ display: grid;
+ grid-template-columns: repeat(3, 1fr);
+ gap: 1.25rem;
+ margin-bottom: 4rem;
+}
+
+@media (max-width: 996px) {
+ .grid { grid-template-columns: repeat(2, 1fr); }
+}
+
+@media (max-width: 640px) {
+ .grid { grid-template-columns: 1fr; }
+ .heroTitle { font-size: 2.2rem; }
+}
+
+/* ── Card ────────────────────────────────────────────────────────────────── */
+.card {
+ display: flex;
+ flex-direction: column;
+ border-radius: 12px;
+ border: 1px solid var(--ifm-color-emphasis-200);
+ background: var(--ifm-background-surface-color);
+ text-decoration: none !important;
+ color: inherit;
+ transition: box-shadow 0.2s ease, transform 0.2s ease;
+ overflow: hidden;
+}
+
+[data-theme='dark'] .card {
+ background: #1c1c1e;
+ border-color: rgba(255, 255, 255, 0.07);
+}
+
+.card:hover {
+ transform: translateY(-2px);
+ box-shadow: 0 6px 24px rgba(0, 116, 217, 0.12);
+ text-decoration: none !important;
+ color: inherit;
+}
+
+.cardHeader {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 1rem 1.1rem 0;
+}
+
+.cardIcon {
+ width: 36px;
+ height: 36px;
+ object-fit: contain;
+ flex-shrink: 0;
+}
+
+.typeBadge {
+ font-size: 0.63rem;
+ font-weight: 700;
+ text-transform: uppercase;
+ letter-spacing: 0.05em;
+ padding: 0.15rem 0.5rem;
+ border-radius: 999px;
+}
+
+.typeBadgeOfficial {
+ background: rgba(0, 116, 217, 0.12);
+ color: #0074d9;
+}
+
+[data-theme='dark'] .typeBadgeOfficial {
+ background: rgba(0, 116, 217, 0.2);
+ color: #4da6ff;
+}
+
+.typeBadgeCommunity {
+ background: rgba(0, 146, 150, 0.12);
+ color: #009296;
+}
+
+[data-theme='dark'] .typeBadgeCommunity {
+ background: rgba(0, 146, 150, 0.2);
+ color: #00bcc0;
+}
+
+.cardBody {
+ flex: 1;
+ padding: 0.85rem 1.1rem 0.75rem;
+}
+
+.cardTitle {
+ font-size: 1rem;
+ font-weight: 700;
+ margin: 0 0 0.4rem;
+ color: var(--ifm-heading-color);
+ letter-spacing: -0.01em;
+ border-bottom: none !important;
+ border-image: none !important;
+}
+
+.cardDescription {
+ font-size: 0.82rem;
+ color: var(--ifm-color-emphasis-600);
+ line-height: 1.6;
+ margin: 0;
+ display: -webkit-box;
+ -webkit-line-clamp: 3;
+ -webkit-box-orient: vertical;
+ overflow: hidden;
+}
+
+.cardFooter {
+ display: flex;
+ align-items: center;
+ padding: 0.65rem 1.1rem 0.9rem;
+ margin-top: 0.25rem;
+ border-top: 1px solid var(--ifm-color-emphasis-100);
+}
+
+[data-theme='dark'] .cardFooter {
+ border-top-color: rgba(255, 255, 255, 0.06);
+}
+
+.byLine {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.5rem;
+ font-size: 0.78rem;
+ font-family: 'JetBrains Mono', 'Fira Code', 'SF Mono', Monaco, Consolas, monospace;
+ color: var(--ifm-color-emphasis-600);
+}
+
+.authorIcon {
+ width: 22px;
+ height: 22px;
+ border-radius: 50%;
+ object-fit: cover;
+ flex-shrink: 0;
+ border: 1px solid var(--ifm-color-emphasis-200);
+}
+
+[data-theme='dark'] .authorIcon {
+ border-color: rgba(255, 255, 255, 0.1);
+}
+
+.authorName {
+ font-weight: 500;
+}
+
+/* ── Empty state ─────────────────────────────────────────────────────────── */
+.empty {
+ text-align: center;
+ padding: 4rem 2rem;
+ color: var(--ifm-color-emphasis-500);
+}
+
+.resetButton {
+ margin-top: 1rem;
+ padding: 0.4rem 1rem;
+ border-radius: 6px;
+ border: 1px solid var(--ifm-color-primary);
+ background: transparent;
+ color: var(--ifm-color-primary);
+ font-size: 0.85rem;
+ font-family: inherit;
+ cursor: pointer;
+ transition: all 0.15s ease;
+}
+
+.resetButton:hover {
+ background: var(--ifm-color-primary);
+ color: #fff;
+}
+
+/* ── Submit banner ───────────────────────────────────────────────────────── */
+.submitBanner {
+ border-radius: 14px;
+ border: 1px solid var(--ifm-color-emphasis-200);
+ background: linear-gradient(135deg, rgba(0, 116, 217, 0.06), rgba(0, 146, 150, 0.06));
+ padding: 2.5rem 2rem;
+ text-align: center;
+}
+
+[data-theme='dark'] .submitBanner {
+ border-color: rgba(255, 255, 255, 0.08);
+ background: linear-gradient(135deg, rgba(0, 116, 217, 0.1), rgba(0, 146, 150, 0.1));
+}
+
+.submitBannerContent {
+ max-width: 480px;
+ margin: 0 auto;
+}
+
+.submitBannerTitle {
+ font-size: 1.3rem;
+ font-weight: 700;
+ margin-bottom: 0.5rem;
+}
+
+.submitBannerText {
+ font-size: 0.9rem;
+ color: var(--ifm-color-emphasis-600);
+ margin-bottom: 1.25rem;
+ line-height: 1.6;
+}
+
+.submitButton {
+ display: inline-block;
+ padding: 0.55rem 1.4rem;
+ border-radius: 8px;
+ background: linear-gradient(135deg, #0074d9, #009296);
+ color: #fff !important;
+ font-size: 0.9rem;
+ font-weight: 600;
+ text-decoration: none !important;
+ transition: opacity 0.15s ease, transform 0.15s ease;
+}
+
+.submitButton:hover {
+ opacity: 0.9;
+ transform: translateY(-1px);
+ color: #fff !important;
+}
diff --git a/hindsight-docs/src/pages/integrations/index.tsx b/hindsight-docs/src/pages/integrations/index.tsx
new file mode 100644
index 00000000..78b1581b
--- /dev/null
+++ b/hindsight-docs/src/pages/integrations/index.tsx
@@ -0,0 +1,163 @@
+import React, {useMemo, useState} from 'react';
+import Link from '@docusaurus/Link';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+import Layout from '@theme/Layout';
+import IntegrationsBanner from '@site/src/components/IntegrationsBanner';
+import integrationsData from '@site/src/data/integrations.json';
+import styles from './index.module.css';
+
+const INTEGRATIONS_JSON_URL =
+ 'https://github.com/vectorize-io/hindsight/edit/main/hindsight-docs/src/data/integrations.json';
+
+type IntegrationType = 'official' | 'community';
+
+interface Integration {
+ id: string;
+ name: string;
+ description: string;
+ type: IntegrationType;
+ by: string;
+ category: string;
+ link: string;
+ icon?: string;
+}
+
+function IntegrationCard({integration}: {integration: Integration}) {
+ const iconSrc = useBaseUrl(integration.icon ?? '');
+ const faviconSrc = useBaseUrl('/img/favicon.png');
+ const isExternal = integration.link.startsWith('http');
+
+ return (
+
+
+ {integration.icon &&

}
+
+ {integration.type === 'official' ? 'Official' : 'Community'}
+
+
+
+
{integration.name}
+
{integration.description}
+
+
+ {integration.type === 'official' ? (
+
+
+ Hindsight Team
+
+ ) : (
+
+
+ @{integration.by}
+
+ )}
+
+
+ );
+}
+
+export default function IntegrationsHub(): React.ReactElement {
+ const [search, setSearch] = useState('');
+ const [selectedType, setSelectedType] = useState
('all');
+
+ const integrations = integrationsData.integrations as Integration[];
+
+ const filtered = useMemo(() => {
+ const q = search.toLowerCase().trim();
+ return integrations.filter((i) => {
+ if (selectedType !== 'all' && i.type !== selectedType) return false;
+ if (q && !i.name.toLowerCase().includes(q) && !i.description.toLowerCase().includes(q)) return false;
+ return true;
+ });
+ }, [integrations, search, selectedType]);
+
+ const officialCount = integrations.filter((i) => i.type === 'official').length;
+ const communityCount = integrations.filter((i) => i.type === 'community').length;
+
+ return (
+
+
+ {/* Full-width hero with its own background */}
+
+
Integrations Hub
+
+ Connect Hindsight to your stack. Browse official integrations and community-built connectors.
+
+
+
+ setSearch(e.target.value)}
+ aria-label="Search integrations"
+ autoComplete="off"
+ />
+ {search && (
+
+ )}
+
+
+
+ {officialCount} official
+ ·
+ {communityCount} community
+
+
+
+ {/* Scrolling banner */}
+
+
+ {/* Main content */}
+
+
+
+ {(['all', 'official', 'community'] as const).map((t) => (
+
+ ))}
+
+
{filtered.length} integration{filtered.length !== 1 ? 's' : ''}
+
+
+ {filtered.length === 0 ? (
+
+
No integrations match your search.
+
+
+ ) : (
+
+ {filtered.map((integration) => (
+
+ ))}
+
+ )}
+
+
+
+
Built something with Hindsight?
+
+ Share your integration with the community. Open a pull request and add your entry to the integrations list.
+
+
+ Submit an integration →
+
+
+
+
+
+ );
+}
diff --git a/hindsight-docs/src/theme/BlogListPage/index.tsx b/hindsight-docs/src/theme/BlogListPage/index.tsx
index 63f6a928..fd67b6b7 100644
--- a/hindsight-docs/src/theme/BlogListPage/index.tsx
+++ b/hindsight-docs/src/theme/BlogListPage/index.tsx
@@ -3,6 +3,7 @@ import Link from '@docusaurus/Link';
import Layout from '@theme/Layout';
import type {Props} from '@theme/BlogListPage';
import type {PropBlogPostContent} from '@docusaurus/plugin-content-blog';
+import PageHero from '@site/src/components/PageHero';
import styles from './styles.module.css';
const CLOUD_TAG = 'hindsight-cloud';
@@ -70,10 +71,7 @@ export default function BlogListPage({items, metadata}: Props): React.ReactEleme
return (
-
- {blogTitle}
- {blogDescription && {blogDescription}
}
-
+
{cloudPosts.length > 0 && (
diff --git a/hindsight-docs/src/theme/BlogListPage/styles.module.css b/hindsight-docs/src/theme/BlogListPage/styles.module.css
index 7a9341e7..8ad6c526 100644
--- a/hindsight-docs/src/theme/BlogListPage/styles.module.css
+++ b/hindsight-docs/src/theme/BlogListPage/styles.module.css
@@ -1,33 +1,7 @@
.blogPage {
max-width: 1280px;
margin: 0 auto;
- padding: 4rem 2rem 6rem;
-}
-
-/* ── Header ─────────────────────────────────────── */
-.header {
- text-align: center;
- margin-bottom: 4rem;
-}
-
-.headerTitle {
- font-size: 3rem;
- font-weight: 800;
- background: linear-gradient(135deg, #0074d9, #009296);
- -webkit-background-clip: text;
- -webkit-text-fill-color: transparent;
- background-clip: text;
- margin-bottom: 0.75rem;
- line-height: 1.15;
- letter-spacing: -0.03em;
-}
-
-.headerSubtitle {
- font-size: 1.05rem;
- color: var(--ifm-color-emphasis-600);
- max-width: 520px;
- margin: 0 auto;
- line-height: 1.7;
+ padding: 2rem 2rem 6rem;
}
/* ── Section ─────────────────────────────────────── */
@@ -93,9 +67,6 @@
gap: 2rem;
}
- .headerTitle {
- font-size: 2.25rem;
- }
}
/* ── Card ────────────────────────────────────────── */
diff --git a/hindsight-docs/src/theme/Navbar/index.tsx b/hindsight-docs/src/theme/Navbar/index.tsx
index 4509c6f3..48ce38ad 100644
--- a/hindsight-docs/src/theme/Navbar/index.tsx
+++ b/hindsight-docs/src/theme/Navbar/index.tsx
@@ -1,15 +1,11 @@
import React, {type ReactNode} from 'react';
import NavbarLayout from '@theme/Navbar/Layout';
import NavbarContent from '@theme/Navbar/Content';
-import IntegrationsBanner from '@site/src/components/IntegrationsBanner';
export default function Navbar(): ReactNode {
return (
- <>
-
-
-
-
- >
+
+
+
);
}
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/api/quickstart.mdx b/hindsight-docs/versioned_docs/version-0.4/developer/api/quickstart.mdx
index 2f6bab98..eebba331 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/api/quickstart.mdx
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/api/quickstart.mdx
@@ -9,7 +9,7 @@ Get up and running with Hindsight in 60 seconds.
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import CodeSnippet from '@site/src/components/CodeSnippet';
-import {ClientsGrid, IntegrationsGrid} from '@site/src/components/SupportedGrids';
+import {ClientsGrid} from '@site/src/components/SupportedGrids';
{/* Import raw source files */}
import quickstartPy from '!!raw-loader!@site/examples/api/quickstart.py';
@@ -107,7 +107,7 @@ curl -fsSL https://hindsight.vectorize.io/get-cli | bash
## Integrations
-
+Browse all supported integrations in the [Integrations Hub](/integrations).
## Next Steps
diff --git a/hindsight-docs/versioned_docs/version-0.4/developer/index.mdx b/hindsight-docs/versioned_docs/version-0.4/developer/index.mdx
index 22a712d2..f986ce5a 100644
--- a/hindsight-docs/versioned_docs/version-0.4/developer/index.mdx
+++ b/hindsight-docs/versioned_docs/version-0.4/developer/index.mdx
@@ -3,7 +3,7 @@ sidebar_position: 1
slug: /
---
-import {ClientsGrid, IntegrationsGrid} from '@site/src/components/SupportedGrids';
+import {ClientsGrid} from '@site/src/components/SupportedGrids';
# Overview
@@ -122,7 +122,7 @@ These settings only affect the `reflect` operation, not `recall`.
## Integrations
-
+Browse all supported integrations in the [Integrations Hub](/integrations).
## Next Steps