create-veap 0.1.3 → 0.3.0

package/bin/veap.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 import { createRequire } from "module";
+
 const require = createRequire(import.meta.url);
 
 // We run the compiled CLI from dist

package/dist/commands/init.js

@@ -2,12 +2,12 @@ import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import ora from "ora";
-import { processStubs } from "../utils.js";
+import { appendGitignore, clearAppDirectory, injectVeapDependencies, writeEnvFile, } from "../mutate.js";
 import { applyPackageManager, pmInstall, pmRunCommand, resolvePackageManager, } from "../package-manager.js";
-import { scaffoldNextApp } from "../scaffold.js";
-import { promptConfirm, promptProjectName } from "../prompts.js";
 import { parseProjectName, projectNameError } from "../project-name.js";
-import { appendGitignore, clearAppDirectory, injectVeapDependencies, writeEnvFile, } from "../mutate.js";
+import { promptConfirm, promptProjectName } from "../prompts.js";
+import { scaffoldNextApp } from "../scaffold.js";
+import { processStubs } from "../utils.js";
 export async function initProject(name, options) {
     // ---- Resolve the project name: from the CLI argument or the interactive
     // prompt (which resolves to a default on non-TTY, so scripts never hang).
@@ -75,7 +75,6 @@ export async function initProject(name, options) {
             path.join(destDir, "public"),
             path.join(destDir, "storage"),
             path.join(destDir, "plugins"),
-            path.join(destDir, "templates"),
         ]) {
             if (!fs.existsSync(dir)) {
                 fs.mkdirSync(dir, { recursive: true });

package/dist/package-manager.js

@@ -53,9 +53,7 @@ export function detectPackageManager(dir) {
         return {
             pm: "pnpm",
             source: "lockfile",
-            detail: `multiple lockfiles found: ${found
-                .map((l) => l.file)
-                .join(", ")}`,
+            detail: `multiple lockfiles found: ${found.map((l) => l.file).join(", ")}`,
         };
     }
     if (found.length === 1) {
@@ -189,11 +187,11 @@ export function applyPackageManager(projectDir, pm) {
         // undefined in package.json to avoid a shadowing duplicate). Written
         // only when missing - an existing one is the source of truth.
         if (!fs.existsSync(pnpmWorkspace)) {
-            fs.writeFileSync(pnpmWorkspace, 'packages:\n  - "plugins/*"\n  - "templates/*"\n', "utf-8");
+            fs.writeFileSync(pnpmWorkspace, 'packages:\n  - "plugins/*"\n', "utf-8");
         }
     }
     else {
-        pkg.workspaces = ["plugins/*", "templates/*"];
+        pkg.workspaces = ["plugins/*"];
         if (fs.existsSync(pnpmWorkspace)) {
             // Switching away from pnpm: the file would shadow the workspaces field.
             fs.rmSync(pnpmWorkspace);

package/dist/scaffold.d.ts

@@ -12,15 +12,17 @@ export interface ScaffoldOptions {
  * instead of hanging the scaffolder). `--skip-install` keeps a single
  * dependency install at the end of `initProject`, after veap mutations.
  */
-export declare function buildCreateNextAppCommand(name: string, opts: ScaffoldOptions): string;
+export declare function buildCreateNextAppCommand(name: string, opts: ScaffoldOptions, runnerOverride?: string): string;
 /**
  * Normalizes a project name into a shell-safe, npm-friendly folder name.
  * CNA derives the package name from the folder, so the same charset applies.
  */
 export declare function sanitizeProjectName(name: string): string | null;
 /**
- * Runs create-next-app. Throws (with the CNA output already streamed to the
- * terminal) when scaffolding fails - CNA removes its own partial output.
+ * Runs create-next-app. If the package-manager-specific runner fails (for
+ * example, Bun's known IPv6 ConnectionRefused bug on Windows when downloading
+ * tarballs), it transparently falls back to npx so the project is still
+ * properly scaffolded with all chosen options.
  * Returns the (possibly sanitized) project directory name.
  */
 export declare function scaffoldNextApp(name: string, opts: ScaffoldOptions): string;

package/dist/scaffold.js

@@ -1,4 +1,6 @@
 import { execSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
 /**
  * Scaffolds the Next.js shell of a new project with the official
  * `create-next-app` (CNA) instead of duplicating its boilerplate in stubs.
@@ -22,7 +24,7 @@ const CNA_RUNNERS = {
  * instead of hanging the scaffolder). `--skip-install` keeps a single
  * dependency install at the end of `initProject`, after veap mutations.
  */
-export function buildCreateNextAppCommand(name, opts) {
+export function buildCreateNextAppCommand(name, opts, runnerOverride) {
     const flags = [
         "--ts",
         "--tailwind",
@@ -35,7 +37,20 @@ export function buildCreateNextAppCommand(name, opts) {
         '"@/*"',
         "--skip-install",
     ];
-    return `${CNA_RUNNERS[opts.pm]} "${name}" ${flags.join(" ")}`;
+    if (opts.pm === "bun") {
+        flags.push("--use-bun");
+    }
+    else if (opts.pm === "pnpm") {
+        flags.push("--use-pnpm");
+    }
+    else if (opts.pm === "yarn") {
+        flags.push("--use-yarn");
+    }
+    else if (opts.pm === "npm") {
+        flags.push("--use-npm");
+    }
+    const runner = runnerOverride ?? CNA_RUNNERS[opts.pm];
+    return `${runner} "${name}" ${flags.join(" ")}`;
 }
 /**
  * Normalizes a project name into a shell-safe, npm-friendly folder name.
@@ -46,8 +61,10 @@ export function sanitizeProjectName(name) {
     return safe === name ? null : safe;
 }
 /**
- * Runs create-next-app. Throws (with the CNA output already streamed to the
- * terminal) when scaffolding fails - CNA removes its own partial output.
+ * Runs create-next-app. If the package-manager-specific runner fails (for
+ * example, Bun's known IPv6 ConnectionRefused bug on Windows when downloading
+ * tarballs), it transparently falls back to npx so the project is still
+ * properly scaffolded with all chosen options.
  * Returns the (possibly sanitized) project directory name.
  */
 export function scaffoldNextApp(name, opts) {
@@ -57,6 +74,29 @@ export function scaffoldNextApp(name, opts) {
     }
     const projectName = sanitized ?? name;
     const command = buildCreateNextAppCommand(projectName, opts);
-    execSync(command, { cwd: opts.cwd, stdio: "inherit" });
+    try {
+        execSync(command, { cwd: opts.cwd, stdio: "inherit" });
+    }
+    catch (primaryErr) {
+        if (opts.pm !== "npm") {
+            console.warn(`\n⚠️  ${opts.pm} failed to run create-next-app (e.g. network/IPv6 timeout). Falling back to npx...`);
+            // Clean up partially created directory if exists and empty
+            const targetPath = path.join(opts.cwd, projectName);
+            if (fs.existsSync(targetPath)) {
+                try {
+                    const files = fs.readdirSync(targetPath);
+                    if (files.length === 0) {
+                        fs.rmSync(targetPath, { recursive: true, force: true });
+                    }
+                }
+                catch { }
+            }
+            const fallbackCommand = buildCreateNextAppCommand(projectName, opts, CNA_RUNNERS.npm);
+            execSync(fallbackCommand, { cwd: opts.cwd, stdio: "inherit" });
+        }
+        else {
+            throw primaryErr;
+        }
+    }
     return projectName;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-veap",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Initializer for Veap Framework applications",
   "bugs": "https://github.com/veapjs/create-veap/issues",
   "repository": {

package/stubs/docker/.dockerignore.stub

@@ -1,39 +1,39 @@
-node_modules/
-.pnpm-store/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-pnpm-debug.log*
-
-.next/
-out/
-dist/
-build/
-.vercel/
-
-coverage/
-*.test.*
-*.spec.*
-
-.git/
-.gitignore
-.vscode/
-.idea/
-*.swp
-*.log
-
-.env
-.env*.local
-
-Dockerfile*
-.dockerignore
-compose.yaml
-compose.yml
-
-*.md
-docs/
-
-.turbo/
-.tmp/
-.temp/
-.DS_Store
+node_modules/
+.pnpm-store/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+.next/
+out/
+dist/
+build/
+.vercel/
+
+coverage/
+*.test.*
+*.spec.*
+
+.git/
+.gitignore
+.vscode/
+.idea/
+*.swp
+*.log
+
+.env
+.env*.local
+
+Dockerfile*
+.dockerignore
+compose.yaml
+compose.yml
+
+*.md
+docs/
+
+.turbo/
+.tmp/
+.temp/
+.DS_Store

package/stubs/docker/Dockerfile.stub

@@ -1,49 +1,49 @@
-# Stage 1: Base image with pnpm
-FROM node:22-alpine AS base
-RUN apk add --no-cache libc6-compat
-ENV PNPM_HOME="/pnpm"
-ENV PATH="$PNPM_HOME:$PATH"
-
-RUN corepack enable
-RUN corepack prepare pnpm@10.29.3 --activate
-
-# Stage 2: Install dependencies
-FROM base AS deps
-WORKDIR /app
-COPY . .
-RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
-    pnpm config set store-dir /pnpm/store && \
-    pnpm config set fetch-retries 10 && \
-    pnpm config set fetch-retry-maxtimeout 120000 && \
-    pnpm config set fetch-timeout 600000 && \
-    pnpm install --frozen-lockfile
-
-# Stage 3: Build the project
-FROM base AS builder
-WORKDIR /app
-COPY --from=deps /app ./
-RUN pnpm build
-
-# Stage 4: Production runner
-FROM base AS runner
-WORKDIR /app
-
-ENV NODE_ENV=production
-ENV NEXT_TELEMETRY_DISABLED=1
-
-RUN addgroup --system --gid 1001 nodejs
-RUN adduser --system --uid 1001 nextjs
-
-# Automatically leverage output traces to reduce image size
-COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
-COPY --from=builder --chown=nextjs:nodejs /app/.next/static .next/static
-COPY --from=builder --chown=nextjs:nodejs /app/public public
-
-USER nextjs
-
-EXPOSE 3000
-
-ENV PORT=3000
-ENV HOSTNAME="0.0.0.0"
-
-CMD ["node", "./server.js"]
+# Stage 1: Base image with pnpm
+FROM node:22-alpine AS base
+RUN apk add --no-cache libc6-compat
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+
+RUN corepack enable
+RUN corepack prepare pnpm@10.29.3 --activate
+
+# Stage 2: Install dependencies
+FROM base AS deps
+WORKDIR /app
+COPY . .
+RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
+    pnpm config set store-dir /pnpm/store && \
+    pnpm config set fetch-retries 10 && \
+    pnpm config set fetch-retry-maxtimeout 120000 && \
+    pnpm config set fetch-timeout 600000 && \
+    pnpm install --frozen-lockfile
+
+# Stage 3: Build the project
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app ./
+RUN pnpm build
+
+# Stage 4: Production runner
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+# Automatically leverage output traces to reduce image size
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static .next/static
+COPY --from=builder --chown=nextjs:nodejs /app/public public
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT=3000
+ENV HOSTNAME="0.0.0.0"
+
+CMD ["node", "./server.js"]

package/stubs/docker/compose.yml.stub

@@ -1,58 +1,58 @@
-services:
-  # Node.js service (use with: docker compose up {{name}} --build)
-  {{name}}:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    image: {{name}}-image
-    container_name: {{name}}
-    env_file:
-      - .env
-    environment:
-      NODE_ENV: production
-      PORT: "3000"
-      NEXT_TELEMETRY_DISABLED: "1"
-      DATABASE_URL: "postgresql://postgres:postgres@database:5432/postgres?sslmode=disable"
-    depends_on:
-      database:
-        condition: service_healthy
-      redis:
-        condition: service_started
-    ports:
-      - "80:3000"
-    restart: unless-stopped
-    volumes:
-      - ./storage:/app/public/storage
-
-  # PostgreSQL service
-  database:
-    image: postgres:17-alpine
-    container_name: {{name}}-db
-    restart: always
-    environment:
-      POSTGRES_USER: postgres
-      POSTGRES_PASSWORD: postgres
-      POSTGRES_DB: postgres
-    ports:
-      - "5432:5432"
-    volumes:
-      - postgres_data:/var/lib/postgresql/data
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
-      interval: 5s
-      timeout: 5s
-      retries: 5
-
-  # Redis service
-  redis:
-    image: redis:7-alpine
-    container_name: {{name}}-redis
-    restart: always
-    ports:
-      - "6379:6379"
-    volumes:
-      - redis_data:/data
-
-volumes:
-  postgres_data:
-  redis_data:
+services:
+  # Node.js service (use with: docker compose up {{name}} --build)
+  {{name}}:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: {{name}}-image
+    container_name: {{name}}
+    env_file:
+      - .env
+    environment:
+      NODE_ENV: production
+      PORT: "3000"
+      NEXT_TELEMETRY_DISABLED: "1"
+      DATABASE_URL: "postgresql://postgres:postgres@database:5432/postgres?sslmode=disable"
+    depends_on:
+      database:
+        condition: service_healthy
+      redis:
+        condition: service_started
+    ports:
+      - "80:3000"
+    restart: unless-stopped
+    volumes:
+      - ./storage:/app/public/storage
+
+  # PostgreSQL service
+  database:
+    image: postgres:17-alpine
+    container_name: {{name}}-db
+    restart: always
+    environment:
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: postgres
+      POSTGRES_DB: postgres
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  # Redis service
+  redis:
+    image: redis:7-alpine
+    container_name: {{name}}-redis
+    restart: always
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+
+volumes:
+  postgres_data:
+  redis_data:

package/stubs/overlay-full/AGENTS.md.stub

@@ -11,7 +11,7 @@ This project is a **Veap** application: the official `create-next-app` base plus
 - `app/[[...catchAll]]/page.tsx` - every page render goes through `VeapRouter` (route tree built from plugins + app routes). Do not add competing page routes without understanding the router.
 - `app/api/[...catchAll]/route.ts` - API pipeline: middlewares, auth, roles/permissions resolved from the route tree.
 - `app/layout.tsx`, `app/not-found.tsx` - root shell with the bootstrap and the **force-dynamic contract (below)**.
-- `plugins/`, `templates/` - workspace packages (pnpm workspace / npm workspaces).
+- `plugins/` - workspace packages (pnpm workspace / npm workspaces).
 - `migrations/` - app migrations (`veap make:migration`).
 
 ## Critical Contracts (do not break)

package/stubs/overlay-full/app/(site)/layout.tsx.stub

@@ -0,0 +1,10 @@
+import { SiteLayout } from "@/components/site-layout";
+import type { ReactNode } from "react";
+
+export default function NativeSiteLayout({
+  children,
+}: {
+  children: ReactNode;
+}) {
+  return <SiteLayout>{children}</SiteLayout>;
+}

package/stubs/overlay-full/app/[[...catchAll]]/page.tsx.stub

@@ -1,47 +1,47 @@
-import { VeapRouter } from "@veap/framework/router";
-import { buildRouteTree } from "@veap/framework/router/server";
-import type { Metadata } from "next";
-import { initializeSystem } from "@/lib/veap";
-
-export const dynamic = "force-dynamic";
-
-export async function generateMetadata({
-  params,
-  searchParams,
-}: {
-  params: Promise<{ catchAll?: string[] }>;
-  searchParams: Promise<Record<string, string>>;
-}): Promise<Metadata> {
-  const { catchAll } = await params;
-  const sParams = await searchParams;
-  const path = catchAll && catchAll.length > 0 ? `/${catchAll.join("/")}` : "/";
-
-  await initializeSystem();
-  const tree = await buildRouteTree(true);
-  const result = await tree.generateMetadata(path, sParams);
-
-  return result;
-}
-
-export default async function CatchAllPage({
-  params,
-  searchParams,
-}: {
-  params: Promise<{ catchAll?: string[] }>;
-  searchParams: Promise<any>;
-}) {
-  const { catchAll } = await params;
-  const sParams = await searchParams;
-  const path = catchAll && catchAll.length > 0 ? `/${catchAll.join("/")}` : "/";
-
-  await initializeSystem();
-  const tree = await buildRouteTree(true);
-
-  const result = await VeapRouter({
-    tree,
-    path,
-    searchParams: sParams,
-  });
-
-  return result;
-}
+import { VeapRouter } from "@veap/framework/router";
+import { buildRouteTree } from "@veap/framework/router/server";
+import type { Metadata } from "next";
+import { initializeSystem } from "@/lib/veap";
+
+export const dynamic = "force-dynamic";
+
+export async function generateMetadata({
+  params,
+  searchParams,
+}: {
+  params: Promise<{ catchAll?: string[] }>;
+  searchParams: Promise<Record<string, string>>;
+}): Promise<Metadata> {
+  const { catchAll } = await params;
+  const sParams = await searchParams;
+  const path = catchAll && catchAll.length > 0 ? `/${catchAll.join("/")}` : "/";
+
+  await initializeSystem();
+  const tree = await buildRouteTree(true);
+  const result = await tree.generateMetadata(path, sParams);
+
+  return result;
+}
+
+export default async function CatchAllPage({
+  params,
+  searchParams,
+}: {
+  params: Promise<{ catchAll?: string[] }>;
+  searchParams: Promise<any>;
+}) {
+  const { catchAll } = await params;
+  const sParams = await searchParams;
+  const path = catchAll && catchAll.length > 0 ? `/${catchAll.join("/")}` : "/";
+
+  await initializeSystem();
+  const tree = await buildRouteTree(true);
+
+  const result = await VeapRouter({
+    tree,
+    path,
+    searchParams: sParams,
+  });
+
+  return result;
+}