create-specra 0.1.0

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

@@ -0,0 +1,29 @@
+---
+title: Welcome to Your Documentation
+description: Get started with your Specra documentation site
+---
+
+# Welcome to Your Documentation
+
+This is your documentation home page. Start editing this file to create your own content!
+
+## Quick Start
+
+1. **Edit this file** at `docs/v1.0.0/index.mdx`
+2. **Add new pages** by creating `.mdx` files in the `docs/v1.0.0/` directory
+3. **Customize your site** by editing `specra.config.json`
+
+## Example Pages
+
+Check out these example pages to learn how to use Specra:
+
+- [Getting Started](./getting-started) - Learn the basics
+- [Features](./features) - Explore what Specra can do
+- [Configuration](./configuration) - Customize your site
+- [Components](./components) - See available components
+
+## Need Help?
+
+- Read the [Specra documentation](https://specra.dev/docs)
+- Check out [Next.js docs](https://nextjs.org/docs)
+- Learn about [MDX](https://mdxjs.com)

package/templates/minimal/middleware.ts

@@ -0,0 +1,23 @@
+import { NextResponse } from "next/server"
+import type { NextRequest } from "next/server"
+
+// Note: Redirects from frontmatter are handled at build time via next.config.js
+// This middleware can be extended for dynamic redirects if needed
+
+export function middleware(request: NextRequest) {
+  // Add any runtime middleware logic here
+  return NextResponse.next()
+}
+
+export const config = {
+  matcher: [
+    /*
+     * Match all request paths except for the ones starting with:
+     * - api (API routes)
+     * - _next/static (static files)
+     * - _next/image (image optimization files)
+     * - favicon.ico (favicon file)
+     */
+    "/((?!api|_next/static|_next/image|favicon.ico).*)",
+  ],
+}

package/templates/minimal/next.config.default.mjs

@@ -0,0 +1,36 @@
+import fs from "fs"
+import path from "path"
+import { fileURLToPath } from "url"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Load redirects from generated file
+let redirects = []
+try {
+  const redirectsPath = path.join(__dirname, "redirects.json")
+  if (fs.existsSync(redirectsPath)) {
+    redirects = JSON.parse(fs.readFileSync(redirectsPath, "utf8"))
+  }
+} catch (error) {
+  console.warn("Could not load redirects.json:", error.message)
+}
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: "standalone", // Default to standalone for Vercel/Node.js hosting
+  typescript: {
+    ignoreBuildErrors: true,
+  },
+  images: {
+    unoptimized: true,
+  },
+  // Empty turbopack config to silence the warning
+  // Turbopack handles file watching automatically
+  turbopack: {},
+  async redirects() {
+    return redirects
+  },
+}
+
+export default nextConfig

package/templates/minimal/next.config.export.mjs

@@ -0,0 +1,62 @@
+import fs from "fs"
+import path from "path"
+import { fileURLToPath } from "url"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+// Load redirects from generated file
+let redirects = []
+try {
+  const redirectsPath = path.join(__dirname, "redirects.json")
+  if (fs.existsSync(redirectsPath)) {
+    redirects = JSON.parse(fs.readFileSync(redirectsPath, "utf8"))
+  }
+} catch (error) {
+  console.warn("Could not load redirects.json:", error.message)
+}
+
+// Load deployment config from specra.config.json
+let basePath = ""
+try {
+  const configPath = path.join(__dirname, "specra.config.json")
+  if (fs.existsSync(configPath)) {
+    const config = JSON.parse(fs.readFileSync(configPath, "utf8"))
+    const deployment = config.deployment || {}
+
+    // Only apply basePath for GitHub Pages without custom domain
+    if (deployment.target === "github-pages" && !deployment.customDomain && deployment.basePath) {
+      basePath = deployment.basePath.startsWith("/")
+        ? deployment.basePath
+        : `/${deployment.basePath}`
+    }
+
+    console.log(`\n📦 Building for static export with deployment target: ${deployment.target || 'not specified'}`)
+    if (basePath) {
+      console.log(`🔗 Using basePath: ${basePath}`)
+    } else {
+      console.log(`🔗 No basePath applied (custom domain or root deployment)`)
+    }
+  }
+} catch (error) {
+  console.warn("Could not load deployment config from specra.config.json:", error.message)
+}
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: "export", // Always export for static hosting
+  basePath: basePath || undefined,
+  typescript: {
+    ignoreBuildErrors: true,
+  },
+  images: {
+    unoptimized: true,
+  },
+  // Empty turbopack config to silence the warning
+  turbopack: {},
+  async redirects() {
+    return redirects
+  },
+}
+
+export default nextConfig

package/templates/minimal/next.config.mjs

@@ -0,0 +1,18 @@
+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;