create-genesis-app 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# create-genesis-app
+
+Scaffold an opinionated Next.js app into the current folder.
+
+```bash
+pnpm create genesis-app .      # into the current directory
+pnpm create genesis-app my-app # into ./my-app
+```
+
+Also works with `npm create genesis-app@latest .` and `yarn create genesis-app .`.
+
+## What you get
+
+The default `create-next-app` stack, kept current:
+
+- **Next.js** (App Router) + **React** latest
+- **TypeScript** (strict)
+- **Tailwind CSS v4**
+- **ESLint** (flat config, `next/core-web-vitals` + `next/typescript`)
+
+All template dependencies are set to `latest`, so every scaffold pulls the newest
+published versions at install time.
+
+## Flags
+
+| Flag                                    | Effect                                 |
+| --------------------------------------- | -------------------------------------- |
+| `--no-install`                          | Copy files but skip dependency install |
+| `--no-git`                              | Skip `git init`                        |
+| `--pnpm` / `--npm` / `--yarn` / `--bun` | Force a specific package manager       |
+
+By default the CLI uses the package manager that invoked it (`pnpm create` → pnpm,
+`npm create` → npm, etc.), and falls back to **pnpm** when it can't tell. Pass one of
+the flags above to override.
+
+## Repo layout
+
+```
+create-genesis-app/
+├── package.json     # the published package (bin + files)
+├── bin/index.js     # the scaffolder (Node built-ins only, no deps)
+└── template/        # the project that gets copied
+    ├── _gitignore   # de-dotted: npm strips real dotfiles on publish
+    ├── src/
+    ├── public/
+    └── package.json # deps set to "latest"
+```

package/bin/index.js

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+import { cp, rename, readFile, writeFile, readdir, rm } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join, resolve, basename } from "node:path";
+import { spawnSync } from "node:child_process";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const templateDir = join(__dirname, "..", "template");
+
+// ---- parse args -------------------------------------------------------------
+const argv = process.argv.slice(2);
+const flags = new Set(argv.filter((a) => a.startsWith("--")));
+const positional = argv.filter((a) => !a.startsWith("--"));
+
+const target = resolve(process.cwd(), positional[0] ?? ".");
+const projectName = basename(target);
+const skipInstall = flags.has("--no-install");
+const skipGit = flags.has("--no-git");
+
+// Files that npm strips on publish, stored de-dotted in template/.
+const dotfiles = { _gitignore: ".gitignore", _npmrc: ".npmrc", _env: ".env", "_env.local": ".env.local" };
+
+// Pick the package manager: explicit flag > the PM that invoked us > pnpm.
+const KNOWN_PMS = ["pnpm", "npm", "yarn", "bun"];
+const pmFlag = KNOWN_PMS.find((p) => flags.has(`--${p}`));
+const invokedWith = (process.env.npm_config_user_agent ?? "").split("/")[0];
+const pm = pmFlag ?? (KNOWN_PMS.includes(invokedWith) ? invokedWith : "pnpm");
+
+// ---- scaffold ---------------------------------------------------------------
+console.log(`\nCreating a Next.js app in ${target}\n`);
+
+await cp(templateDir, target, {
+  recursive: true,
+  filter: (src) =>
+    !/[\\/](node_modules|\.git|pnpm-lock\.yaml|package-lock\.json)$/.test(src),
+});
+
+// Restore the de-dotted files to their real names.
+for (const [from, to] of Object.entries(dotfiles)) {
+  const fromPath = join(target, from);
+  if (existsSync(fromPath)) await rename(fromPath, join(target, to));
+}
+
+// Drop keep-files: they only exist so npm ships otherwise-empty folders.
+// Removing them leaves the folder present but genuinely empty in the scaffold.
+const allEntries = await readdir(target, { recursive: true });
+for (const entry of allEntries) {
+  if ([".gitkeep", ".keep"].includes(basename(entry))) {
+    await rm(join(target, entry));
+  }
+}
+
+// Use the target folder name as the project name.
+const pkgPath = join(target, "package.json");
+const pkg = JSON.parse(await readFile(pkgPath, "utf8"));
+pkg.name = projectName;
+await writeFile(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+
+// Substitute {{name}} placeholders (e.g. in the README and metadata).
+for (const file of ["README.md", "src/app/layout.tsx"]) {
+  const filePath = join(target, file);
+  if (!existsSync(filePath)) continue;
+  const contents = await readFile(filePath, "utf8");
+  await writeFile(filePath, contents.replaceAll("{{name}}", projectName));
+}
+
+// ---- install ----------------------------------------------------------------
+// Done before git init on purpose: with no repo yet, editors can't transiently
+// flag the thousands of node_modules files written during install.
+if (!skipInstall) {
+  console.log(`Installing dependencies with ${pm}...\n`);
+  spawnSync(pm, ["install"], { cwd: target, stdio: "inherit" });
+}
+
+// ---- git --------------------------------------------------------------------
+// Init + initial commit last, so the working tree lands clean (.gitignore is
+// already in place, so node_modules is excluded from the commit).
+if (!skipGit && !existsSync(join(target, ".git"))) {
+  const git = (...args) =>
+    spawnSync("git", args, { cwd: target, stdio: "ignore" });
+  git("init", "-q");
+  git("add", "-A");
+  const msg = "init";
+  const commit = git("commit", "-m", msg, "--quiet");
+  // Fall back to a neutral identity if the user has none configured globally.
+  if (commit.status !== 0) {
+    git(
+      "-c",
+      "user.name=create-genesis",
+      "-c",
+      "user.email=create-genesis@users.noreply.github.com",
+      "commit",
+      "-m",
+      msg,
+      "--quiet",
+    );
+  }
+}
+
+// ---- done -------------------------------------------------------------------
+const rel = target === process.cwd() ? "." : projectName;
+console.log(`\n✓ Done.\n`);
+if (rel !== ".") console.log(`  cd ${rel}`);
+if (skipInstall) console.log(`  ${pm} install`);
+console.log(`  ${pm} run dev\n`);

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "create-genesis-app",
+  "version": "0.1.0",
+  "description": "Scaffold a Next.js app (App Router, TypeScript, Tailwind v4) into the current folder.",
+  "type": "module",
+  "bin": {
+    "create-genesis-app": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "template"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "next",
+    "nextjs",
+    "react",
+    "tailwind",
+    "typescript",
+    "create",
+    "template",
+    "starter"
+  ],
+  "license": "MIT"
+}

