Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(docs): enforce product themes

Brendan O'Learyd974b20716ea
diff --git a/docs/components/docs-product-context.tsx b/docs/components/docs-product-context.tsx
index 3251d6a7f..ba5c56395 100644
--- a/docs/components/docs-product-context.tsx
+++ b/docs/components/docs-product-context.tsx
@@ -12,8 +12,10 @@ import {
} from 'react';
import { flushSync } from 'react-dom';
import { usePathname, useRouter } from 'next/navigation';
+import { useTheme } from 'fumadocs-ui/provider/base';
import {
classifyDocsProduct,
+ DOCS_PRODUCTS,
serializeDocsProductCookie,
shouldAnimateDocsProductSwitch,
type DocsProduct,
@@ -54,6 +56,7 @@ export function DocsProductProvider({
}) {
const pathname = usePathname();
const router = useRouter();
+ const { setTheme } = useTheme();
const [persistedProduct, setPersistedProduct] = useState(initialProduct);
const [pendingProduct, setPendingProduct] = useState<DocsProduct | null>(null);
const pendingNavigation = useRef<{
@@ -64,6 +67,10 @@ export function DocsProductProvider({
const inferredProduct = classifyDocsProduct(pathname);
const product = pendingProduct ?? inferredProduct ?? persistedProduct;
+ useEffect(() => {
+ setTheme(DOCS_PRODUCTS[product].theme);
+ }, [product, setTheme]);
+
const persistProduct = useCallback((nextProduct: DocsProduct) => {
writeProductCookie(nextProduct);
setPersistedProduct(nextProduct);
@@ -101,6 +108,7 @@ export function DocsProductProvider({
flushSync(() => {
setPersistedProduct(nextProduct);
setPendingProduct(nextProduct);
+ setTheme(DOCS_PRODUCTS[nextProduct].theme);
});
if (href !== pathname) router.push(href);
};
@@ -165,7 +173,7 @@ export function DocsProductProvider({
commitNavigation();
}
},
- [pathname, router],
+ [pathname, router, setTheme],
);
const value = useMemo(
diff --git a/docs/lib/home-navigation.ts b/docs/lib/home-navigation.ts
index b47f30a85..60f79f053 100644
--- a/docs/lib/home-navigation.ts
+++ b/docs/lib/home-navigation.ts
@@ -29,6 +29,7 @@ interface DocsProductConfig {
product: HomeIntent['product'];
switcherDescription: string;
landingRoute: string;
+ theme: 'light' | 'dark';
routePrefixes: readonly string[];
sidebar: readonly ProductSidebarGroup[];
home: Omit<HomeIntent, 'productId' | 'product'>;
@@ -59,6 +60,7 @@ export const DOCS_PRODUCTS = {
product: 'For You',
switcherDescription: 'Connect your apps to AI clients.',
landingRoute: '/docs/agent-plugins',
+ theme: 'light',
routePrefixes: [
'/docs/agent-plugins',
'/docs/claude-code-plugin',
@@ -104,6 +106,7 @@ export const DOCS_PRODUCTS = {
product: 'Platform',
switcherDescription: 'Build agents with the Composio SDK.',
landingRoute: '/docs/quickstart',
+ theme: 'dark',
routePrefixes: [
'/docs/quickstart',
'/docs/providers',
diff --git a/docs/lib/layout.shared.tsx b/docs/lib/layout.shared.tsx
index 2bd1ba664..a48552612 100644
--- a/docs/lib/layout.shared.tsx
+++ b/docs/lib/layout.shared.tsx
@@ -11,7 +11,7 @@ export function baseOptions(): BaseLayoutProps {
transparentMode: 'top',
},
slots: { navTitle: ProductNavTitle },
- themeSwitch: { enabled: true, mode: 'light-dark-system' },
+ themeSwitch: { enabled: false },
searchToggle: {
components: {
lg: <SearchAndAskAI />,
diff --git a/docs/tests/static/product-navigation.test.ts b/docs/tests/static/product-navigation.test.ts
index 005900315..cf5953a89 100644
--- a/docs/tests/static/product-navigation.test.ts
+++ b/docs/tests/static/product-navigation.test.ts
@@ -14,17 +14,19 @@ import { buildProductPageTree, pageTreeUrls } from '../../lib/product-page-tree'
import { source } from '../../lib/source';
describe('Docs product navigation', () => {
- test('defines the product labels, descriptions, and landings once', () => {
+ test('defines the product labels, descriptions, landings, and themes once', () => {
expect(DEFAULT_DOCS_PRODUCT).toBe('platform');
expect(DOCS_PRODUCTS['for-you']).toMatchObject({
product: 'For You',
switcherDescription: 'Connect your apps to AI clients.',
landingRoute: '/docs/agent-plugins',
+ theme: 'light',
});
expect(DOCS_PRODUCTS.platform).toMatchObject({
product: 'Platform',
switcherDescription: 'Build agents with the Composio SDK.',
landingRoute: '/docs/quickstart',
+ theme: 'dark',
});
});
@@ -142,6 +144,9 @@ describe('Docs product navigation', () => {
const sharedLayoutSource = await Bun.file(
new URL('../../lib/layout.shared.tsx', import.meta.url),
).text();
+ const contextSource = await Bun.file(
+ new URL('../../components/docs-product-context.tsx', import.meta.url),
+ ).text();
expect(switcherSource).toContain('aria-label={`Switch Composio product. Current product:');
expect(switcherSource).toContain('ProductSelectionLink');
@@ -153,5 +158,7 @@ describe('Docs product navigation', () => {
expect(switcherSource).toContain('aria-label="Composio home"');
expect(switcherSource).toContain('href="/"');
expect(sharedLayoutSource).toContain('slots: { navTitle: ProductNavTitle }');
+ expect(sharedLayoutSource).toContain('themeSwitch: { enabled: false }');
+ expect(contextSource).toContain('setTheme(DOCS_PRODUCTS[product].theme)');
});
});