create-specra 0.1.7 → 0.2.1

package/templates/minimal/docs/v1.0.0/about.mdx

@@ -4,7 +4,7 @@ sidebar_position: 1
 icon: info
 ---
 
-Specra is a self-hosted, Mintlify-quality documentation platform built with **Next.js**, **MDX**, and **Tailwind CSS**. It provides a polished, readable docs experience with powerful features for both readers and writers.
+Specra is a self-hosted, Mintlify-quality documentation platform built with **SvelteKit**, **MDX**, and **Tailwind CSS**. It provides a polished, readable docs experience with powerful features for both readers and writers.
 
 ## Why Specra?
 
@@ -17,8 +17,8 @@ Specra is a self-hosted, Mintlify-quality documentation platform built with **Ne
 
 ## Built With
 
-- **Next.js 15** - React framework with App Router
-- **MDX** - Markdown with React components
+- **SvelteKit** - Svelte framework with file-based routing
+- **MDX** - Markdown with Svelte components
 - **Tailwind CSS** - Utility-first styling
 - **Meilisearch** - Fast, typo-tolerant search
 - **TypeScript** - Full type safety

package/templates/minimal/docs/v2.0.0/about.mdx

@@ -4,7 +4,7 @@ sidebar_position: 1
 icon: info
 ---
 
-Specra is a self-hosted, Mintlify-quality documentation platform built with **Next.js**, **MDX**, and **Tailwind CSS**. It provides a polished, readable docs experience with powerful features for both readers and writers.
+Specra is a self-hosted, Mintlify-quality documentation platform built with **SvelteKit**, **MDX**, and **Tailwind CSS**. It provides a polished, readable docs experience with powerful features for both readers and writers.
 
 ## Why Specra?
 
@@ -17,8 +17,8 @@ Specra is a self-hosted, Mintlify-quality documentation platform built with **Ne
 
 ## Built With
 
-- **Next.js 15** - React framework with App Router
-- **MDX** - Markdown with React components
+- **SvelteKit** - Svelte framework with file-based routing
+- **MDX** - Markdown with Svelte components
 - **Tailwind CSS** - Utility-first styling
 - **Meilisearch** - Fast, typo-tolerant search
 - **TypeScript** - Full type safety

package/templates/minimal/gitignore

@@ -0,0 +1,7 @@
+node_modules
+.svelte-kit
+build
+.env
+.env.*
+!.env.example
+vite.config.ts.timestamp-*

package/templates/minimal/package.json

@@ -1,34 +1,28 @@
 {
-  "name": "specra-minimal",
-  "version": "0.1.0",
+  "name": "my-docs",
+  "version": "0.0.1",
   "private": true,
+  "type": "module",
   "scripts": {
-    "dev": "next dev",
-    "build": "npm run generate:redirects && NEXT_BUILD_MODE=default next build",
-    "build:export": "npm run generate:redirects && NEXT_BUILD_MODE=export next build && npm run generate:static-redirects",
-    "start": "next start",
-    "lint": "eslint .",
-    "generate:redirects": "node scripts/generate-redirects.mjs",
-    "generate:static-redirects": "node scripts/generate-static-redirects.mjs",
-    "index:search": "tsx scripts/index-search.ts",
-    "test:search": "tsx scripts/test-search.ts"
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json"
   },
   "dependencies": {
-    "lucide-react": "^0.454.0",
-    "next": "^16.1.0",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "specra": "^0.1.7"
+    "specra": "^0.2.1"
   },
   "devDependencies": {
-    "@tailwindcss/postcss": "^4.1.18",
+    "@sveltejs/adapter-auto": "^3.0.0",
+    "@sveltejs/kit": "^2.0.0",
+    "@sveltejs/vite-plugin-svelte": "^6.0.0",
+    "@tailwindcss/postcss": "^4.1.9",
     "@tailwindcss/typography": "^0.5.19",
-    "@types/node": "^22",
-    "@types/react": "^19",
-    "@types/react-dom": "^19",
-    "postcss": "^8.5.6",
-    "tailwindcss": "^4.1.18",
-    "tsx": "^4.21.0",
-    "typescript": "^5"
+    "postcss": "^8.5",
+    "svelte": "^5.0.0",
+    "svelte-check": "^4.0.0",
+    "tailwindcss": "^4.1.9",
+    "typescript": "^5",
+    "vite": "^6.3.0"
   }
 }

