@brainfish-ai/devdoc 0.1.21 → 0.1.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainfish-ai/devdoc",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "description": "Documentation framework for developers. Write docs in MDX, preview locally, deploy to Brainfish.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/renderer/app/api/collections/route.ts

@@ -34,8 +34,8 @@ const BRAINFISH_API_BASE_URL = process.env.BRAINFISH_API_BASE_URL || 'https://ap
 const BRAINFISH_CATALOG_ID = process.env.BRAINFISH_CATALOG_ID || 'your_catalog_id_here'
 const BRAINFISH_JWT_TOKEN = process.env.BRAINFISH_JWT_TOKEN || 'your_jwt_token_here'
 
-// Debug logging
-if (process.env.NODE_ENV === 'development') {
+// Debug logging - only in verbose mode
+if (process.env.DEVDOC_VERBOSE === 'true') {
   console.log('[Collections] Config:', {
     useLocalSpec: USE_LOCAL_SPEC,
     starterPath: STARTER_PATH,
@@ -219,12 +219,10 @@ function loadGraphQLSchema(schemaPath: string): string | null {
       : resolvePath(relativePath)
     
     if (!existsSync(fullPath)) {
-      console.log('[Collections] GraphQL schema not found at:', fullPath)
       return null
     }
     
     const content = readFileSync(fullPath, 'utf-8')
-    console.log('[Collections] Loaded GraphQL schema from:', fullPath)
     return content
   } catch (error) {
     console.error('[Collections] Error loading GraphQL schema:', error)
@@ -243,14 +241,12 @@ function loadLocalSpec(specPath?: string): OpenApiSpec | null {
       : resolvePath(relativePath)
     
     if (!existsSync(fullPath)) {
-      console.log('[Collections] Local spec not found at:', fullPath)
       return null
     }
     
     const content = readFileSync(fullPath, 'utf-8')
     const spec = JSON.parse(content) as OpenApiSpec
     
-    console.log('[Collections] Loaded local spec:', spec.info?.title, 'v' + spec.info?.version, 'from', fullPath)
     return spec
   } catch (error) {
     console.error('[Collections] Error loading local spec:', error)
@@ -264,7 +260,6 @@ function loadDocsConfig(): DocsConfig | null {
     const configPath = resolvePath('docs.json')
     
     if (!existsSync(configPath)) {
-      console.log('[Collections] docs.json not found at:', configPath)
       return null
     }
     
@@ -282,7 +277,6 @@ function loadThemeConfig(): ThemeConfig | null {
     const configPath = resolvePath('theme.json')
     
     if (!existsSync(configPath)) {
-      console.log('[Collections] theme.json not found at:', configPath)
       return null
     }
     
@@ -577,8 +571,6 @@ async function fetchRemoteSpec(): Promise<OpenApiSpec | null> {
   try {
     const url = `${BRAINFISH_API_BASE_URL}/catalogs.openapi-spec`
     
-    console.log('[Collections] Fetching from:', url)
-    
     const response = await fetch(url, {
       method: 'POST',
       headers: {
@@ -612,7 +604,6 @@ async function fetchRemoteSpec(): Promise<OpenApiSpec | null> {
     
     const fallbackSpec = await CacheUtils.get<OpenApiSpec>(FALLBACK_CACHE_KEY)
     if (fallbackSpec) {
-      console.warn('[Collections] Using fallback cache')
       return fallbackSpec
     }
     
@@ -627,7 +618,6 @@ async function getOpenApiSpec(specPath?: string): Promise<OpenApiSpec | null> {
     if (localSpec) {
       return localSpec
     }
-    console.log('[Collections] Local spec not available, falling back to remote')
   }
   
   return fetchRemoteSpec()
@@ -811,11 +801,9 @@ async function getOrGenerateSummary(collection: BrainfishCollection, specVersion
   
   const cachedSummary = await CacheUtils.get<string>(versionedCacheKey)
   if (cachedSummary) {
-    console.log('[Collections] Using cached API summary for version:', specVersion)
     return cachedSummary
   }
   
-  console.log('[Collections] Generating new API summary for version:', specVersion)
   const summary = generateAPISummary(collection)
   const formattedSummary = formatAPISummaryForPrompt(summary)
   
@@ -869,8 +857,6 @@ export async function GET(request: Request) {
     // Get OpenAPI spec (with optional path for versioned specs)
     const spec = await getOpenApiSpec(specPath)
     
-    console.log('[Collections] Loaded', docGroups.length, 'doc groups,', navigationTabs.length, 'tabs,', changelogReleases.length, 'changelog releases,', apiVersions.length, 'API versions, selected:', selectedVersion)
-    
     // Handle no spec available
     if (!spec) {
       return NextResponse.json(

package/renderer/app/api/docs/route.ts

@@ -101,6 +101,11 @@ export async function GET(request: NextRequest) {
         title: frontmatter.title || slug,
         description: frontmatter.description,
         icon: frontmatter.icon,
+        // Page mode and layout options
+        mode: frontmatter.mode || 'default',
+        hideHeader: frontmatter.hideHeader || false,
+        fullWidth: frontmatter.fullWidth || false,
+        background: frontmatter.background,
       },
       mdxSource,
       rawContent: content, // Include raw content for changelog version extraction
@@ -171,6 +176,11 @@ async function handleMultiTenantDocs(projectSlug: string, slug: string): Promise
         title: frontmatter.title || slug,
         description: frontmatter.description,
         icon: frontmatter.icon,
+        // Page mode and layout options
+        mode: frontmatter.mode || 'default',
+        hideHeader: frontmatter.hideHeader || false,
+        fullWidth: frontmatter.fullWidth || false,
+        background: frontmatter.background,
       },
       mdxSource,
       rawContent: content,

package/renderer/app/api/schema/route.ts

@@ -1,15 +1,23 @@
 import { NextRequest, NextResponse } from 'next/server'
 import { readFileSync, existsSync } from 'fs'
-import { join } from 'path'
+import { join, isAbsolute } from 'path'
 import { getProjectContent } from '@/lib/storage/blob'
 
-// Get the docs directory
+// Configuration - match collections route
+const STARTER_PATH = process.env.STARTER_PATH || 'devdoc-docs'
+
+// Get the docs directory - respects STARTER_PATH for local development
 function getDocsDir(): string {
   const projectSlug = process.env.BRAINFISH_PROJECT_SLUG
   if (projectSlug) {
     return join(process.cwd(), '.devdoc', projectSlug)
   }
-  return join(process.cwd(), 'devdoc-docs')
+  
+  // Use STARTER_PATH (can be absolute or relative)
+  if (isAbsolute(STARTER_PATH)) {
+    return STARTER_PATH
+  }
+  return join(process.cwd(), STARTER_PATH)
 }
 
 export async function GET(request: NextRequest) {

package/renderer/app/globals.css

@@ -1100,4 +1100,92 @@ code[data-line-numbers] > [data-line]::before {
 /* Scroll margin for agent navigation */
 [id] {
   scroll-margin-top: 80px;
+}
+
+/* ============================================
+   Custom Mode Page Styles (Landing Pages)
+   ============================================ */
+
+/* Custom mode pages should fill the entire content area */
+.docs-page-custom {
+  width: 100%;
+  min-height: 100%;
+  margin: 0;
+  padding: 0;
+}
+
+/* Ensure custom content children stretch to fill width */
+.docs-custom-content {
+  width: 100%;
+  margin: 0;
+  padding: 0;
+}
+
+/* All direct children of custom content should be full width */
+.docs-custom-content > * {
+  width: 100%;
+  margin-left: 0;
+  margin-right: 0;
+}
+
+/* Landing page components should not have prose constraints */
+.docs-custom-content .landing-hero,
+.docs-custom-content .landing-section {
+  max-width: none;
+  width: 100%;
+  margin-left: 0;
+  margin-right: 0;
+}
+
+/* When viewing a custom mode page, the content area should have no background */
+.docs-content-area:has(.docs-page-custom) {
+  background: transparent !important;
+  padding: 0 !important;
+}
+
+/* Ensure the main header doesn't shrink */
+.docs-main-header {
+  flex-shrink: 0 !important;
+  width: 100% !important;
+}
+
+/* Ensure docs-main container maintains width and doesn't collapse */
+.docs-main {
+  flex: 1 1 0% !important;
+  min-width: 0 !important;
+  width: 100% !important;
+}
+
+/* Ensure docs-layout children don't cause layout shifts */
+.docs-layout {
+  display: flex !important;
+}
+
+.docs-layout > .docs-sidebar {
+  flex-shrink: 0 !important;
+}
+
+/* Prevent content area from affecting parent layout */
+.docs-content-area {
+  flex: 1 1 auto !important;
+  min-height: 0 !important;
+}
+
+/* Remove any default margins from sections in custom pages */
+.docs-custom-content section {
+  margin: 0;
+}
+
+/* Ensure Hero sections fill entire width */
+.landing-hero {
+  width: 100%;
+  margin: 0;
+  padding-left: 0;
+  padding-right: 0;
+}
+
+/* Section components fill entire width */
+.landing-section {
+  width: 100%;
+  margin: 0;
 }

package/renderer/components/docs/mdx/index.ts

@@ -100,6 +100,23 @@ export {
   UpdateItem,
 } from './changelog'
 
+// Landing Page Components
+export {
+  Hero,
+  Pre,
+  Tagline,
+  Headline,
+  Description,
+  CommandBox,
+  Section,
+  Center,
+  FeatureGrid,
+  FeatureItem,
+  ButtonLink,
+  Spacer,
+  Divider,
+} from './landing'
+
 // Re-export types
 export type { Frontmatter } from '@/lib/docs/mdx/frontmatter'
 
@@ -123,6 +140,7 @@ import { Badge } from './badge'
 import { Mermaid } from './mermaid'
 import { PDF, Audio, Download } from './file-embeds'
 import { ChangelogEntry, ChangelogTitle, ChangelogDescription, ChangelogImage, BreakingChange, MoreUpdates, UpdateItem } from './changelog'
+import { Hero, Pre, Tagline, Headline, Description, CommandBox, Section, Center, FeatureGrid, FeatureItem, ButtonLink, Spacer, Divider } from './landing'
 
 export const mdxComponents = {
   // Callouts
@@ -199,6 +217,21 @@ export const mdxComponents = {
   BreakingChange,
   MoreUpdates,
   UpdateItem,
+  
+  // Landing Page
+  Hero,
+  Pre,
+  Tagline,
+  Headline,
+  Description,
+  CommandBox,
+  Section,
+  Center,
+  FeatureGrid,
+  FeatureItem,
+  ButtonLink,
+  Spacer,
+  Divider,
 }
 
 export default mdxComponents