@nexus-framework/cli 0.1.1

package/dist/generators/index.js

@@ -0,0 +1,154 @@
+/**
+ * NEXUS CLI - Generator Orchestrator
+ *
+ * Coordinates all generators to produce a complete project.
+ * Also provides `adoptProject()` for adding .nexus/ to existing projects.
+ */
+import path from 'node:path';
+import { execa } from 'execa';
+import ora from 'ora';
+import { logger, writeGeneratorResult, getInstallCommand, gitInit } from '../utils/index.js';
+import { generateAiConfig } from './ai-config.js';
+import { generateCiCd } from './ci-cd.js';
+import { generateConfigs } from './config.js';
+import { generateDocs } from './docs.js';
+import { generateLandingPage } from './landing-page.js';
+import { generateDirectories, generatePackageJson, generateGitignore, generateReadme, } from './structure.js';
+import { generateTests } from './tests.js';
+/**
+ * Run all generators and write the project to disk.
+ */
+export async function generateProject(config) {
+    const projectRoot = path.resolve(process.cwd(), config.projectName);
+    const spinner = ora('Generating project structure...').start();
+    try {
+        // Collect all directories and files
+        const directories = generateDirectories(config);
+        const files = [
+            generatePackageJson(config),
+            generateGitignore(),
+            generateReadme(config),
+            ...generateDocs(config),
+            ...generateConfigs(config),
+            ...generateTests(config),
+            ...generateCiCd(config),
+            ...generateLandingPage(config),
+            ...generateAiConfig(config),
+        ];
+        // Write everything to disk
+        await writeGeneratorResult(projectRoot, files, directories);
+        spinner.succeed('Project structure generated.');
+        // Install dependencies
+        if (config.installDeps) {
+            const installCmd = getInstallCommand(config.packageManager);
+            const installSpinner = ora(`Installing dependencies with ${config.packageManager}...`).start();
+            try {
+                const [cmd, ...args] = installCmd.split(' ');
+                await execa(cmd, args, { cwd: projectRoot });
+                installSpinner.succeed('Dependencies installed.');
+            }
+            catch {
+                installSpinner.warn('Dependency installation failed. Run it manually.');
+            }
+        }
+        // Initialize git
+        if (config.git) {
+            const gitSpinner = ora('Initializing git repository...').start();
+            const success = await gitInit(projectRoot);
+            if (success) {
+                gitSpinner.succeed('Git repository initialized.');
+            }
+            else {
+                gitSpinner.warn('Git initialization skipped.');
+            }
+        }
+        // Done!
+        logger.complete(config.projectName);
+    }
+    catch (err) {
+        spinner.fail('Project generation failed.');
+        throw err;
+    }
+}
+/* ──────────────────────────────────────────────────────────────
+ * Adopt mode — add .nexus/ to an existing project
+ * ────────────────────────────────────────────────────────────── */
+/**
+ * Add NEXUS documentation and AI config to an existing project.
+ *
+ * This generates only:
+ *   - .nexus/docs/ (8 documentation files + index + manifest)
+ *   - .nexus/ai/   (AI agent instructions)
+ *   - Root AI pointer files (.cursorrules, AGENTS.md, etc.)
+ *
+ * It does NOT scaffold source code, configs, tests, or landing pages.
+ */
+export async function adoptProject(targetDir, projectInfo) {
+    const spinner = ora('Generating NEXUS documentation & AI config...').start();
+    try {
+        // Build a minimal NexusConfig from detected project info
+        const config = buildAdoptConfig(targetDir, projectInfo);
+        // Directories to create
+        const directories = [
+            { path: '.nexus' },
+            { path: '.nexus/docs' },
+            { path: '.nexus/ai' },
+            { path: '.github' },
+        ];
+        // Files to generate — docs + AI config only
+        const files = [
+            ...generateDocs(config),
+            ...generateAiConfig(config),
+        ];
+        // Write to disk
+        await writeGeneratorResult(targetDir, files, directories);
+        spinner.succeed('NEXUS documentation & AI config generated.');
+    }
+    catch (err) {
+        spinner.fail('Adopt failed.');
+        throw err;
+    }
+}
+/**
+ * Build a NexusConfig from detected ProjectInfo.
+ *
+ * Maps detected values to the closest NexusConfig equivalents,
+ * using sensible defaults for anything not detected.
+ */
+function buildAdoptConfig(targetDir, info) {
+    return {
+        projectName: info.name ?? path.basename(targetDir),
+        projectType: 'web',
+        dataStrategy: 'cloud-first',
+        appPatterns: [],
+        frontendFramework: mapFramework(info.framework),
+        backendStrategy: 'integrated',
+        backendFramework: 'none',
+        testFramework: mapTestFramework(info.testFramework),
+        packageManager: mapPackageManager(info.packageManager),
+        git: true,
+        installDeps: false,
+    };
+}
+function mapFramework(detected) {
+    const valid = ['nextjs', 'react-vite', 'sveltekit', 'nuxt', 'remix', 'astro'];
+    if (detected && valid.includes(detected)) {
+        return detected;
+    }
+    return 'nextjs'; // safe default
+}
+function mapTestFramework(detected) {
+    if (detected === 'vitest')
+        return 'vitest';
+    if (detected === 'jest')
+        return 'jest';
+    return 'vitest'; // default
+}
+function mapPackageManager(detected) {
+    if (detected === 'yarn')
+        return 'yarn';
+    if (detected === 'pnpm')
+        return 'pnpm';
+    return 'npm';
+}
+//# sourceMappingURL=index.js.map