package/templates/minimal/specra.config.json

@@ -1,15 +1,14 @@
 {
   "$schema": "./node_modules/specra/config/specra.config.schema.json",
   "site": {
-    "title": "Specra Docs",
-    "description": "Comprehensive documentation for your project",
-    "url": "https://vercel.com/dalmasontos-projects/v0-documentation-library",
+    "title": "My Docs",
+    "description": "Documentation for my project",
+    "url": "http://localhost:5173",
     "baseUrl": "/",
     "language": "en",
-    "organizationName": "dalmasonto",
-    "projectName": "specra",
-    "activeVersion": "v1.0.0",
-    "favicon": "/icon-light-32x32.png"
+    "organizationName": "my-org",
+    "projectName": "my-project",
+    "activeVersion": "v1.0.0"
   },
   "theme": {
     "defaultMode": "system",
@@ -41,32 +40,13 @@
     ]
   },
   "social": {
-    "github": "https://github.com/dalmasonto",
-    "twitter": "https://twitter.com/dalmasonto",
-    "discord": "https://discord.com/invite/dalmasonto",
-    "custom": [
-      {
-        "label": "Website",
-        "url": "https://craftfolio.com/dalmasonto"
-      }
-    ]
+    "github": "https://github.com/your-org/your-repo"
   },
   "search": {
-    "enabled": true,
-    "placeholder": "Search documentation...",
-    "provider": "meilisearch",
-    "meilisearch": {
-      "host": "http://localhost:7700",
-      "apiKey": "aSampleMasterKey",
-      "indexName": "docs"
-    }
-  },
-  "analytics": {
-    "googleAnalytics": "",
-    "plausible": ""
+    "enabled": false
   },
   "footer": {
-    "copyright": "Copyright © 2024 Specra. All rights reserved.",
+    "copyright": "Copyright © 2025 My Project. All rights reserved.",
     "links": [
       {
         "title": "Documentation",
@@ -74,10 +54,6 @@
           {
             "label": "Getting Started",
             "href": "/docs/v1.0.0/getting-started"
-          },
-          {
-            "label": "API Reference",
-            "href": "/docs/v1.0.0/api"
           }
         ]
       },
@@ -86,45 +62,18 @@
         "items": [
           {
             "label": "GitHub",
-            "href": "https://github.com/yourusername/your-repo"
-          },
-          {
-            "label": "Discord",
-            "href": "#"
+            "href": "https://github.com/your-org/your-repo"
           }
         ]
       }
-    ],
-    "branding": {
-      "showBranding": true,
-      "logo": "https://tokenkit.s3.amazonaws.com/logo_fa8c1a32da814a209b06c742fbf2a862.png",
-      "title": "Specra",
-      "url": "https://specra.dev"
-    }
-  },
-  "banner": {
-    "enabled": false,
-    "message": "🎉 This is a development version. Some features may not work as expected.",
-    "type": "error",
-    "dismissible": true
+    ]
   },
   "features": {
-    "editUrl": "https://github.com/yourusername/your-repo/edit/main/docs",
     "showLastUpdated": true,
     "showReadingTime": true,
     "showAuthors": false,
     "showTags": true,
     "versioning": true,
     "i18n": false
-  },
-  "env": {
-    "API_BASE_URL": "https://api.example.com",
-    "API_VERSION": "v1",
-    "CDN_URL": "https://cdn.example.com"
-  },
-  "deployment": {
-    "target": "vercel",
-    "basePath": "",
-    "customDomain": false
   }
-}
+}

package/templates/minimal/src/app.css