package/template/AGENTS.md

@@ -0,0 +1,5 @@
+<!-- BEGIN:nextjs-agent-rules -->
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` before writing any code. Heed deprecation notices.
+<!-- END:nextjs-agent-rules -->

package/template/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

package/template/README.md

@@ -0,0 +1,9 @@
+# {{name}}
+
+## Getting started
+
+```bash
+pnpm dev
+```
+
+Then open [http://localhost:3000](http://localhost:3000) and edit `src/app/page.tsx`.

package/template/_gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

package/template/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/template/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/template/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  devIndicators: false,
+};
+
+export default nextConfig;

package/template/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "genesis-app",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "latest",
+    "react": "latest",
+    "react-dom": "latest",
+    "clsx": "latest",
+    "tailwind-merge": "latest",
+    "radix-ui": "latest",
+    "class-variance-authority": "latest"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "latest",
+    "@types/node": "latest",
+    "@types/react": "latest",
+    "@types/react-dom": "latest",
+    "eslint": "latest",
+    "eslint-config-next": "latest",
+    "tailwindcss": "latest",
+    "typescript": "latest"
+  }
+}

package/template/pnpm-workspace.yaml

@@ -0,0 +1,7 @@
+allowBuilds:
+  esbuild: true
+  sharp: true
+  unrs-resolver: true
+ignoredBuiltDependencies:
+  - sharp
+  - unrs-resolver

package/template/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/template/src/app/globals.css

@@ -0,0 +1,10 @@
+@import "tailwindcss";
+
+@theme inline {
+  --font-sans: var(--font-regular-sans);
+  --font-mono: var(--font-regular-mono);
+}
+
+body {
+  font-family: var(--font-regular-sans), Arial, Helvetica, sans-serif;
+}

package/template/src/app/layout.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from "next";
+import "./globals.css";
+import { cn } from "@/lib/tailwind-utils";
+import fonts from "@/lib/fonts";
+
+export const metadata: Metadata = {
+  title: "{{name}}",
+  description: "{{name}} - created with create-genesis",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en" className={cn(fonts, "h-full antialiased")}>
+      <body className="min-h-full flex flex-col">{children}</body>
+    </html>
+  );
+}

package/template/src/app/page.tsx

@@ -0,0 +1,11 @@
+interface PageProps {}
+
+const Page = ({}: PageProps) => {
+  return (
+    <div className="">
+      <h1>Hello World!</h1>
+    </div>
+  );
+};
+
+export default Page;

package/template/src/lib/fonts.ts

@@ -0,0 +1,17 @@
+import { Inter, Geist_Mono } from "next/font/google";
+import { cn } from "@/lib/tailwind-utils";
+
+const regularSansFont = Inter({
+  variable: "--font-regular-sans",
+  subsets: ["latin"],
+});
+
+const regularMonoFont = Geist_Mono({
+  variable: "--font-regular-mono",
+  subsets: ["latin"],
+});
+
+export default cn(
+  regularSansFont.variable,
+  regularMonoFont.variable,
+);

package/template/src/lib/tailwind-utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/template/tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}