create-githat-app 1.0.13 → 1.0.14

package/dist/cli.js

@@ -11,7 +11,7 @@ import gradient from "gradient-string";
 import chalk from "chalk";
 
 // src/constants.ts
-var VERSION = "1.0.13";
+var VERSION = "1.0.14";
 var DEFAULT_API_URL = "https://api.githat.io";
 var DASHBOARD_URL = "https://githat.io/dashboard/apps";
 var BRAND_COLORS = ["#7c3aed", "#6366f1", "#8b5cf6"];
@@ -330,7 +330,8 @@ function getInstallCommand(pm) {
 async function promptFramework(typescriptOverride, isFullstack) {
   const packageManager = detectPackageManager();
   const frameworkOptions = isFullstack ? [{ value: "nextjs", label: "Next.js 16", hint: "App Router \xB7 SSR \xB7 middleware auth" }] : [
-    { value: "nextjs", label: "Next.js 16", hint: "App Router \xB7 SSR \xB7 middleware auth" },
+    { value: "plain", label: "Plain (recommended for first time)", hint: "Just auth + one homepage. Build whatever on top." },
+    { value: "nextjs", label: "Next.js 16 \u2014 full kit", hint: "Dashboard \xB7 orgs \xB7 agents \xB7 MCP scaffolding" },
     { value: "react-vite", label: "React 19 + Vite 7", hint: "SPA \xB7 client-side routing" }
   ];
   const answers = await p3.group(
@@ -583,33 +584,34 @@ async function promptFinalize() {
 function toDisplayName(projectName) {
   return projectName.replace(/[-_]/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
-function getDefaults(projectName, publishableKey, typescript, fullstack, backendFramework) {
+function getDefaults(projectName, publishableKey, typescript, fullstack, backendFramework, plain) {
   const displayName = toDisplayName(projectName);
   const projectType = fullstack ? "fullstack" : "frontend";
+  const framework = plain ? "plain" : "nextjs";
   return {
     projectName,
     businessName: displayName,
     description: `${displayName} \u2014 Built with GitHat`,
     projectType,
     backendFramework: fullstack ? backendFramework || "hono" : void 0,
-    framework: "nextjs",
+    framework,
     typescript: typescript ?? true,
     packageManager: detectPackageManager(),
     publishableKey: publishableKey || "",
     apiUrl: DEFAULT_API_URL,
-    authFeatures: ["forgot-password"],
+    authFeatures: plain ? [] : ["forgot-password"],
     databaseChoice: "none",
     useTailwind: true,
-    includeDashboard: true,
-    includeGithatFolder: projectType === "frontend",
+    includeDashboard: !plain,
+    includeGithatFolder: !plain && projectType === "frontend",
     initGit: true,
     installDeps: true
   };
 }
 async function runPrompts(args) {
   if (args.yes && args.initialName) {
-    p8.log.info("Using defaults (--yes flag)");
-    return getDefaults(args.initialName, args.publishableKey, args.typescript, args.fullstack, args.backendFramework);
+    p8.log.info(args.plain ? "Using plain defaults (--yes --plain)" : "Using defaults (--yes flag)");
+    return getDefaults(args.initialName, args.publishableKey, args.typescript, args.fullstack, args.backendFramework, args.plain);
   }
   p8.intro("Let's set up your GitHat app");
   sectionHeader("Project");
@@ -676,6 +678,9 @@ var TEMPLATES_ROOT = path.resolve(__dirname2, "..", "templates");
 Handlebars.registerHelper("ifEquals", function(a, b, options) {
   return a === b ? options.fn(this) : options.inverse(this);
 });
+Handlebars.registerHelper("ifNext", function(framework, options) {
+  return framework === "nextjs" || framework === "plain" ? options.fn(this) : options.inverse(this);
+});
 function getTemplatesRoot() {
   return TEMPLATES_ROOT;
 }
@@ -723,14 +728,17 @@ function writeJson(root, relativePath, data) {
 
 // src/scaffold/package-builder.ts
 function buildPackageJson(ctx) {
-  const isNext = ctx.framework === "nextjs";
+  const isNext = ctx.framework === "nextjs" || ctx.framework === "plain";
   const deps = {
     ...isNext ? DEPS.nextjs.dependencies : DEPS["react-vite"].dependencies
   };
   const devDeps = {
     ...isNext ? DEPS.nextjs.devDependencies : DEPS["react-vite"].devDependencies
   };
-  if (ctx.useTailwind) {
+  if (ctx.framework === "plain") {
+    delete deps["@githat/ui"];
+  }
+  if (ctx.useTailwind || ctx.framework === "plain") {
     if (isNext) {
       Object.assign(devDeps, DEPS.tailwind.devDependencies);
     } else {
@@ -924,7 +932,7 @@ async function scaffold(context, options) {
       writeJson(root, "package.json", pkg);
     }, "package.json generated");
   }
-  if (!isFullstack && context.framework === "nextjs") {
+  if (!isFullstack && (context.framework === "nextjs" || context.framework === "plain")) {
     await registerApp(context.projectName, root);
   }
   if (options.initGit) {
@@ -1579,9 +1587,27 @@ skillsCommand.action(() => {
 // src/cli.ts
 var program = new Command7();
 program.name("githat").description("GitHat CLI - Scaffold apps and manage skills").version(VERSION);
-program.command("create [project-name]", { isDefault: true }).description("Scaffold a new GitHat app").option("--key <key>", "GitHat publishable key (pk_live_...)").option("--ts", "Use TypeScript (default)").option("--js", "Use JavaScript").option("--fullstack", "Create fullstack project (Turborepo)").option("--backend <framework>", "Backend framework (hono, express, fastify)").option("-y, --yes", "Skip prompts and use defaults").action(async (projectName, opts) => {
+program.command("create [project-name]", { isDefault: true }).description("Scaffold a new GitHat app").option("--key <key>", "GitHat publishable key (pk_live_...)").option("--ts", "Use TypeScript (default)").option("--js", "Use JavaScript").option("--plain", "Smallest scaffold: auth + a homepage. No dashboard, no orgs.").option("--fullstack", "Create fullstack project (Turborepo)").option("--backend <framework>", "Backend framework (hono, express, fastify)").option("-y, --yes", "Skip prompts and use defaults").action(async (projectName, opts) => {
   try {
     displayBanner();
+    if (!opts.yes && !opts.key) {
+      p12.note(
+        [
+          chalk10.bold("Two ways to connect this app to GitHat:"),
+          "",
+          `  ${chalk10.cyan("1.")} ${chalk10.bold("Already signed up?")}  Pass your key:`,
+          `       ${chalk10.dim("npx create-githat-app my-app --key pk_live_...")}`,
+          `       Get the key at ${chalk10.cyan("https://githat.io/dashboard/apps")}`,
+          "",
+          `  ${chalk10.cyan("2.")} ${chalk10.bold("Don't have an account yet?")}  Press Enter`,
+          `       below \u2014 we'll open a browser, you sign up in 30s,`,
+          `       and the key is stitched in for you.`,
+          "",
+          chalk10.dim("Either path lands you in the same place.")
+        ].join("\n"),
+        "First time with GitHat?"
+      );
+    }
     const typescript = opts.js ? false : opts.ts ? true : void 0;
     if (opts.yes && !projectName) {
       p12.cancel(chalk10.red("Project name is required when using --yes flag"));
@@ -1592,6 +1618,7 @@ program.command("create [project-name]", { isDefault: true }).description("Scaff
       publishableKey: opts.key,
       typescript,
       yes: opts.yes,
+      plain: opts.plain,
       fullstack: opts.fullstack,
       backendFramework: opts.backend
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-githat-app",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "description": "GitHat CLI — scaffold apps and manage the skills marketplace",
   "type": "module",
   "bin": {
@@ -62,6 +62,6 @@
     "url": "git+https://github.com/GitHat-IO/create-githat-app.git"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20.10"
   }
 }

package/templates/base/.env.example.hbs

@@ -1,11 +1,11 @@
 # GitHat Identity
-{{#ifEquals framework "nextjs"}}
+{{#ifNext framework}}
 NEXT_PUBLIC_GITHAT_PUBLISHABLE_KEY=pk_test_your_key_here
 NEXT_PUBLIC_GITHAT_API_URL={{apiUrl}}
 {{else}}
 VITE_GITHAT_PUBLISHABLE_KEY=pk_test_your_key_here
 VITE_GITHAT_API_URL={{apiUrl}}
-{{/ifEquals}}
+{{/ifNext}}
 {{#if useDatabase}}
 
 # Database

package/templates/base/.env.local.example.hbs

@@ -1,4 +1,4 @@
-{{#ifEquals framework "nextjs"}}
+{{#ifNext framework}}
 # GitHat — publishable key for this app.
 # Get yours at https://githat.io/dashboard/apps
 NEXT_PUBLIC_GITHAT_PUBLISHABLE_KEY=pk_live_your_key_here
@@ -12,7 +12,7 @@ VITE_GITHAT_PUBLISHABLE_KEY=pk_live_your_key_here
 
 # GitHat API base URL (leave as-is unless using a self-hosted deployment)
 VITE_GITHAT_API_URL={{apiUrl}}
-{{/ifEquals}}
+{{/ifNext}}
 {{#if useDatabase}}
 
 # Database

package/templates/base/.env.local.hbs

@@ -1,10 +1,10 @@
-{{#ifEquals framework "nextjs"}}
+{{#ifNext framework}}
 NEXT_PUBLIC_GITHAT_PUBLISHABLE_KEY={{publishableKey}}
 NEXT_PUBLIC_GITHAT_API_URL={{apiUrl}}
 {{else}}
 VITE_GITHAT_PUBLISHABLE_KEY={{publishableKey}}
 VITE_GITHAT_API_URL={{apiUrl}}
-{{/ifEquals}}
+{{/ifNext}}
 {{#if useDatabase}}
 DATABASE_URL="postgresql://user:password@localhost:5432/{{projectName}}"
 {{/if}}

package/templates/plain/app/(auth)/sign-in/page.tsx.hbs

@@ -0,0 +1,9 @@
+import { SignInForm } from '@githat/nextjs';
+
+export default function SignInPage() {
+  return (
+    <main {{#if useTailwind}}className="flex items-center justify-center min-h-screen bg-[#09090b]"{{else}}style=\{{ display: 'flex', alignItems: 'center', justifyContent: 'center', minHeight: '100vh', background: '#09090b' }}{{/if}}>
+      <SignInForm signUpUrl="/sign-up" {{#if includeForgotPassword}}forgotPasswordUrl="/forgot-password"{{/if}} />
+    </main>
+  );
+}

package/templates/plain/app/(auth)/sign-up/page.tsx.hbs

@@ -0,0 +1,9 @@
+import { SignUpForm } from '@githat/nextjs';
+
+export default function SignUpPage() {
+  return (
+    <main {{#if useTailwind}}className="flex items-center justify-center min-h-screen bg-[#09090b]"{{else}}style=\{{ display: 'flex', alignItems: 'center', justifyContent: 'center', minHeight: '100vh', background: '#09090b' }}{{/if}}>
+      <SignUpForm signInUrl="/sign-in" />
+    </main>
+  );
+}

package/templates/plain/app/globals.css.hbs

@@ -0,0 +1,87 @@
+/*
+ * Tailwind v4 — required because @githat/nextjs/styles is processed
+ * through @tailwindcss/postcss. Plain doesn't ship utility classes,
+ * but the import is needed for the auth pages to render styled.
+ */
+@import "tailwindcss";
+
+/*
+ * Plain template — self-contained globals.
+ *
+ * Defines the minimum CSS variables a GitHat app uses for layout and
+ * the auth-page styling that ships with @githat/nextjs/styles.
+ * Override these in your own files when you want a real theme.
+ *
+ * Light theme by default; flip --bg/--fg for dark.
+ */
+
+:root {
+  /* Surface */
+  --bg:           #ffffff;
+  --surface:      #fafafa;
+  --surface-sub:  #f4f4f5;
+
+  /* Borders */
+  --border:       #e5e7eb;
+
+  /* Foreground */
+  --fg:           #0a0a0a;
+  --fg-muted:     #525252;
+  --fg-subtle:    #737373;
+
+  /* Brand — change these two to re-skin the whole auth flow */
+  --primary:      #6366f1;
+  --accent:       #f59e0b;
+
+  /* Semantic */
+  --success:      #16a34a;
+  --warn:         #d97706;
+  --danger:       #dc2626;
+
+  /* Spacing — used by @githat/nextjs/styles */
+  --space-1: 0.25rem;
+  --space-2: 0.5rem;
+  --space-3: 0.75rem;
+  --space-4: 1rem;
+  --space-6: 1.5rem;
+  --space-8: 2rem;
+
+  /* Radius */
+  --radius:    0.5rem;
+  --radius-md: 0.5rem;
+  --radius-lg: 0.75rem;
+
+  /* Fonts */
+  --font-sans:     'Inter', system-ui, -apple-system, BlinkMacSystemFont, sans-serif;
+  --font-wordmark: 'Instrument Serif', Georgia, serif;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --bg:           #0a0a0a;
+    --surface:      #18181b;
+    --surface-sub:  #27272a;
+    --border:       #3f3f46;
+    --fg:           #fafafa;
+    --fg-muted:     #a1a1aa;
+    --fg-subtle:    #71717a;
+  }
+}
+
+* {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+body {
+  font-family: var(--font-sans);
+  background: var(--bg);
+  color: var(--fg);
+  line-height: 1.5;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}

package/templates/plain/app/layout.tsx.hbs

@@ -0,0 +1,41 @@
+import { GitHatProvider } from '@githat/nextjs';
+import '@githat/nextjs/styles';
+import './globals.css';
+
+export const metadata = {
+  title: '{{businessName}}',
+  description: '{{description}}',
+};
+
+export default function RootLayout({ children }{{#if typescript}}: { children: React.ReactNode }{{/if}}) {
+  return (
+    <html lang="en">
+      <body>
+        {/*
+          Plain template: no @githat/ui dep, no Wordmark. The
+          full-kit (`nextjs`) template uses @githat/ui for the
+          shared design system; the plain scaffold is the smallest
+          working app, so we avoid extra deps.
+        */}
+        <GitHatProvider config=\{{
+          publishableKey: process.env.NEXT_PUBLIC_GITHAT_PUBLISHABLE_KEY || '',
+          signInUrl: '/sign-in',
+          signUpUrl: '/sign-up',
+          afterSignInUrl: '/',
+          afterSignOutUrl: '/',
+        }}>
+          <header style=\{{
+            padding: '1rem 1.5rem',
+            borderBottom: '1px solid var(--border, #e5e7eb)',
+            fontFamily: 'system-ui, -apple-system, sans-serif',
+          }}>
+            <a href="/" style=\{{ textDecoration: 'none', color: 'inherit', fontWeight: 600 }}>
+              {{businessName}}
+            </a>
+          </header>
+          <main>{children}</main>
+        </GitHatProvider>
+      </body>
+    </html>
+  );
+}

package/templates/plain/app/page.tsx.hbs

@@ -0,0 +1,123 @@
+'use client';
+
+import { SignInButton, SignUpButton, UserButton, useAuth } from '@githat/nextjs';
+
+/**
+ * Plain GitHat homepage.
+ *
+ * No dashboard, no orgs, no agents — just one page that flips between
+ * "signed out" and "signed in." The smallest possible example of "I
+ * have GitHat wired up." Replace this file with whatever your app
+ * actually does — auth keeps working.
+ */
+export default function Home() {
+  const { isSignedIn, isLoading, user } = useAuth();
+
+  if (isLoading) {
+    return (
+      <div
+        style=\{{
+          display: 'flex',
+          minHeight: 'calc(100vh - 64px)',
+          alignItems: 'center',
+          justifyContent: 'center',
+          color: 'var(--fg-muted)',
+        }}
+      >
+        Loading…
+      </div>
+    );
+  }
+
+  return (
+    <div
+      style=\{{
+        display: 'flex',
+        minHeight: 'calc(100vh - 64px)',
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 'var(--space-8) var(--space-4)',
+        background: 'var(--bg)',
+      }}
+    >
+      <main
+        style=\{{
+          width: '100%',
+          maxWidth: '32rem',
+          textAlign: 'center',
+          color: 'var(--fg)',
+        }}
+      >
+        {!isSignedIn ? (
+          <>
+            <h1
+              style=\{{
+                fontFamily: 'var(--font-wordmark)',
+                fontSize: '2.5rem',
+                lineHeight: 1.1,
+                marginBottom: 'var(--space-3)',
+              }}
+            >
+              Welcome to {{businessName}}
+            </h1>
+            <p
+              style=\{{
+                color: 'var(--fg-muted)',
+                marginBottom: 'var(--space-6)',
+                lineHeight: 1.6,
+              }}
+            >
+              Sign in to continue, or create an account in 30 seconds.
+              We use GitHat for identity — your password never touches
+              this app.
+            </p>
+            <div
+              style=\{{
+                display: 'flex',
+                gap: 'var(--space-3)',
+                justifyContent: 'center',
+                flexWrap: 'wrap',
+              }}
+            >
+              <SignInButton />
+              <SignUpButton />
+            </div>
+          </>
+        ) : (
+          <>
+            <div
+              style=\{{
+                display: 'flex',
+                alignItems: 'center',
+                justifyContent: 'center',
+                gap: 'var(--space-4)',
+                marginBottom: 'var(--space-6)',
+              }}
+            >
+              <UserButton />
+              <h1
+                style=\{{
+                  fontFamily: 'var(--font-wordmark)',
+                  fontSize: '2rem',
+                  margin: 0,
+                }}
+              >
+                Hello{user?.name ? `, ${user.name}` : ''}.
+              </h1>
+            </div>
+            <p
+              style=\{{
+                color: 'var(--fg-muted)',
+                lineHeight: 1.6,
+              }}
+            >
+              That's it. The plain template doesn't ship a dashboard or
+              any other route — replace this page with whatever your
+              app actually does. Authentication will keep working.
+            </p>
+          </>
+        )}
+      </main>
+    </div>
+  );
+}

package/templates/plain/next.config.ts.hbs

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  output: 'standalone',
+};
+
+export default nextConfig;

package/templates/plain/postcss.config.mjs.hbs

@@ -0,0 +1,14 @@
+/*
+ * Plain template — Tailwind v4 PostCSS plugin is required even though
+ * the plain scaffold doesn't use Tailwind utility classes. The auth
+ * page CSS shipped by `@githat/nextjs/styles` is processed through
+ * @tailwindcss/postcss at build time. Drop this config and the
+ * auth pages render unstyled.
+ */
+const config = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+};
+
+export default config;

package/templates/plain/proxy.ts.hbs

@@ -0,0 +1,10 @@
+import { authProxy } from '@githat/nextjs/proxy';
+
+export const proxy = authProxy({
+  publicRoutes: ['/', '/sign-in', '/sign-up'{{#if includeForgotPassword}}, '/forgot-password', '/reset-password'{{/if}}{{#if includeEmailVerification}}, '/verify-email'{{/if}}],
+  signInUrl: '/sign-in',
+});
+
+export const config = {
+  matcher: ['/((?!_next|api|.*\\..*).*)'],
+};

package/templates/plain/tsconfig.json.hbs

@@ -0,0 +1,21 @@
+{
+  "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": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": { "@/*": ["./*"] }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}