@@ -0,0 +1,8 @@
+@import "specra/styles";
+@source "./**/*.{js,ts,svelte}";
+
+
+:root {
+    --font-sans: "Geist", "Geist Fallback";
+    --font-mono: "Geist Mono", "Geist Mono Fallback";
+}

package/templates/minimal/src/app.html

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en">
+	<head>
+		<meta charset="utf-8" />
+		<link rel="icon" href="%sveltekit.assets%/favicon.svg" type="image/svg+xml" />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+		<link rel="preconnect" href="https://fonts.googleapis.com">
+		<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+		<link
+			href="https://fonts.googleapis.com/css2?family=Geist+Mono:wght@100..900&family=Geist:wght@100..900&display=swap"
+			rel="stylesheet">
+		%sveltekit.head%
+	</head>
+	<body data-sveltekit-preload-data="hover" class="font-sans antialiased">
+		<div style="display: contents">%sveltekit.body%</div>
+	</body>
+</html>

package/templates/minimal/src/routes/+layout.server.ts

@@ -0,0 +1,11 @@
+import { getConfig, initConfig } from 'specra';
+import specraConfig from '../../specra.config.json';
+import type { LayoutServerLoad } from './$types';
+import type { SpecraConfig } from 'specra';
+
+initConfig(specraConfig as unknown as Partial<SpecraConfig>);
+
+export const load: LayoutServerLoad = async () => {
+  const config = getConfig();
+  return { config };
+};

package/templates/minimal/src/routes/+layout.svelte

