create-specra 0.1.4 → 0.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-specra",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "CLI tool to scaffold a new Specra documentation site with Next.js",
   "type": "module",
   "bin": {

package/templates/minimal/app/api/mdx-watch/route.ts

@@ -1,80 +1,6 @@
-import { NextRequest } from 'next/server'
-import { watch } from 'fs'
-import { join } from 'path'
+// Next.js requires dynamic to be statically analyzable, so we can't re-export it
+export const dynamic = 'error'
+export const runtime = 'nodejs'
 
-export const dynamic = 'force-static'
-
-export async function GET(request: NextRequest) {
-  // Only allow in development mode
-  if (process.env.NODE_ENV !== 'development') {
-    return new Response('Not available in production', { status: 404 })
-  }
-
-  const encoder = new TextEncoder()
-
-  const stream = new ReadableStream({
-    start(controller) {
-      // Send initial connection message
-      const connectMsg = `data: ${JSON.stringify({ type: 'connected' })}\n\n`
-      controller.enqueue(encoder.encode(connectMsg))
-
-      const docsPath = join(process.cwd(), 'docs')
-
-      // Watch the docs directory recursively
-      const watcher = watch(
-        docsPath,
-        { recursive: true },
-        (eventType, filename) => {
-          if (!filename) return
-
-          // Only watch for .mdx and .json files (MDX files and category configs)
-          if (filename.endsWith('.mdx') || filename.endsWith('.json')) {
-            console.log(`[MDX Watch] ${eventType}: ${filename}`)
-
-            const message = `data: ${JSON.stringify({
-              type: 'change',
-              file: filename,
-              eventType
-            })}\n\n`
-
-            try {
-              controller.enqueue(encoder.encode(message))
-            } catch (error) {
-              console.error('[MDX Watch] Error sending message:', error)
-            }
-          }
-        }
-      )
-
-      // Handle client disconnect
-      request.signal.addEventListener('abort', () => {
-        console.log('[MDX Watch] Client disconnected')
-        watcher.close()
-        try {
-          controller.close()
-        } catch (error) {
-          // Controller might already be closed
-        }
-      })
-
-      // Handle errors
-      watcher.on('error', (error) => {
-        console.error('[MDX Watch] Watcher error:', error)
-        watcher.close()
-        try {
-          controller.close()
-        } catch (e) {
-          // Controller might already be closed
-        }
-      })
-    }
-  })
-
-  return new Response(stream, {
-    headers: {
-      'Content-Type': 'text/event-stream',
-      'Cache-Control': 'no-cache, no-transform',
-      'Connection': 'keep-alive',
-    },
-  })
-}
+// Re-export the GET handler from SDK
+export { GET } from "specra/app/api/mdx-watch"

package/templates/minimal/app/docs/[version]/[...slug]/page.tsx

@@ -8,7 +8,6 @@ import {
   getCachedAllDocs,
   getCachedDocBySlug,
   getConfig,
-  SpecraConfig,
 } from "specra/lib"
 import {
   DocLayout,
@@ -23,8 +22,6 @@ import {
   DocLoading,
 } from "specra/components"
 
-import specraConfig from "./../../../../specra.config.json"
-
 interface PageProps {
   params: Promise<{
     version: string
@@ -35,7 +32,6 @@ interface PageProps {
 export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
   const { version, slug: slugArray } = await params
   const slug = slugArray.join("/")
-
   const doc = await getCachedDocBySlug(slug, version)
 
   if (!doc) {
@@ -78,7 +74,6 @@ export async function generateStaticParams() {
   for (const version of versions) {
     const docs = await getCachedAllDocs(version)
     for (const doc of docs) {
-      // Add the custom slug path
       params.push({
         version,
         slug: doc.slug.split("/").filter(Boolean),
@@ -97,13 +92,9 @@ export default async function DocPage({ params }: PageProps) {
   const versions = getCachedVersions()
   const config = getConfig()
   const isCategory = isCategoryPage(slug, allDocs)
-
-  // Try to get the doc (might be index.mdx or regular .mdx)
   const doc = await getCachedDocBySlug(slug, version)
 
-  // If no doc found and it's a category, show category index
   if (!doc && isCategory) {
-    // Find a doc in this category to get the tab group
     const categoryDoc = allDocs.find((d) => d.slug.startsWith(slug + "/"))
     const categoryTabGroup = categoryDoc?.meta?.tab_group || categoryDoc?.categoryTabGroup
 
@@ -113,7 +104,7 @@ export default async function DocPage({ params }: PageProps) {
           header={<Header currentVersion={version} versions={versions} config={config} />}
           docs={allDocs}
           version={version}
-          content={
+          children={
             <CategoryIndex
               categoryPath={slug}
               version={version}
@@ -134,7 +125,6 @@ export default async function DocPage({ params }: PageProps) {
     )
   }
 
-  // If no doc found, render 404 content within the layout (keeps sidebar visible)
   if (!doc) {
     return (
       <>
@@ -143,7 +133,7 @@ export default async function DocPage({ params }: PageProps) {
             header={<Header currentVersion={version} versions={versions} config={config} />}
             docs={allDocs}
             version={version}
-            content={<NotFoundContent version={version} />}
+            children={<NotFoundContent version={version} />}
             toc={<div />}
             config={config}
             currentPageTabGroup={undefined}
@@ -158,15 +148,7 @@ export default async function DocPage({ params }: PageProps) {
 
   const toc = extractTableOfContents(doc.content)
   const { previous, next } = getAdjacentDocs(slug, allDocs)
-
-  // console.log("[v0] Extracted ToC:", toc)
-
-  // If doc exists but is also a category, show both content and children
   const showCategoryIndex = isCategory && doc
-
-  // console.log("showCategoryIndex: ", showCategoryIndex)
-
-  // Get current page's tab group from doc metadata or category
   const currentPageTabGroup = doc.meta?.tab_group || doc.categoryTabGroup
 
   return (
@@ -176,36 +158,34 @@ export default async function DocPage({ params }: PageProps) {
           header={<Header currentVersion={version} versions={versions} config={config} />}
           docs={allDocs}
           version={version}
-          content={
-            showCategoryIndex ? (
-              <CategoryIndex
-                categoryPath={slug}
-                version={version}
-                allDocs={allDocs}
-                title={doc.meta.title}
-                description={doc.meta.description}
-                content={doc.content}
-                config={config}
-              />
-            ) : (
-              <DocLayout
-                meta={doc.meta}
-                content={doc.content}
-                previousDoc={previous ? { title: previous.meta.title, slug: previous.slug } : undefined}
-                nextDoc={next ? { title: next.meta.title, slug: next.slug } : undefined}
-                version={version}
-                slug={slug}
-                config={config}
-              />
-            )
-          }
           toc={showCategoryIndex ? <div /> : <TableOfContents items={toc} config={config} />}
           config={config}
           currentPageTabGroup={currentPageTabGroup}
-        />
+        >
+          {showCategoryIndex ? (
+            <CategoryIndex
+              categoryPath={slug}
+              version={version}
+              allDocs={allDocs}
+              title={doc.meta.title}
+              description={doc.meta.description}
+              content={doc.content}
+              config={config}
+            />
+          ) : (
+            <DocLayout
+              meta={doc.meta}
+              content={doc.content}
+              previousDoc={previous ? { title: previous.meta.title, slug: previous.slug } : undefined}
+              nextDoc={next ? { title: next.meta.title, slug: next.slug } : undefined}
+              version={version}
+              slug={slug}
+              config={config}
+            />
+          )}
+        </DocLayoutWrapper>
         <MdxHotReload />
         <HotReloadIndicator />
-        <DevModeBadge />
       </Suspense>
     </>
   )

package/templates/minimal/app/layout.tsx

@@ -1,33 +1,15 @@
-import "server-only"
-
-import type React from "react"
 import type { Metadata } from "next"
-import { Geist, Geist_Mono } from "next/font/google"
-
+import { Geist } from "next/font/google"
 import { getConfig, getAssetPath, SpecraConfig, initConfig } from "specra/lib"
-import { TabProvider, ConfigProvider } from "specra/components"
-
+import { ConfigProvider, TabProvider } from "specra/components"
 import specraConfig from "../specra.config.json"
 import "./globals.css"
 
-/* -----------------------------
-   Fonts
------------------------------- */
 const geist = Geist({ subsets: ["latin"] })
-const geistMono = Geist_Mono({ subsets: ["latin"] })
-
-// const sans = Geist({ subsets: ["latin"] })
-// const geistMono = Geist_Mono({ subsets: ["latin"] })
 
-/* -----------------------------
-   Initialize Specra config ONCE
-   (module scope, server-only)
------------------------------- */
+// Initialize Specra config
 initConfig(specraConfig as unknown as Partial<SpecraConfig>)
 
-/* -----------------------------
-   Runtime Metadata (REQUIRED)
------------------------------- */
 export async function generateMetadata(): Promise<Metadata> {
   const config = getConfig()
 
@@ -37,13 +19,9 @@ export async function generateMetadata(): Promise<Metadata> {
       template: `%s | ${config.site.title}`,
     },
     description: config.site.description || "Modern documentation platform",
-    metadataBase: config.site.url
-      ? new URL(config.site.url)
-      : undefined,
+    metadataBase: config.site.url ? new URL(config.site.url) : undefined,
     icons: {
-      icon: config.site.favicon
-        ? [{ url: getAssetPath(config.site.favicon) }]
-        : [],
+      icon: config.site.favicon ? [{ url: getAssetPath(config.site.favicon) }] : [],
       apple: getAssetPath("/apple-icon.png"),
     },
     openGraph: {
@@ -62,24 +40,13 @@ export async function generateMetadata(): Promise<Metadata> {
   }
 }
 
-/* -----------------------------
-   Root Layout
------------------------------- */
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode
-}) {
+export default function RootLayout({ children }: { children: React.ReactNode }) {
   const config = getConfig()
-  const defaultTab =
-    config.navigation?.tabGroups?.[0]?.id ?? ""
+  const defaultTab = config.navigation?.tabGroups?.[0]?.id ?? ""
 
   return (
     <html lang={config.site.language || "en"}>
-      <body
-        // className={`${geist.className} ${geistMono.className} antialiased`}
-        className={`font-sans antialiased`}
-      >
+      <body className={`${geist.className} font-sans antialiased`}>
         <ConfigProvider config={config}>
           <TabProvider defaultTab={defaultTab}>
             {children}

package/templates/minimal/app/not-found.tsx

@@ -0,0 +1,10 @@
+
+import { VersionNotFound } from "specra/components"
+
+export default function NotFound() {
+  return (
+    <>
+      <VersionNotFound />
+    </>
+  )
+}

package/templates/minimal/app/page.tsx

@@ -1,7 +1,7 @@
 import Link from "next/link"
 import { ArrowRight, BookOpen, Zap, Code, Github, Twitter, Linkedin } from "lucide-react"
-import { getConfig, getAssetPath } from "specra/lib"
-import { Button, SiteBanner } from "specra/components"
+import { getConfig } from "specra/lib"
+import { Button, SiteBanner, Logo } from "specra/components"
 
 export default function HomePage() {
   // Server component - can use getConfig directly
@@ -16,13 +16,7 @@ export default function HomePage() {
       <header className="border-b border-border">
         <div className="container flex h-16 items-center justify-between px-6 mx-auto">
           <Link href="/" className="flex items-center gap-2">
-            {config.site.logo ? (
-              <img src={getAssetPath(config.site.logo ?? "")} alt={config.site.title} className="h-8 w-auto" />
-            ) : (
-              <div className="h-8 w-8 rounded-xl bg-primary flex items-center justify-center">
-                <span className="text-primary-foreground font-bold text-lg">S</span>
-              </div>
-            )}
+            <Logo logo={config.site.logo} alt={config.site.title} className="w-18 object-contain" />
             <span className="font-semibold text-lg text-foreground">Specra</span>
           </Link>
           <div className="flex items-center gap-6">

package/templates/minimal/next.config.mjs

@@ -1,18 +1 @@
-const mode = process.env.NEXT_BUILD_MODE || "default";
-
-let config;
-let target = ""
-
-switch (mode) {
-  case "export":
-    config = await import("./next.config.export.mjs");
-    target = "export"
-    break;
-  default:
-    config = await import("./next.config.default.mjs");
-    target = "server"
-}
-
-console.log(`Building for target: ${target}`)
-
-export default config.default ?? config;
+export { default } from "specra/next-config"

package/templates/minimal/package-lock.json

@@ -6408,6 +6408,96 @@
         "type": "github",
         "url": "https://github.com/sponsors/wooorm"
       }
+    },
+    "node_modules/@next/swc-darwin-arm64": {
+      "version": "16.1.0",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.1.0.tgz",
+      "integrity": "sha512-onHq8dl8KjDb8taANQdzs3XmIqQWV3fYdslkGENuvVInFQzZnuBYYOG2HGHqqtvgmEU7xWzhgndXXxnhk4Z3fQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-darwin-x64": {
+      "version": "16.1.0",
+      "resolved": "https://registry.npmjs.org/@next/swc-darwin-x64/-/swc-darwin-x64-16.1.0.tgz",
+      "integrity": "sha512-Am6VJTp8KhLuAH13tPrAoVIXzuComlZlMwGr++o2KDjWiKPe3VwpxYhgV6I4gKls2EnsIMggL4y7GdXyDdJcFA==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-linux-arm64-gnu": {
+      "version": "16.1.0",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-gnu/-/swc-linux-arm64-gnu-16.1.0.tgz",
+      "integrity": "sha512-fVicfaJT6QfghNyg8JErZ+EMNQ812IS0lmKfbmC01LF1nFBcKfcs4Q75Yy8IqnsCqH/hZwGhqzj3IGVfWV6vpA==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-linux-arm64-musl": {
+      "version": "16.1.0",
+      "resolved": "https://registry.npmjs.org/@next/swc-linux-arm64-musl/-/swc-linux-arm64-musl-16.1.0.tgz",
+      "integrity": "sha512-TojQnDRoX7wJWXEEwdfuJtakMDW64Q7NrxQPviUnfYJvAx5/5wcGE+1vZzQ9F17m+SdpFeeXuOr6v3jbyusYMQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-win32-arm64-msvc": {
+      "version": "16.1.0",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-arm64-msvc/-/swc-win32-arm64-msvc-16.1.0.tgz",
+      "integrity": "sha512-+DK/akkAvvXn5RdYN84IOmLkSy87SCmpofJPdB8vbLmf01BzntPBSYXnMvnEEv/Vcf3HYJwt24QZ/s6sWAwOMQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
+    },
+    "node_modules/@next/swc-win32-x64-msvc": {
+      "version": "16.1.0",
+      "resolved": "https://registry.npmjs.org/@next/swc-win32-x64-msvc/-/swc-win32-x64-msvc-16.1.0.tgz",
+      "integrity": "sha512-Tr0j94MphimCCks+1rtYPzQFK+faJuhHWCegU9S9gDlgyOk8Y3kPmO64UcjyzZAlligeBtYZ/2bEyrKq0d2wqQ==",
+      "cpu": [
+        "x64"
+      ],
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      }
     }
   }
 }

package/templates/minimal/package.json

@@ -18,7 +18,7 @@
     "next": "^16.1.0",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
-    "specra": "^0.1.4"
+    "specra": "^0.1.6"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.9",

package/templates/minimal/{middleware.ts → proxy_.ts}

@@ -1,13 +1,12 @@
-import { NextResponse } from "next/server"
-import type { NextRequest } from "next/server"
+import { createSecurityProxy } from "specra/middleware/security"
 
 // Note: Redirects from frontmatter are handled at build time via next.config.js
-// This middleware can be extended for dynamic redirects if needed
+// This proxy handles runtime security headers, path validation, and dynamic logic
 
-export function middleware(request: NextRequest) {
-  // Add any runtime middleware logic here
-  return NextResponse.next()
-}
+export const proxy = createSecurityProxy({
+  production: process.env.NODE_ENV === "production",
+  strictPathValidation: true,
+})
 
 export const config = {
   matcher: [