create-frootkit 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrbitNorth LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# create-frootkit
+
+> Official dedicated scaffolder CLI for [FrootKit](https://github.com/orbitnorth/frootkit) — The Zero-Overhead Next.js Alternative.
+
+[![npm version](https://img.shields.io/npm/v/create-frootkit.svg)](https://www.npmjs.com/package/create-frootkit)
+[![license](https://img.shields.io/npm/l/create-frootkit.svg)](https://github.com/orbitnorth/create-frootkit/blob/main/LICENSE)
+
+---
+
+## ⚡ Usage
+
+Scaffold a production-ready FrootKit application in seconds:
+
+```bash
+# Using npm
+npm create frootkit@latest my-app
+
+# Using pnpm
+pnpm create frootkit my-app
+
+# Using bun
+bun create frootkit my-app
+```
+
+### Options
+
+| Flag | Description | Default |
+| :--- | :--- | :--- |
+| `<directory>` | Target project directory | `.` |
+| `--name <name>` | Project package name | Directory name |
+| `--pm <manager>` | Package manager (`npm`, `pnpm`, `bun`, `yarn`) | Auto-detected |
+| `--git` / `--no-git` | Initialize git repository | `--git` |
+| `--install` / `--no-install` | Auto-install dependencies | Prompt |
+| `-y`, `--yes` | Skip prompts and use defaults | `false` |
+
+---
+
+## 📄 License
+
+MIT © [OrbitNorth LLC](https://github.com/orbitnorth)
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * create-frootkit CLI
+ * The official project scaffolder for FrootKit (Next.js Alternative).
+ */
+export * from './template.js';
+export * from './scaffold.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAOH,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * create-frootkit CLI
+ * The official project scaffolder for FrootKit (Next.js Alternative).
+ */
+import * as readline from 'node:readline/promises';
+import { stdin as input, stdout as output } from 'node:process';
+import * as path from 'node:path';
+import { scaffoldProject } from './scaffold.js';
+export * from './template.js';
+export * from './scaffold.js';
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('-h') || args.includes('--help')) {
+        console.log(`
+  ▲ create-frootkit — The Next.js Alternative Project Scaffolder
+
+  Usage:
+    npm create frootkit [project-directory] [options]
+    npx create-frootkit [project-directory] [options]
+
+  Options:
+    -y, --yes          Accept all defaults non-interactively
+    --pm <manager>     Package manager: pnpm | npm | yarn | bun
+    --git / --no-git   Initialize git repository
+    --install          Install dependencies automatically
+    -h, --help         Show help message
+`);
+        process.exit(0);
+    }
+    let projectDir = args.find((a) => !a.startsWith('-')) || '';
+    const isNonInteractive = args.includes('-y') || args.includes('--yes');
+    if (!projectDir && isNonInteractive) {
+        projectDir = 'my-frootkit-app';
+    }
+    let pkgManager = 'npm';
+    const pmArg = args.indexOf('--pm');
+    if (pmArg !== -1 && args[pmArg + 1]) {
+        pkgManager = args[pmArg + 1];
+    }
+    else if (process.env.npm_config_user_agent?.includes('pnpm')) {
+        pkgManager = 'pnpm';
+    }
+    else if (process.env.npm_config_user_agent?.includes('bun')) {
+        pkgManager = 'bun';
+    }
+    let gitInit = args.includes('--git');
+    let installDeps = args.includes('--install');
+    if (!isNonInteractive) {
+        const rl = readline.createInterface({ input, output });
+        console.log(`
+  ▲ FrootKit — Next.js Alternative Scaffolder
+  ──────────────────────────────────────────
+`);
+        if (!projectDir) {
+            projectDir = (await rl.question('  Project directory: (my-frootkit-app) ')).trim() || 'my-frootkit-app';
+        }
+        const gitAnswer = (await rl.question('  Initialize git repository? (Y/n) ')).trim().toLowerCase();
+        gitInit = gitAnswer === '' || gitAnswer === 'y' || gitAnswer === 'yes';
+        const installAnswer = (await rl.question(`  Install dependencies with ${pkgManager}? (y/N) `)).trim().toLowerCase();
+        installDeps = installAnswer === 'y' || installAnswer === 'yes';
+        rl.close();
+    }
+    const targetDir = path.resolve(process.cwd(), projectDir);
+    const projectName = path.basename(targetDir);
+    console.log(`\n  Creating FrootKit application in ${targetDir}...`);
+    const result = await scaffoldProject({
+        targetDir,
+        projectName,
+        pkgManager,
+        gitInit,
+        installDeps,
+    });
+    console.log(`
+  ✓ Created ${result.fileCount} files
+  ${gitInit ? '✓ Initialized git repository\n' : ''}
+  Success! Next steps:
+    $ cd ${projectDir}
+    $ ${pkgManager} install
+    $ ${pkgManager} run dev
+
+  Server starts on http://localhost:3000
+`);
+}
+import { fileURLToPath } from 'node:url';
+// Only execute when invoked directly as CLI
+const thisFile = fileURLToPath(import.meta.url);
+const invokedFile = process.argv[1] ? path.resolve(process.argv[1]) : '';
+const isDirectCli = invokedFile === thisFile ||
+    invokedFile.endsWith('create-frootkit') ||
+    invokedFile.endsWith('create-frootkit\\dist\\index.js') ||
+    invokedFile.endsWith('create-frootkit/dist/index.js') ||
+    invokedFile.endsWith('create-froot-fullstack') ||
+    invokedFile.endsWith('create-froot-fullstack\\dist\\index.js') ||
+    invokedFile.endsWith('create-froot-fullstack/dist/index.js');
+if (isDirectCli && !process.env['NODE_TEST_CONTEXT']) {
+    main().catch((err) => {
+        console.error('Fatal CLI error:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/scaffold.d.ts

@@ -0,0 +1,11 @@
+export interface ScaffoldOptions {
+    targetDir: string;
+    projectName: string;
+    pkgManager?: 'pnpm' | 'npm' | 'yarn' | 'bun';
+    gitInit?: boolean;
+    installDeps?: boolean;
+}
+export declare function scaffoldProject(options: ScaffoldOptions): Promise<{
+    fileCount: number;
+}>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;IAC7C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAqC9F"}

package/dist/scaffold.js

@@ -0,0 +1,35 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { generateFrootKitTemplate } from './template.js';
+const execAsync = promisify(exec);
+export async function scaffoldProject(options) {
+    const { targetDir, projectName, pkgManager = 'npm', gitInit = false, installDeps = false, } = options;
+    await fs.mkdir(targetDir, { recursive: true });
+    const files = generateFrootKitTemplate(projectName);
+    const filePaths = Object.keys(files);
+    for (const relPath of filePaths) {
+        const fullPath = path.join(targetDir, relPath);
+        await fs.mkdir(path.dirname(fullPath), { recursive: true });
+        await fs.writeFile(fullPath, files[relPath], 'utf8');
+    }
+    if (gitInit) {
+        try {
+            await execAsync('git init', { cwd: targetDir });
+        }
+        catch {
+            // ignore git init errors
+        }
+    }
+    if (installDeps) {
+        try {
+            await execAsync(`${pkgManager} install`, { cwd: targetDir });
+        }
+        catch {
+            // ignore install errors
+        }
+    }
+    return { fileCount: filePaths.length };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAUlC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAwB;IAC5D,MAAM,EACJ,SAAS,EACT,WAAW,EACX,UAAU,GAAG,KAAK,EAClB,OAAO,GAAG,KAAK,EACf,WAAW,GAAG,KAAK,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,MAAM,KAAK,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAErC,KAAK,MAAM,OAAO,IAAI,SAAS,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAE,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,GAAG,UAAU,UAAU,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/dist/template.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Template Definition for FrootKit (Next.js Alternative).
+ * Generates an ultra-fast, zero-wrapper Preact SSR application with Tailwind CSS v4.
+ */
+export interface TemplateFileMap {
+    [filePath: string]: string;
+}
+export declare function generateFrootKitTemplate(projectName: string): TemplateFileMap;
+export declare const generateFullstackTemplate: typeof generateFrootKitTemplate;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC5B;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CA6S7E;AAED,eAAO,MAAM,yBAAyB,iCAA2B,CAAC"}

package/dist/template.js

@@ -0,0 +1,293 @@
+/**
+ * Template Definition for FrootKit (Next.js Alternative).
+ * Generates an ultra-fast, zero-wrapper Preact SSR application with Tailwind CSS v4.
+ */
+export function generateFrootKitTemplate(projectName) {
+    return {
+        'package.json': JSON.stringify({
+            name: projectName,
+            version: '1.0.0',
+            type: 'module',
+            scripts: {
+                dev: 'frootkit dev',
+                build: 'frootkit build',
+                start: 'frootkit start',
+            },
+            dependencies: {
+                'frootkit': '^1.2.2',
+                frootjs: '^1.0.6',
+                preact: '^11.1.0',
+                'preact-render-to-string': '^6.8.2',
+            },
+            devDependencies: {
+                '@tailwindcss/cli': '^4.0.0',
+                tailwindcss: '^4.0.0',
+                '@types/node': '^22.10.0',
+                typescript: '^5.8.0',
+            },
+        }, null, 2) + '\n',
+        'tsconfig.json': `{
+  "compilerOptions": {
+    "target": "ES2024",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "jsx": "react-jsx",
+    "jsxImportSource": "preact",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*"]
+}
+`,
+        '.gitignore': `# Dependencies
+node_modules/
+.pnpm-store/
+
+# Froot Fullstack build output (like .next in Next.js)
+.froot/
+dist/
+.cache/
+
+# OS and IDE files
+.DS_Store
+Thumbs.db
+.vscode/
+.idea/
+*.log
+`,
+        'src/styles.css': `@import "tailwindcss";
+
+@theme {
+  --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  --font-mono: 'JetBrains Mono', ui-monospace, SFMono-Regular, monospace;
+
+  --color-brand-50: #ecfdf5;
+  --color-brand-100: #d1fae5;
+  --color-brand-200: #a7f3d0;
+  --color-brand-300: #6ee7b7;
+  --color-brand-400: #34d399;
+  --color-brand-500: #10b981;
+  --color-brand-600: #059669;
+  --color-brand-700: #047857;
+  --color-brand-800: #065f46;
+  --color-brand-900: #064e3b;
+  --color-brand-950: #022c22;
+}
+
+:root {
+  color-scheme: dark;
+}
+
+body {
+  margin: 0;
+  font-family: var(--font-sans);
+  background-color: #030712;
+  color: #f8fafc;
+}
+`,
+        'src/app/layout.tsx': `/** @jsxImportSource preact */
+import type { ComponentChildren } from 'preact';
+
+export interface RootLayoutProps {
+  children: ComponentChildren;
+  metadata?: {
+    title?: string;
+    description?: string;
+  };
+}
+
+export default function RootLayout({ children, metadata }: RootLayoutProps) {
+  const title = metadata?.title || 'Froot Fullstack App — Next.js Alternative';
+  const description = metadata?.description || 'Ultra-fast Preact SSR & Tailwind CSS v4 native web application.';
+
+  return (
+    <html lang="en" class="dark scroll-smooth">
+      <head>
+        <meta charSet="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>{title}</title>
+        <meta name="description" content={description} />
+        <link rel="stylesheet" href="/styles.css" />
+      </head>
+      <body class="bg-[#030712] text-slate-100 min-h-screen antialiased">
+        {children}
+      </body>
+    </html>
+  );
+}
+`,
+        'src/app/page.tsx': `/** @jsxImportSource preact */
+export const metadata = {
+  title: 'Home — Froot Fullstack Application',
+  description: 'Next.js Alternative with Preact SSR, nested layouts, and native Tailwind v4.',
+};
+
+export default function HomePage() {
+  return (
+    <div class="max-w-4xl mx-auto px-6 py-20 text-center">
+      <div class="inline-flex items-center gap-2 px-3 py-1 rounded-full bg-emerald-500/10 border border-emerald-500/25 text-xs font-semibold text-emerald-400 mb-6">
+        Next.js Alternative &bull; Preact SSR &bull; Tailwind CSS v4
+      </div>
+      <h1 class="text-4xl sm:text-6xl font-extrabold text-white tracking-tight mb-4">
+        Extreme Performance <span class="text-emerald-400">Fullstack Engine</span>
+      </h1>
+      <p class="text-slate-300 text-lg max-w-2xl mx-auto mb-8">
+        Sub-millisecond Preact SSR, hierarchical nested layouts, and zero-wrapper CLI builds.
+      </p>
+      <div class="flex items-center justify-center gap-4">
+        <a
+          href="/docs"
+          class="px-5 py-2.5 rounded-lg bg-emerald-500 text-slate-950 font-bold hover:bg-emerald-400 transition-colors"
+        >
+          Explore Docs &rarr;
+        </a>
+      </div>
+    </div>
+  );
+}
+`,
+        'src/app/docs/layout.tsx': `/** @jsxImportSource preact */
+import type { ComponentChildren } from 'preact';
+
+export interface DocsLayoutProps {
+  children: ComponentChildren;
+}
+
+export default function DocsLayout({ children }: DocsLayoutProps) {
+  return (
+    <div class="flex min-h-screen">
+      <aside class="w-64 border-r border-slate-800 bg-[#070b13] p-6 space-y-4">
+        <div class="font-bold text-white text-base">Froot Docs</div>
+        <nav class="space-y-1 text-sm">
+          <a href="/docs" class="block py-1.5 px-3 rounded text-slate-300 hover:text-white hover:bg-slate-800/50">Overview</a>
+          <a href="/docs/quickstart" class="block py-1.5 px-3 rounded text-slate-300 hover:text-white hover:bg-slate-800/50">Quickstart</a>
+        </nav>
+      </aside>
+      <main class="flex-1 max-w-4xl p-10">
+        {children}
+      </main>
+    </div>
+  );
+}
+`,
+        'src/app/docs/page.tsx': `/** @jsxImportSource preact */
+import { getDoc } from 'frootkit';
+
+export const metadata = {
+  title: 'Overview — FrootKit Docs',
+  description: 'Getting started with FrootKit Next.js Alternative.',
+};
+
+export default async function DocsOverviewPage() {
+  const { frontmatter, html } = await getDoc('overview');
+
+  return (
+    <div>
+      <div class="text-xs font-mono uppercase tracking-wider text-emerald-400 mb-2">
+        {frontmatter['category'] || 'Getting Started'}
+      </div>
+      <h1 class="text-3xl font-extrabold text-white mb-6">
+        {frontmatter['title'] || 'Overview'}
+      </h1>
+      <article
+        class="prose prose-invert max-w-none text-slate-300 space-y-4"
+        dangerouslySetInnerHTML={{ __html: html }}
+      />
+    </div>
+  );
+}
+`,
+        'src/app/docs/[slug]/page.tsx': `/** @jsxImportSource preact */
+import { getDoc } from 'frootkit';
+
+export async function generateStaticParams() {
+  return [
+    { slug: 'overview' },
+    { slug: 'quickstart' },
+  ];
+}
+
+export async function generateMetadata({ params }: { params: { slug: string } }) {
+  const slug = params.slug || 'overview';
+  return {
+    title: \`\${slug.charAt(0).toUpperCase() + slug.slice(1)} — FrootKit Docs\`,
+  };
+}
+
+export default async function DocSlugPage({ params }: { params: { slug: string } }) {
+  const slug = params.slug || 'overview';
+  const { frontmatter, html } = await getDoc(slug);
+
+  return (
+    <div>
+      <div class="text-xs font-mono uppercase tracking-wider text-emerald-400 mb-2">
+        {frontmatter['category'] || 'Documentation'}
+      </div>
+      <h1 class="text-3xl font-extrabold text-white mb-6">
+        {frontmatter['title'] || slug}
+      </h1>
+      <article
+        class="prose prose-invert max-w-none text-slate-300 space-y-4"
+        dangerouslySetInnerHTML={{ __html: html }}
+      />
+    </div>
+  );
+}
+`,
+        'content/docs/overview.md': `---
+title: Overview
+category: Getting Started
+summary: Introduction to FrootKit Next.js Alternative architecture.
+---
+
+Welcome to **FrootKit**, the high-performance Next.js alternative powered by Preact, Tailwind CSS v4, and Froot.
+
+## Design Principles
+- **Next.js App Router Conventions:** Nested \`layout.tsx\`, dynamic parameters \`[slug]/page.tsx\`.
+- **Preact SSR Engine:** Ultra-fast server-side JSX rendering with negligible overhead.
+- **Tailwind CSS v4 Native:** CSS-first \`@theme\` variables with zero runtime scripts.
+- **Instant SSG Prerendering:** Pre-renders all static and dynamic paths into \`.froot/\` in milliseconds.
+`,
+        'content/docs/quickstart.md': `---
+title: Quickstart Guide
+category: Getting Started
+summary: Get up and running with FrootKit in less than 2 minutes.
+---
+
+## Running in Development
+\`\`\`bash
+npm run dev
+\`\`\`
+Your server will start with hot-reloading enabled on \`http://localhost:3000\`.
+
+## Production Build & Static Export
+\`\`\`bash
+npm run build
+\`\`\`
+All HTML pages and compiled Tailwind v4 CSS will be exported to \`.froot/\`.
+`,
+        'README.md': `# \${projectName}
+
+A modern, high-performance web application built with **FrootKit** (Next.js Alternative with Preact SSR & Tailwind CSS v4).
+
+## Getting Started
+
+\`\`\`bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Export production static site
+npm run build
+
+# Start production server
+npm run start
+\`\`\`
+`,
+    };
+}
+export const generateFullstackTemplate = generateFrootKitTemplate;
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,SAAS,CAC5B;YACE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,GAAG,EAAE,cAAc;gBACnB,KAAK,EAAE,gBAAgB;gBACvB,KAAK,EAAE,gBAAgB;aACxB;YACD,YAAY,EAAE;gBACZ,UAAU,EAAE,QAAQ;gBACpB,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,SAAS;gBACjB,yBAAyB,EAAE,QAAQ;aACpC;YACD,eAAe,EAAE;gBACf,kBAAkB,EAAE,QAAQ;gBAC5B,WAAW,EAAE,QAAQ;gBACrB,aAAa,EAAE,UAAU;gBACzB,UAAU,EAAE,QAAQ;aACrB;SACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI;QAER,eAAe,EAAE;;;;;;;;;;;;;CAapB;QAEG,YAAY,EAAE;;;;;;;;;;;;;;;CAejB;QAEG,gBAAgB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BrB;QAEG,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BzB;QAEG,kBAAkB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BvB;QAEG,yBAAyB,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuB9B;QAEG,uBAAuB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B5B;QAEG,8BAA8B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCnC;QAEG,0BAA0B,EAAE;;;;;;;;;;;;;CAa/B;QAEG,4BAA4B,EAAE;;;;;;;;;;;;;;;;;CAiBjC;QAEG,WAAW,EAAE;;;;;;;;;;;;;;;;;;;CAmBhB;KACE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC"}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "create-frootkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Interactive CLI for scaffolding high-performance FrootKit (Next.js Alternative) applications",
+  "type": "module",
+  "bin": {
+    "create-frootkit": "./dist/index.js",
+    "create-froot-fullstack": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "node --test tests/*.test.ts"
+  },
+  "keywords": [
+    "froot",
+    "fullstack",
+    "nextjs",
+    "preact",
+    "tailwind",
+    "ssr",
+    "ssg",
+    "cli"
+  ],
+  "author": "OrbitNorth LLC",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/orbitnorth/create-frootkit.git"
+  },
+  "homepage": "https://github.com/orbitnorth/create-frootkit#readme",
+  "bugs": {
+    "url": "https://github.com/orbitnorth/create-frootkit/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.8.0"
+  }
+}
+