package/dist/generators/index.js.map

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

package/dist/generators/landing-page.d.ts

@@ -0,0 +1,13 @@
+/**
+ * NEXUS CLI - Landing Page Generator
+ *
+ * Generates a branded NEXUS landing page for each supported frontend framework.
+ * Also generates the NEXUS logo SVG and favicon for the public/ directory.
+ */
+import type { NexusConfig } from '../types/config.js';
+import type { GeneratedFile } from '../types/templates.js';
+/**
+ * Generate all landing page files for the chosen framework.
+ */
+export declare function generateLandingPage(config: NexusConfig): GeneratedFile[];
+//# sourceMappingURL=landing-page.d.ts.map

package/dist/generators/landing-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"landing-page.d.ts","sourceRoot":"","sources":["../../src/generators/landing-page.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,oBAAoB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAuE3D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,EAAE,CAiBxE"}

package/dist/generators/landing-page.js

@@ -0,0 +1,448 @@
+/**
+ * NEXUS CLI - Landing Page Generator
+ *
+ * Generates a branded NEXUS landing page for each supported frontend framework.
+ * Also generates the NEXUS logo SVG and favicon for the public/ directory.
+ */
+/* ──────────────────────────────────────────────────────────────
+ * Shared: inline SVG logo (the "Neural Network" concept)
+ * ────────────────────────────────────────────────────────────── */
+const NEXUS_SVG_LOGO = `<svg xmlns="http://www.w3.org/2000/svg" width="200" height="200" viewBox="0 0 200 200" fill="none">
+  <!-- Connection lines -->
+  <path d="M100 100 L60 60" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L140 60" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L60 140" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L140 140" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L100 40" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L100 160" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L40 100" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <path d="M100 100 L160 100" stroke="#00D9FF" stroke-width="2" opacity="0.3"/>
+  <!-- Nodes -->
+  <circle cx="100" cy="100" r="20" fill="#00D9FF" opacity="1"/>
+  <circle cx="60" cy="60" r="12" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="140" cy="60" r="12" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="60" cy="140" r="12" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="140" cy="140" r="12" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="100" cy="40" r="10" fill="#00D9FF" opacity="0.5"/>
+  <circle cx="100" cy="160" r="10" fill="#00D9FF" opacity="0.5"/>
+  <circle cx="40" cy="100" r="10" fill="#00D9FF" opacity="0.5"/>
+  <circle cx="160" cy="100" r="10" fill="#00D9FF" opacity="0.5"/>
+</svg>`;
+/* ──────────────────────────────────────────────────────────────
+ * Shared: favicon as a 32×32 SVG (used as favicon.svg)
+ * ────────────────────────────────────────────────────────────── */
+const NEXUS_FAVICON_SVG = `<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 200 200" fill="none">
+  <circle cx="100" cy="100" r="90" fill="#0A0A0A"/>
+  <path d="M100 100 L60 60" stroke="#00D9FF" stroke-width="3" opacity="0.3"/>
+  <path d="M100 100 L140 60" stroke="#00D9FF" stroke-width="3" opacity="0.3"/>
+  <path d="M100 100 L60 140" stroke="#00D9FF" stroke-width="3" opacity="0.3"/>
+  <path d="M100 100 L140 140" stroke="#00D9FF" stroke-width="3" opacity="0.3"/>
+  <circle cx="100" cy="100" r="22" fill="#00D9FF"/>
+  <circle cx="60" cy="60" r="10" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="140" cy="60" r="10" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="60" cy="140" r="10" fill="#00D9FF" opacity="0.7"/>
+  <circle cx="140" cy="140" r="10" fill="#00D9FF" opacity="0.7"/>
+</svg>`;
+/* ──────────────────────────────────────────────────────────────
+ * Shared CSS (embedded in each template)
+ * ────────────────────────────────────────────────────────────── */
+function landingCSS() {
+    return `*,*::before,*::after{box-sizing:border-box;margin:0;padding:0}
+html{color-scheme:dark}
+body{font-family:system-ui,-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Oxygen,Ubuntu,Cantarell,sans-serif;background:#0a0a0a;color:#ededed;min-height:100vh;display:flex;flex-direction:column;align-items:center;justify-content:center}
+.nexus-landing{display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;padding:2rem;min-height:100vh;gap:2rem}
+.nexus-logo{width:160px;height:160px;animation:pulse 3s ease-in-out infinite}
+@keyframes pulse{0%,100%{opacity:1;transform:scale(1)}50%{opacity:.85;transform:scale(1.04)}}
+.nexus-title{font-size:clamp(2.5rem,6vw,4rem);font-weight:800;letter-spacing:-.03em;background:linear-gradient(135deg,#00D9FF 0%,#00FF87 100%);-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}
+.nexus-subtitle{font-size:clamp(1rem,2.5vw,1.35rem);color:#888;max-width:520px;line-height:1.6}
+.nexus-meta{display:flex;gap:1.5rem;flex-wrap:wrap;justify-content:center;margin-top:.5rem}
+.nexus-badge{font-size:.85rem;padding:.35rem .85rem;border-radius:9999px;border:1px solid #222;color:#aaa;background:#111}
+.nexus-links{display:flex;gap:1rem;margin-top:1rem}
+.nexus-links a{color:#00D9FF;text-decoration:none;font-weight:600;padding:.6rem 1.4rem;border-radius:.5rem;border:1px solid #00D9FF33;transition:all .2s}
+.nexus-links a:hover{background:#00D9FF15;border-color:#00D9FF}
+.nexus-footer{position:fixed;bottom:1.5rem;font-size:.8rem;color:#555}
+.nexus-footer a{color:#00D9FF;text-decoration:none}`;
+}
+/* ──────────────────────────────────────────────────────────────
+ * Public API
+ * ────────────────────────────────────────────────────────────── */
+/**
+ * Generate all landing page files for the chosen framework.
+ */
+export function generateLandingPage(config) {
+    const files = [];
+    // Always include the logo SVG in public/
+    files.push({ path: 'public/nexus-logo.svg', content: NEXUS_SVG_LOGO });
+    files.push({ path: 'public/favicon.svg', content: NEXUS_FAVICON_SVG });
+    // Only generate landing pages for frontend project types
+    if (config.projectType === 'api') {
+        return files;
+    }
+    // Framework-specific landing page + CSS
+    const pageFiles = getLandingPageForFramework(config.frontendFramework, config.projectName);
+    files.push(...pageFiles);
+    return files;
+}
+/**
+ * Return the correct landing page files based on the framework.
+ */
+function getLandingPageForFramework(framework, projectName) {
+    switch (framework) {
+        case 'nextjs':
+            return nextjsLandingPage(projectName);
+        case 'react-vite':
+            return reactViteLandingPage(projectName);
+        case 'sveltekit':
+            return sveltekitLandingPage(projectName);
+        case 'nuxt':
+            return nuxtLandingPage(projectName);
+        case 'astro':
+            return astroLandingPage(projectName);
+        case 'remix':
+            return nextjsLandingPage(projectName); // Remix uses React/TSX
+        default:
+            return nextjsLandingPage(projectName);
+    }
+}
+/* ──────────────────────────────────────────────────────────────
+ * Next.js (App Router) — src/app/page.tsx + src/app/layout.tsx + globals.css
+ * ────────────────────────────────────────────────────────────── */
+function nextjsLandingPage(projectName) {
+    const page = `import Image from "next/image";
+
+export default function Home() {
+  return (
+    <div className="nexus-landing">
+      <Image
+        className="nexus-logo"
+        src="/nexus-logo.svg"
+        alt="NEXUS Logo"
+        width={160}
+        height={160}
+        priority
+      />
+      <h1 className="nexus-title">${projectName}</h1>
+      <p className="nexus-subtitle">
+        Built with <strong>NEXUS CLI</strong> — the AI-native project scaffolding tool by GDA Africa.
+        Your project is ready. Start building something amazing.
+      </p>
+      <div className="nexus-meta">
+        <span className="nexus-badge">Next.js 15</span>
+        <span className="nexus-badge">TypeScript</span>
+        <span className="nexus-badge">NEXUS Docs</span>
+      </div>
+      <div className="nexus-links">
+        <a href="https://github.com/GDA-Africa/nexus-cli" target="_blank" rel="noopener noreferrer">
+          Documentation
+        </a>
+        <a href="https://github.com/GDA-Africa" target="_blank" rel="noopener noreferrer">
+          GDA Africa
+        </a>
+      </div>
+      <footer className="nexus-footer">
+        Scaffolded with 🔮 <a href="https://github.com/GDA-Africa/nexus-cli">NEXUS CLI</a> by{" "}
+        <a href="https://github.com/GDA-Africa">GDA Africa</a>
+      </footer>
+    </div>
+  );
+}
+`;
+    const layout = `import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "${projectName}",
+  description: "Generated with NEXUS CLI by GDA Africa",
+  icons: {
+    icon: "/favicon.svg",
+  },
+};
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}
+`;
+    const css = landingCSS();
+    return [
+        { path: 'src/app/page.tsx', content: page },
+        { path: 'src/app/layout.tsx', content: layout },
+        { path: 'src/app/globals.css', content: css },
+    ];
+}
+/* ──────────────────────────────────────────────────────────────
+ * React + Vite — src/App.tsx + src/main.tsx + index.html + src/index.css
+ * ────────────────────────────────────────────────────────────── */
+function reactViteLandingPage(projectName) {
+    const app = `import "./index.css";
+
+function App() {
+  return (
+    <div className="nexus-landing">
+      <img className="nexus-logo" src="/nexus-logo.svg" alt="NEXUS Logo" width={160} height={160} />
+      <h1 className="nexus-title">${projectName}</h1>
+      <p className="nexus-subtitle">
+        Built with <strong>NEXUS CLI</strong> — the AI-native project scaffolding tool by GDA Africa.
+        Your project is ready. Start building something amazing.
+      </p>
+      <div className="nexus-meta">
+        <span className="nexus-badge">React + Vite</span>
+        <span className="nexus-badge">TypeScript</span>
+        <span className="nexus-badge">NEXUS Docs</span>
+      </div>
+      <div className="nexus-links">
+        <a href="https://github.com/GDA-Africa/nexus-cli" target="_blank" rel="noopener noreferrer">
+          Documentation
+        </a>
+        <a href="https://github.com/GDA-Africa" target="_blank" rel="noopener noreferrer">
+          GDA Africa
+        </a>
+      </div>
+      <footer className="nexus-footer">
+        Scaffolded with 🔮 <a href="https://github.com/GDA-Africa/nexus-cli">NEXUS CLI</a> by{" "}
+        <a href="https://github.com/GDA-Africa">GDA Africa</a>
+      </footer>
+    </div>
+  );
+}
+
+export default App;
+`;
+    const main = `import React from "react";
+import ReactDOM from "react-dom/client";
+import App from "./App";
+
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>,
+);
+`;
+    const indexHtml = `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${projectName}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>
+`;
+    const css = landingCSS();
+    return [
+        { path: 'src/App.tsx', content: app },
+        { path: 'src/main.tsx', content: main },
+        { path: 'index.html', content: indexHtml },
+        { path: 'src/index.css', content: css },
+    ];
+}
+/* ──────────────────────────────────────────────────────────────
+ * SvelteKit — src/routes/+page.svelte + src/routes/+layout.svelte + src/app.css + src/app.html
+ * ────────────────────────────────────────────────────────────── */
+function sveltekitLandingPage(projectName) {
+    const page = `<script lang="ts">
+  // ${projectName} — Landing Page
+</script>
+
+<div class="nexus-landing">
+  <img class="nexus-logo" src="/nexus-logo.svg" alt="NEXUS Logo" width="160" height="160" />
+  <h1 class="nexus-title">${projectName}</h1>
+  <p class="nexus-subtitle">
+    Built with <strong>NEXUS CLI</strong> — the AI-native project scaffolding tool by GDA Africa.
+    Your project is ready. Start building something amazing.
+  </p>
+  <div class="nexus-meta">
+    <span class="nexus-badge">SvelteKit</span>
+    <span class="nexus-badge">TypeScript</span>
+    <span class="nexus-badge">NEXUS Docs</span>
+  </div>
+  <div class="nexus-links">
+    <a href="https://github.com/GDA-Africa/nexus-cli" target="_blank" rel="noopener noreferrer">
+      Documentation
+    </a>
+    <a href="https://github.com/GDA-Africa" target="_blank" rel="noopener noreferrer">
+      GDA Africa
+    </a>
+  </div>
+  <footer class="nexus-footer">
+    Scaffolded with 🔮 <a href="https://github.com/GDA-Africa/nexus-cli">NEXUS CLI</a> by
+    <a href="https://github.com/GDA-Africa">GDA Africa</a>
+  </footer>
+</div>
+`;
+    const layout = `<script lang="ts">
+  import "../app.css";
+  let { children } = $props();
+</script>
+
+<svelte:head>
+  <title>${projectName}</title>
+  <meta name="description" content="Generated with NEXUS CLI by GDA Africa" />
+  <link rel="icon" href="/favicon.svg" />
+</svelte:head>
+
+{@render children()}
+`;
+    const appHtml = `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body>
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>
+`;
+    const css = landingCSS();
+    return [
+        { path: 'src/routes/+page.svelte', content: page },
+        { path: 'src/routes/+layout.svelte', content: layout },
+        { path: 'src/app.html', content: appHtml },
+        { path: 'src/app.css', content: css },
+    ];
+}
+/* ──────────────────────────────────────────────────────────────
+ * Nuxt 3 — app.vue + pages/index.vue + assets/css/main.css + nuxt.config.ts
+ * ────────────────────────────────────────────────────────────── */
+function nuxtLandingPage(projectName) {
+    const appVue = `<template>
+  <NuxtPage />
+</template>
+`;
+    const indexPage = `<template>
+  <div class="nexus-landing">
+    <img class="nexus-logo" src="/nexus-logo.svg" alt="NEXUS Logo" width="160" height="160" />
+    <h1 class="nexus-title">${projectName}</h1>
+    <p class="nexus-subtitle">
+      Built with <strong>NEXUS CLI</strong> — the AI-native project scaffolding tool by GDA Africa.
+      Your project is ready. Start building something amazing.
+    </p>
+    <div class="nexus-meta">
+      <span class="nexus-badge">Nuxt 3</span>
+      <span class="nexus-badge">TypeScript</span>
+      <span class="nexus-badge">NEXUS Docs</span>
+    </div>
+    <div class="nexus-links">
+      <a href="https://github.com/GDA-Africa/nexus-cli" target="_blank" rel="noopener noreferrer">
+        Documentation
+      </a>
+      <a href="https://github.com/GDA-Africa" target="_blank" rel="noopener noreferrer">
+        GDA Africa
+      </a>
+    </div>
+    <footer class="nexus-footer">
+      Scaffolded with 🔮 <a href="https://github.com/GDA-Africa/nexus-cli">NEXUS CLI</a> by
+      <a href="https://github.com/GDA-Africa">GDA Africa</a>
+    </footer>
+  </div>
+</template>
+
+<script setup lang="ts">
+useHead({
+  title: "${projectName}",
+  meta: [{ name: "description", content: "Generated with NEXUS CLI by GDA Africa" }],
+  link: [{ rel: "icon", type: "image/svg+xml", href: "/favicon.svg" }],
+});
+</script>
+`;
+    const css = landingCSS();
+    const nuxtConfig = `// https://nuxt.com/docs/api/configuration/nuxt-config
+export default defineNuxtConfig({
+  compatibilityDate: "2025-01-01",
+  devtools: { enabled: true },
+  css: ["~/assets/css/main.css"],
+  app: {
+    head: {
+      link: [{ rel: "icon", type: "image/svg+xml", href: "/favicon.svg" }],
+    },
+  },
+});
+`;
+    return [
+        { path: 'app.vue', content: appVue },
+        { path: 'pages/index.vue', content: indexPage },
+        { path: 'assets/css/main.css', content: css },
+        { path: 'nuxt.config.ts', content: nuxtConfig },
+    ];
+}
+/* ──────────────────────────────────────────────────────────────
+ * Astro — src/pages/index.astro + src/layouts/Layout.astro + src/styles/global.css
+ * ────────────────────────────────────────────────────────────── */
+function astroLandingPage(projectName) {
+    const indexAstro = `---
+import Layout from "../layouts/Layout.astro";
+---
+
+<Layout title="${projectName}">
+  <div class="nexus-landing">
+    <img class="nexus-logo" src="/nexus-logo.svg" alt="NEXUS Logo" width="160" height="160" />
+    <h1 class="nexus-title">${projectName}</h1>
+    <p class="nexus-subtitle">
+      Built with <strong>NEXUS CLI</strong> — the AI-native project scaffolding tool by GDA Africa.
+      Your project is ready. Start building something amazing.
+    </p>
+    <div class="nexus-meta">
+      <span class="nexus-badge">Astro</span>
+      <span class="nexus-badge">TypeScript</span>
+      <span class="nexus-badge">NEXUS Docs</span>
+    </div>
+    <div class="nexus-links">
+      <a href="https://github.com/GDA-Africa/nexus-cli" target="_blank" rel="noopener noreferrer">
+        Documentation
+      </a>
+      <a href="https://github.com/GDA-Africa" target="_blank" rel="noopener noreferrer">
+        GDA Africa
+      </a>
+    </div>
+    <footer class="nexus-footer">
+      Scaffolded with 🔮 <a href="https://github.com/GDA-Africa/nexus-cli">NEXUS CLI</a> by
+      <a href="https://github.com/GDA-Africa">GDA Africa</a>
+    </footer>
+  </div>
+</Layout>
+`;
+    const layoutAstro = `---
+import "../styles/global.css";
+
+interface Props {
+  title: string;
+}
+
+const { title } = Astro.props;
+---
+
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="description" content="Generated with NEXUS CLI by GDA Africa" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
+    <title>{title}</title>
+  </head>
+  <body>
+    <slot />
+  </body>
+</html>
+`;
+    const css = landingCSS();
+    return [
+        { path: 'src/pages/index.astro', content: indexAstro },
+        { path: 'src/layouts/Layout.astro', content: layoutAstro },
+        { path: 'src/styles/global.css', content: css },
+    ];
+}
+//# sourceMappingURL=landing-page.js.map

package/dist/generators/landing-page.js.map

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

package/dist/generators/structure.d.ts

@@ -0,0 +1,24 @@
+/**
+ * NEXUS CLI - Structure Generator
+ *
+ * Generates the folder structure and base files for a new project.
+ */
+import type { NexusConfig } from '../types/config.js';
+import type { GeneratedFile, GeneratedDirectory } from '../types/templates.js';
+/**
+ * Generate the base directory structure for any project type.
+ */
+export declare function generateDirectories(config: NexusConfig): GeneratedDirectory[];
+/**
+ * Generate the project's package.json content.
+ */
+export declare function generatePackageJson(config: NexusConfig): GeneratedFile;
+/**
+ * Generate .gitignore file.
+ */
+export declare function generateGitignore(): GeneratedFile;
+/**
+ * Generate a basic README for the created project.
+ */
+export declare function generateReadme(config: NexusConfig): GeneratedFile;
+//# sourceMappingURL=structure.d.ts.map