@@ -0,0 +1,21 @@
+<script lang="ts">
+  import '../app.css';
+  import { LayoutProviders } from 'specra/components';
+  import type { Snippet } from 'svelte';
+  import type { LayoutData } from './$types';
+
+  let { data, children }: { data: LayoutData; children: Snippet } = $props();
+</script>
+
+<svelte:head>
+  <title>{data?.config?.site?.title || 'Documentation'}</title>
+  <meta name="description" content={data?.config?.site?.description || 'Modern documentation platform'} />
+</svelte:head>
+
+{#if data?.config}
+  <LayoutProviders config={data.config}>
+    {@render children?.()}
+  </LayoutProviders>
+{:else}
+  {@render children?.()}
+{/if}

package/templates/minimal/src/routes/+page.server.ts

@@ -0,0 +1,9 @@
+import { redirect } from '@sveltejs/kit';
+import { getConfig } from 'specra';
+import type { PageServerLoad } from './$types';
+
+export const load: PageServerLoad = async () => {
+  const config = getConfig();
+  const activeVersion = config.site?.activeVersion || 'v1.0.0';
+  redirect(302, `/docs/${activeVersion}/about`);
+};

package/templates/minimal/src/routes/docs/[version]/[...slug]/+page.server.ts

@@ -0,0 +1,119 @@
+import {
+  extractTableOfContents,
+  getAdjacentDocs,
+  isCategoryPage,
+  getCachedVersions,
+  getCachedAllDocs,
+  getCachedDocBySlug,
+  getI18nConfig,
+  getConfig,
+} from 'specra';
+import type { PageServerLoad } from './$types';
+
+export const load: PageServerLoad = async ({ params }) => {
+  const { version, slug: slugArray } = params;
+  const slug = slugArray;
+
+  const i18nConfig = getI18nConfig();
+  const slugParts = slug.split('/');
+  let locale: string | undefined;
+  if (i18nConfig && i18nConfig.locales.includes(slugParts[0])) {
+    locale = slugParts[0];
+  }
+
+  const allDocs = await getCachedAllDocs(version, locale);
+  const versions = getCachedVersions();
+  const config = getConfig();
+  const isCategory = isCategoryPage(slug, allDocs);
+  const doc = await getCachedDocBySlug(slug, version);
+
+  let title = 'Page Not Found';
+  let description = 'The requested documentation page could not be found.';
+  let ogUrl = `/docs/${version}/${slug}`;
+
+  if (doc) {
+    title = doc.meta.title || doc.title;
+    description = doc.meta.description || `Documentation for ${title}`;
+  }
+
+  // Category page without doc content
+  if (!doc && isCategory) {
+    const categoryDoc = allDocs.find((d) => d.slug.startsWith(slug + '/'));
+    const categoryTabGroup = categoryDoc?.meta?.tab_group || categoryDoc?.categoryTabGroup;
+    const categoryTitle = slug
+      .split('/')
+      .pop()
+      ?.replace(/-/g, ' ')
+      .replace(/\b\w/g, (l) => l.toUpperCase()) || 'Category';
+
+    return {
+      version,
+      slug,
+      allDocs,
+      versions,
+      config,
+      isCategory: true,
+      isNotFound: false,
+      doc: null,
+      categoryTitle,
+      categoryDescription: 'Browse the documentation in this section.',
+      categoryTabGroup,
+      toc: [],
+      previous: null,
+      next: null,
+      title,
+      description,
+      ogUrl,
+    };
+  }
+
+  // Not found
+  if (!doc) {
+    return {
+      version,
+      slug,
+      allDocs,
+      versions,
+      config,
+      isCategory: false,
+      isNotFound: true,
+      doc: null,
+      categoryTitle: null,
+      categoryDescription: null,
+      categoryTabGroup: undefined,
+      toc: [],
+      previous: null,
+      next: null,
+      title,
+      description,
+      ogUrl,
+    };
+  }
+
+  // Normal doc page
+  const toc = extractTableOfContents(doc.meta.content || doc.content);
+  const { previous, next } = getAdjacentDocs(slug, allDocs);
+  const showCategoryIndex = isCategory && !!doc;
+  const matchingDoc = allDocs.find((d) => d.slug === slug);
+  const currentPageTabGroup = doc.meta?.tab_group || matchingDoc?.categoryTabGroup;
+
+  return {
+    version,
+    slug,
+    allDocs,
+    versions,
+    config,
+    isCategory: showCategoryIndex,
+    isNotFound: false,
+    doc,
+    categoryTitle: null,
+    categoryDescription: null,
+    categoryTabGroup: currentPageTabGroup,
+    toc,
+    previous: previous ? { title: previous.meta.title, slug: previous.slug } : null,
+    next: next ? { title: next.meta.title, slug: next.slug } : null,
+    title,
+    description,
+    ogUrl,
+  };
+};

package/templates/minimal/src/routes/docs/[version]/[...slug]/+page.svelte

@@ -0,0 +1,129 @@
+<script lang="ts">
+  import {
+    TableOfContents,
+    Header,
+    DocLayout,
+    CategoryIndex,
+    HotReloadIndicator,
+    DevModeBadge,
+    MdxHotReload,
+    MdxContent,
+    NotFoundContent,
+    SearchHighlight,
+    MobileDocLayout,
+    mdxComponents,
+  } from 'specra/components';
+  import type { PageData } from './$types';
+
+  let { data }: { data: PageData } = $props();
+
+  let allDocsCompat: any[] = $derived(data.allDocs);
+  let previousDoc = $derived(data.previous ?? undefined);
+  let nextDoc = $derived(data.next ?? undefined);
+  let categoryTitle = $derived(data.categoryTitle ?? undefined);
+  let categoryDescription = $derived(data.categoryDescription ?? undefined);
+</script>
+
+<svelte:head>
+  <title>{data.title}</title>
+  <meta name="description" content={data.description} />
+  <meta property="og:title" content={data.title} />
+  <meta property="og:description" content={data.description} />
+  <meta property="og:url" content={data.ogUrl} />
+  <meta property="og:type" content="article" />
+  <meta name="twitter:card" content="summary_large_image" />
+  <meta name="twitter:title" content={data.title} />
+  <meta name="twitter:description" content={data.description} />
+</svelte:head>
+
+{#if !data.doc && data.isCategory}
+  <MobileDocLayout
+    docs={allDocsCompat}
+    version={data.version}
+    config={data.config}
+    activeTabGroup={data.categoryTabGroup}
+  >
+    {#snippet header()}
+      <Header currentVersion={data.version} versions={data.versions} config={data.config} />
+    {/snippet}
+    <CategoryIndex
+      categoryPath={data.slug}
+      version={data.version}
+      allDocs={allDocsCompat}
+      title={categoryTitle}
+      description={categoryDescription}
+      config={data.config}
+    />
+  </MobileDocLayout>
+  <MdxHotReload />
+  <HotReloadIndicator />
+  <DevModeBadge />
+{:else if data.isNotFound}
+  <MobileDocLayout
+    docs={allDocsCompat}
+    version={data.version}
+    config={data.config}
+  >
+    {#snippet header()}
+      <Header currentVersion={data.version} versions={data.versions} config={data.config} />
+    {/snippet}
+    <NotFoundContent version={data.version} />
+  </MobileDocLayout>
+  <MdxHotReload />
+  <HotReloadIndicator />
+  <DevModeBadge />
+{:else if data.doc}
+  <MobileDocLayout
+    docs={allDocsCompat}
+    version={data.version}
+    config={data.config}
+    activeTabGroup={data.categoryTabGroup}
+  >
+    {#snippet header()}
+      <Header currentVersion={data.version} versions={data.versions} config={data.config} />
+    {/snippet}
+    {#snippet toc()}
+      {#if !data.isCategory}
+        <TableOfContents items={data.toc} config={data.config} />
+      {/if}
+    {/snippet}
+
+    {#if data.isCategory}
+      {#snippet categoryContent()}
+        {#if data.doc?.contentNodes}
+          <MdxContent nodes={data.doc.contentNodes} components={mdxComponents} />
+        {:else if data.doc?.content}
+          {@html data.doc.content}
+        {/if}
+      {/snippet}
+      <CategoryIndex
+        categoryPath={data.slug}
+        version={data.version}
+        allDocs={allDocsCompat}
+        title={data.doc.meta.title}
+        description={data.doc.meta.description}
+        content={categoryContent}
+        config={data.config}
+      />
+    {:else}
+      <SearchHighlight />
+      <DocLayout
+        meta={data.doc.meta}
+        previousDoc={previousDoc}
+        nextDoc={nextDoc}
+        version={data.version}
+        slug={data.slug}
+        config={data.config}
+      >
+        {#if data.doc.contentNodes}
+          <MdxContent nodes={data.doc.contentNodes} components={mdxComponents} />
+        {:else}
+          {@html data.doc.content}
+        {/if}
+      </DocLayout>
+    {/if}
+  </MobileDocLayout>
+  <MdxHotReload />
+  <HotReloadIndicator />
+  <DevModeBadge />
+{/if}

package/templates/minimal/svelte.config.js

@@ -0,0 +1,8 @@
+import { specraConfig } from 'specra/svelte-config';
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
+
+const config = specraConfig({
+  vitePreprocess: { vitePreprocess }
+});
+
+export default config;

package/templates/minimal/tsconfig.json

@@ -1,41 +1,12 @@
 {
+  "extends": "./.svelte-kit/tsconfig.json",
   "compilerOptions": {
-    "lib": [
-      "dom",
-      "dom.iterable",
-      "esnext"
-    ],
     "allowJs": true,
-    "target": "ES6",
-    "skipLibCheck": true,
-    "strict": true,
-    "noEmit": true,
+    "checkJs": true,
     "esModuleInterop": true,
-    "module": "esnext",
-    "moduleResolution": "bundler",
+    "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true,
-    "isolatedModules": true,
-    "jsx": "react-jsx",
-    "incremental": true,
-    "plugins": [
-      {
-        "name": "next"
-      }
-    ],
-    "paths": {
-      "@/*": [
-        "./*"
-      ]
-    }
-  },
-  "include": [
-    "next-env.d.ts",
-    "**/*.ts",
-    "**/*.tsx",
-    ".next/types/**/*.ts",
-    ".next/dev/types/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}
+    "skipLibCheck": true,
+    "strict": true
+  }
+}

package/templates/minimal/vite.config.ts

@@ -0,0 +1,6 @@
+import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+	plugins: [sveltekit()]
+});