create-nexora-next 0.4.8 → 0.4.10

package/README.md

@@ -9,7 +9,7 @@
   ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝
 ```
 
-**The opinionated Next.js scaffold CLI by Rayan.**  
+**The opinionated Next.js scaffold CLI by Rayan.**
 One command. Full setup. Ship faster.
 
 [![npm version](https://img.shields.io/npm/v/create-nexora-next?color=cyan&style=flat-square)](https://www.npmjs.com/package/create-nexora-next)
@@ -37,92 +37,231 @@ bunx create-nexora-next@latest
 yarn dlx create-nexora-next@latest
 ```
 
-The CLI will guide you through a short prompt sequence — pick your package manager, choose your features, and watch your project build itself.
+The CLI walks you through a short prompt sequence — pick your package manager, choose your features, and watch your project build itself. Every step is wrapped with error recovery — if something fails, the CLI pauses, shows you the exact error, and lets you retry without starting over.
+
+---
+
+## Flag mode
+
+Skip the prompts entirely by passing flags directly:
+
+```bash
+# Full setup with bun, all features
+npx create-nexora-next my-app --pm bun --all
+
+# Pick specific features
+npx create-nexora-next my-app --pm pnpm --i18n --query --theming --husky
+
+# Disable specific features from --all
+npx create-nexora-next my-app --pm bun --all --no-animations --no-auth
+
+# Accept all defaults silently
+npx create-nexora-next my-app -y
+```
+
+| Flag | Description |
+|---|---|
+| `--pm <manager>` | Package manager — `npm` · `pnpm` · `bun` · `yarn` |
+| `--all` | Enable every feature |
+| `--i18n` | Localization via next-intl |
+| `--query` | TanStack Query + persistence |
+| `--theming` | Theming via next-themes |
+| `--animations` | Motion + GSAP |
+| `--auth` | Auth proxy + validators |
+| `--axios` | Axios client/server instances |
+| `--husky` | Husky pre-commit hooks |
+| `--rc` / `--react-compiler` | React Compiler |
+| `--github` | Connect a GitHub repository |
+| `--no-theming` | Skip theming |
+| `--no-husky` | Skip Husky |
+| `--no-rc` | Skip React Compiler |
+| `--no-github` | Skip GitHub setup |
+| `-y` / `--yes` | Accept all defaults |
+| `-v` / `--version` | Print version |
+| `-h` / `--help` | Show help |
 
 ---
 
 ## What's always included
 
-Every project scaffolded with `create-nexora-next` comes with this baseline — no questions asked:
+Every project gets this baseline — no questions asked:
 
 | What | Details |
 |---|---|
-| **Next.js 16** | TypeScript · Tailwind CSS v4 · ESLint · App Router · `src/` dir · `~/` path alias |
-| **shadcn/ui** | Initialised with defaults · `components.json` patched to `~/lib/utils/index.ts` |
+| **Next.js 16+** | TypeScript · Tailwind CSS v4 · ESLint · App Router · `src/` dir · `~/` path alias |
+| **shadcn/ui** | Initialised with defaults · `components.json` patched to `~/lib/utils/index.ts` · default `src/lib/utils.ts` removed |
 | **Custom globals.css** | Squircle utilities · responsive container · skeleton animation · reduced motion |
 | **Prettier** | `prettier-plugin-tailwindcss` for automatic class sorting |
-| **Poppins font** | Via `next/font/google` with full weight range |
+| **Poppins font** | Via `next/font/google` with full weight range (200–800) |
 | **Utility functions** | `cn()` · `toSlug()` · `createInitials()` · `normalizeEmail()` · `sanitizeName()` · `trycatch()` |
-| **Constants** | `SITE_URL` · `TZ_COOKIE` · locale constants (if i18n opted in) |
+| **Constants** | `SITE_URL` · `TZ_COOKIE` · locale constants if i18n opted in |
 | **SEO scaffold** | `src/lib/seo/index.ts` — locale-aware if i18n enabled |
 | **Sitemap** | `src/app/sitemap.ts` pre-wired to `SITE_URL` |
-| **ESLint config** | Clean flat config with Next.js core web vitals + TypeScript rules |
-| **Providers pattern** | Dynamic `src/components/providers/index.ts` — only includes what you opted into |
-| **SileoToaster** | Toast notifications via `sileo` |
+| **ESLint config** | Clean flat config · Next.js core web vitals · TypeScript rules · TanStack plugin if query opted in |
+| **Providers pattern** | `src/components/providers/index.tsx` — dynamically generated, only includes opted-in providers |
+| **SileoToaster** | Toast notifications via `sileo` at `src/components/ui/sileo.tsx` |
 | **nuqs** | Type-safe URL search params adapter |
 | **nextjs-toploader** | Page transition progress bar |
 | **Folder structure** | `hooks/` · `components/{atoms,molecules,organisms,primitives,adapters,providers,ui}/` |
 | **Core deps** | `zustand` · `zod` · `react-hook-form` · `date-fns` · `@date-fns/tz` · `clsx` · `tailwind-merge` |
 | **Dev deps** | `prettier` · `prettier-plugin-tailwindcss` · `babel-plugin-react-compiler` |
-| **Scripts** | `type-check` added to `package.json` → `tsc --pretty --noEmit` |
+| **`type-check` script** | `tsc --pretty --noEmit` added to `package.json` |
 
 ---
 
 ## Optional features
 
-Prompted during setup — only what you need gets installed:
-
 ### 🌍 Localization (`next-intl`)
-- `src/i18n/{routing,request,navigation}.ts`
-- `locales/en.json` with base translation keys
-- `src/app/[locale]/page.tsx` + `src/app/[locale]/layout.tsx`
-- Root `layout.tsx` replaced with passthrough shell
-- Default `src/app/page.tsx` removed
-- `next-intl.ts` config with typed `AppConfig`
-- `src/lib/utils/locale-date-formats.ts`
-- `LocaleProvider` + `TzProvider` (auto-detects and persists device timezone)
-- `next.config.ts` updated with `createNextIntlPlugin`
+
+```
+src/
+├── i18n/
+│   ├── routing.ts        # locale routing config
+│   ├── request.ts        # server-side locale resolution + timezone
+│   └── navigation.ts     # typed Link, useRouter, usePathname
+├── app/
+│   ├── layout.tsx        # replaced with passthrough shell
+│   └── [locale]/
+│       ├── layout.tsx    # full root layout with Providers + fonts
+│       └── page.tsx      # localized home page
+└── lib/utils/
+    └── locale-date-formats.ts
+
+locales/
+└── en.json               # base translation keys
+
+next-intl.ts              # typed AppConfig declaration
+next.config.ts            # updated with createNextIntlPlugin
+```
+
+- `LocaleProvider` wrapping `NextIntlClientProvider`
+- `TzProvider` — auto-detects and persists device timezone via cookie
+- Default `src/app/page.tsx` removed — `[locale]/page.tsx` takes over routing
+
+---
 
 ### ⚡ TanStack Query
-- `@tanstack/react-query` installed first (peer dep order guaranteed)
-- `@tanstack/react-query-persist-client` + `@tanstack/query-async-storage-persister`
-- Pre-configured `QueryClientProvider` with:
-  - 5-minute stale time
-  - Local storage persistence (24h)
-  - Mutation cache auto-invalidation via `meta.invalidateQueries`
-- `@tanstack/eslint-plugin-query` as devDependency
+
+Installs in the correct peer dependency order — `@tanstack/react-query` first, persist packages after:
+
+- `@tanstack/react-query`
+- `@tanstack/react-query-persist-client`
+- `@tanstack/query-async-storage-persister`
+- `@tanstack/eslint-plugin-query` (devDependency)
+
+Pre-configured `QueryClientProvider` with:
+- 5-minute stale time + gcTime
+- 24-hour local storage persistence
+- Mutation cache auto-invalidation via `meta.invalidateQueries`
+- `refetchOnWindowFocus: false`, `retry: false`
+
+---
 
 ### 🎨 Theming (`next-themes`)
-- `ThemeProvider` with system default, class attribute, smooth transitions
+
+`ThemeProvider` with system default, class attribute, and `disableTransitionOnChange`.
+
+---
 
 ### 🔐 Auth
-- Proxy chain middleware (`src/proxy.ts`)
-- `withProxyChain` + `authProxy` stub
-- `src/lib/validators/{index,auth}.ts` — `LoginSchema`, `RegisterSchema`
+
+- Proxy chain middleware at `src/proxy.ts`
+- `withProxyChain` + `authProxy` stub ready to implement
+- `src/lib/validators/index.ts` — `EmailValidator`, `PasswordValidator`, `NameValidator`, `OTPValidator` and more
+- `src/lib/validators/auth.ts` — `LoginSchema`, `RegisterSchema` with zod
 - `src/apis/{client,server}/index.ts`
 - `cookies-next` installed
 
+---
+
 ### 🎭 Animations
-- `motion` (formerly Framer Motion)
+
+- `motion` (Framer Motion v11+)
 - `gsap`
 
+---
+
 ### 🔄 Axios
+
 - `axios` installed
-- `src/lib/axios/axios.client.ts` — pre-configured client instance
-- `src/lib/axios/axios.server.ts` — pre-configured server instance
+- `src/lib/axios/axios.client.ts` — client instance with credentials
+- `src/lib/axios/axios.server.ts` — server instance
+
+---
 
 ### 🐶 Husky pre-commit hooks
-Runs three checks on every commit:
-```
-📝 Lint       → bun lint
-🔍 Type check → bun type-check
-🏗️  Build      → bun run build
+
+Runs three checks on every commit — fails fast with clear feedback:
+
+```sh
+🚀 Running pre-commit checks...
+
+📝 Linting your code...        → bun lint
+✅ Lint passed!
+
+🔍 Checking types...           → bun type-check
+✅ Types are solid!
+
+🏗️  Building project...         → bun run build
+✅ Build successful!
+
+🎉 All checks passed! Committing...
+⏰ Commit time: 2026-03-21 14:30:00
 ```
-Fails fast with a clear error message. Shows timestamp on success.
+
+---
 
 ### ⚛️ React Compiler
-- `babel-plugin-react-compiler` (always installed as devDep)
-- `reactCompiler: true` added to `next.config.ts` if opted in
+
+`babel-plugin-react-compiler` always installed as a devDependency. If opted in, `reactCompiler: true` is added to `next.config.ts`.
+
+---
+
+### 🐙 GitHub repository
+
+Connects your project to GitHub automatically using the GitHub API — no manual `git remote` setup needed.
+
+**Before using this feature, generate a Classic PAT:**
+
+> ⚠️ Use a **Classic** Personal Access Token — not fine-grained.
+> Fine-grained tokens are scoped to existing repositories, so they cannot grant access to repos that don't exist yet. A Classic PAT with the `repo` scope works for both creating new repos and connecting existing ones.
+
+1. Go to [github.com/settings/tokens/new](https://github.com/settings/tokens/new)
+2. Set **Token type** to **Classic**
+3. Tick the **`repo`** scope — that's all you need
+4. Set an expiration (90 days recommended)
+5. Copy the token — it starts with `gh`
+
+**What the CLI does with it:**
+
+1. Prompts for your Classic PAT — masked input
+2. Verifies it against the GitHub API immediately
+3. If invalid — shows the error and asks **"Try a different token?"** — loops until valid or skipped
+4. Choose to **create a new repo** or **pick an existing one**
+5. If creating — set a name (defaults to project name), optional description, visibility (private by default)
+6. If picking — fetches your 100 most recently pushed repos to choose from
+7. Adds remote origin via SSH, pushes `main`, creates and pushes `staging` branch
+
+```
+✓ Authenticated as bbrainttech
+
+✔ What would you like to do? › Create a new repository
+✔ Repository name: › my-app
+✔ Repository description (optional): ›
+✔ Make repository private? › yes
+
+✓ Creating repo my-app on GitHub
+✓ Creating initial commit
+✓ Adding remote origin → git@github.com:bbrainttech/my-app.git
+✓ Pushing main branch
+✓ Creating staging branch
+
+  ✓ Repository connected
+    git@github.com:bbrainttech/my-app.git
+    Branches: main · staging
+```
+
+If you skip or cancel at any point, the project is still fully built — GitHub setup is the last step and nothing else is affected.
 
 ---
 
@@ -131,63 +270,60 @@ Fails fast with a clear error message. Shows timestamp on success.
 ```
 my-app/
 ├── locales/
-│   └── en.json                         # (i18n)
+│   └── en.json                           # (i18n)
 ├── src/
 │   ├── app/
 │   │   ├── [locale]/
-│   │   │   ├── layout.tsx              # (i18n) full root layout
-│   │   │   └── page.tsx                # (i18n) localized home
-│   │   ├── layout.tsx                  # passthrough shell (i18n) or full layout
+│   │   │   ├── layout.tsx                # (i18n) full root layout
+│   │   │   └── page.tsx                  # (i18n) localized home
+│   │   ├── layout.tsx                    # passthrough shell (i18n) or full layout
 │   │   ├── globals.css
 │   │   └── sitemap.ts
-│   ├── i18n/                           # (i18n)
+│   ├── i18n/                             # (i18n)
 │   │   ├── routing.ts
 │   │   ├── request.ts
 │   │   └── navigation.ts
+│   ├── apis/                             # (auth)
+│   │   ├── client/index.ts
+│   │   └── server/index.ts
 │   ├── components/
-│   │   ├── adapters/
-│   │   │   └── nuqs.adapter.tsx
+│   │   ├── adapters/nuqs.adapter.tsx
 │   │   ├── atoms/
 │   │   ├── molecules/
 │   │   ├── organisms/
 │   │   ├── primitives/
 │   │   ├── providers/
-│   │   │   ├── index.ts                # dynamic — opted-in providers only
-│   │   │   ├── theme.provider.tsx      # (theming)
-│   │   │   ├── locale.provider.tsx     # (i18n)
-│   │   │   ├── tz.provider.tsx         # (i18n)
+│   │   │   ├── index.tsx                 # dynamic — opted-in providers only
+│   │   │   ├── theme.provider.tsx        # (theming)
+│   │   │   ├── locale.provider.tsx       # (i18n)
+│   │   │   ├── tz.provider.tsx           # (i18n)
 │   │   │   └── query-client.provider.tsx # (query)
 │   │   └── ui/
 │   │       └── sileo.tsx
-│   ├── constants/
-│   │   └── index.ts
+│   ├── constants/index.ts
 │   ├── hooks/
 │   ├── lib/
-│   │   ├── axios/                      # (axios)
+│   │   ├── axios/                        # (axios)
 │   │   │   ├── axios.client.ts
 │   │   │   └── axios.server.ts
 │   │   ├── fonts.ts
-│   │   ├── proxy/                      # (auth or i18n)
+│   │   ├── proxy/                        # (auth or i18n)
 │   │   │   ├── index.ts
-│   │   │   └── auth.ts                 # (auth)
-│   │   ├── seo/
-│   │   │   └── index.ts
+│   │   │   └── auth.ts                   # (auth)
+│   │   ├── seo/index.ts
 │   │   ├── utils/
 │   │   │   ├── index.ts
-│   │   │   └── locale-date-formats.ts  # (i18n)
-│   │   └── validators/                 # (auth)
+│   │   │   └── locale-date-formats.ts    # (i18n)
+│   │   └── validators/                   # (auth)
 │   │       ├── index.ts
 │   │       └── auth.ts
-│   ├── apis/                           # (auth)
-│   │   ├── client/
-│   │   └── server/
-│   └── proxy.ts                        # (i18n or auth)
+│   └── proxy.ts                          # (i18n or auth)
 ├── .env.local
 ├── .prettierrc
-├── .husky/pre-commit                   # (husky)
+├── .husky/pre-commit                     # (husky)
 ├── components.json
 ├── eslint.config.mjs
-├── next-intl.ts                        # (i18n)
+├── next-intl.ts                          # (i18n)
 └── next.config.ts
 ```
 
@@ -195,7 +331,13 @@ my-app/
 
 ## Error recovery
 
-If any step fails during setup, the CLI **pauses and shows you the exact error**. Fix the issue then press **Enter** to retry that step — no need to restart from scratch.
+Every step in the CLI is wrapped with automatic retry-on-failure. If a step throws — network issue, permission error, missing binary — the CLI:
+
+1. Shows the exact error message
+2. Asks **"Ready to retry?"**
+3. Loops until success or you choose to abort
+
+For GitHub token errors specifically, the retry loop re-prompts for a fresh token rather than restarting the whole step.
 
 ---
 
@@ -203,15 +345,16 @@ If any step fails during setup, the CLI **pauses and shows you the exact error**
 
 - **Node.js** 18+
 - **Package manager** — npm · pnpm · bun · yarn
+- **GitHub Classic PAT** — only if using the GitHub feature (`repo` scope, not fine-grained)
 
 ---
 
 ## Part of the Nexora family
 
-| Package | Stack |
-|---|---|
-| `create-nexora-next` | Next.js |
-| `create-nexora-go` | *(coming soon)* |
+| Package | Stack | Status |
+|---|---|---|
+| `create-nexora-next` | Next.js 16+ | ✅ Available |
+| `create-nexora-go` | Go | 🔜 Coming soon |
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nexora-next",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "The official Next.js scaffolding CLI by Rayan — batteries included.",
   "type": "module",
   "bin": {

package/src/index.js

@@ -20,6 +20,7 @@ import { stepInstallDeps }     from './steps/08-install-deps.js'
 import { stepSetupHusky }      from './steps/09-husky.js'
 import { stepSetupAxios }      from './steps/10-axios.js'
 import { stepPatchPackageJson } from './steps/11-patch-pkg.js'
+import { stepSetupGithub }    from './steps/12-github.js'
 
 function bail(msg) {
   p.cancel(pc.red(msg))
@@ -73,7 +74,7 @@ function printSummary(opts, projectName, pm) {
   p.log.success(pc.bold(pc.green(`  🚀  ${projectName} is ready!`)))
   console.log()
   console.log(pc.bold('  What was set up:'))
-  console.log(row('Next.js 16 + TypeScript + Tailwind + ESLint', true))
+  console.log(row('Next.js 16+ + TypeScript + Tailwind + ESLint', true))
   console.log(row('shadcn/ui + custom globals.css utilities',    true))
   console.log(row('Prettier + tailwind class sorting',           true))
   console.log(row('Poppins font + path alias ~/',                true))
@@ -85,6 +86,7 @@ function printSummary(opts, projectName, pm) {
   console.log(row('Axios client + server instances',             opts.axios))
   console.log(row('Husky pre-commit hooks',                      opts.husky))
   console.log(row('React Compiler',                              opts.reactCompiler))
+  console.log(row('GitHub repository connected',                  opts.github))
   console.log()
   console.log(pc.bold('  Next steps:'))
   console.log(`  ${pc.cyan('cd')} ${projectName}`)
@@ -177,6 +179,7 @@ async function main() {
   const axios         = await ask(parsed.axios,         () => p.confirm({ message: 'Set up axios client/server instances?',               initialValue: false }))
   const husky         = await ask(parsed.husky,         () => p.confirm({ message: 'Configure Husky pre-commit hooks?',                   initialValue: true  }))
   const reactCompiler = await ask(parsed.reactCompiler, () => p.confirm({ message: 'Enable React Compiler? (babel-plugin-react-compiler)', initialValue: true  }))
+  const github        = await ask(parsed.github,        () => p.confirm({ message: 'Connect a GitHub repository?',                          initialValue: true  }))
 
   const features = [
     i18n          && 'i18n',
@@ -187,6 +190,7 @@ async function main() {
     axios         && 'axios',
     husky         && 'husky',
     reactCompiler && 'react-compiler',
+    github        && 'github',
   ].filter(Boolean)
 
   console.log()
@@ -213,6 +217,7 @@ async function main() {
     axios:         Boolean(axios),
     husky:         Boolean(husky),
     reactCompiler: Boolean(reactCompiler),
+    github:       Boolean(github),
   }
 
   await stepCreateNextApp(name, pm, targetDir)
@@ -232,6 +237,10 @@ async function main() {
 
   if (opts.husky) await stepSetupHusky(targetDir, pm)
 
+  if (opts.github) {
+    await stepSetupGithub(targetDir, name)
+  }
+
   printSummary(opts, name, pm)
   p.outro(pc.bgGreen(pc.black(' Done! ')))
 }

package/src/steps/12-github.js

@@ -0,0 +1,210 @@
+import path from 'path'
+import * as p from '@clack/prompts'
+import pc from 'picocolors'
+import { run, runSilent } from '../utils/runner.js'
+import { safeStep } from '../utils/safe-step.js'
+
+const GH_API = 'https://api.github.com'
+
+// ─── GitHub API helpers ───────────────────────────────────────────────────────
+
+async function ghFetch(endpoint, token, options = {}) {
+  const res = await fetch(`${GH_API}${endpoint}`, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      Accept: 'application/vnd.github+json',
+      'X-GitHub-Api-Version': '2022-11-28',
+      'Content-Type': 'application/json',
+      ...options.headers,
+    },
+  })
+  const data = await res.json()
+  if (!res.ok) {
+    throw new Error(data.message || `GitHub API error ${res.status}`)
+  }
+  return data
+}
+
+async function getAuthenticatedUser(token) {
+  return ghFetch('/user', token)
+}
+
+async function listUserRepos(token) {
+  // Fetch up to 100 most recently pushed repos
+  return ghFetch('/user/repos?per_page=100&sort=pushed&affiliation=owner', token)
+}
+
+async function createRepo(token, { name, description, isPrivate }) {
+  return ghFetch('/user/repos', token, {
+    method: 'POST',
+    body: JSON.stringify({
+      name,
+      description: description || '',
+      private: isPrivate,
+      auto_init: false,
+    }),
+  })
+}
+
+// ─── Git helpers ──────────────────────────────────────────────────────────────
+
+function gitRun(cmd, cwd) {
+  run(cmd, cwd)
+}
+
+// ─── Main step ────────────────────────────────────────────────────────────────
+
+/**
+ * @param {string} targetDir
+ * @param {string} projectName
+ */
+export async function stepSetupGithub(targetDir, projectName) {
+  p.log.step(pc.bold(pc.cyan('\n  GitHub repository setup')))
+
+  // ── Ask for PAT (with retry loop on invalid token) ───────────────────────
+  let token
+  let ghUser
+
+  while (true) {
+    const input = await p.password({
+      message: 'Enter your GitHub Personal Access Token (PAT):',
+      validate: (v) => {
+        if (!v || !v.trim()) return 'Token is required.'
+        if (!v.trim().startsWith('gh')) return 'PAT should start with "gh" — check your token.'
+      },
+    })
+    if (p.isCancel(input)) { p.log.warn('GitHub setup skipped.'); return }
+
+    const verifySpinner = p.spinner()
+    verifySpinner.start('Verifying token with GitHub...')
+    try {
+      ghUser = await getAuthenticatedUser(input.trim())
+      verifySpinner.stop(pc.green(`✓ Authenticated as ${pc.bold(ghUser.login)}`))
+      token = input.trim()
+      break
+    } catch (err) {
+      verifySpinner.stop(pc.red('✗ Token verification failed'))
+      p.log.error(pc.red(`  ${err.message}`))
+      p.log.warn(pc.yellow('  Generate a valid PAT at https://github.com/settings/tokens (repo scope required)'))
+
+      const retry = await p.confirm({
+        message: 'Try a different token?',
+        initialValue: true,
+      })
+      if (p.isCancel(retry) || !retry) {
+        p.log.warn('GitHub setup skipped — you can add the remote manually later.')
+        return
+      }
+      // loop — prompt again
+    }
+  }
+
+  // ── Create new or pick existing ────────────────────────────────────────────
+  const repoAction = await p.select({
+    message: 'What would you like to do?',
+    options: [
+      { value: 'create', label: 'Create a new repository' },
+      { value: 'existing', label: 'Use an existing repository' },
+    ],
+  })
+  if (p.isCancel(repoAction)) { p.log.warn('GitHub setup skipped.'); return }
+
+  let sshUrl
+
+  // ── CREATE NEW REPO ────────────────────────────────────────────────────────
+  if (repoAction === 'create') {
+    const repoName = await p.text({
+      message: 'Repository name:',
+      initialValue: projectName,
+      validate: (v) => {
+        if (!v || !v.trim()) return 'Repository name is required.'
+        if (!/^[a-zA-Z0-9._-]+$/.test(v.trim()))
+          return 'Only letters, numbers, hyphens, underscores and dots allowed.'
+      },
+    })
+    if (p.isCancel(repoName)) { p.log.warn('GitHub setup skipped.'); return }
+
+    const repoDesc = await p.text({
+      message: 'Repository description (optional):',
+      placeholder: 'Leave blank to skip',
+    })
+    if (p.isCancel(repoDesc)) { p.log.warn('GitHub setup skipped.'); return }
+
+    const isPrivate = await p.confirm({
+      message: 'Make repository private?',
+      initialValue: true,
+    })
+    if (p.isCancel(isPrivate)) { p.log.warn('GitHub setup skipped.'); return }
+
+    let newRepo
+    await safeStep(`Creating repo ${pc.cyan(repoName.trim())} on GitHub`, async () => {
+      newRepo = await createRepo(token.trim(), {
+        name: repoName.trim(),
+        description: typeof repoDesc === 'string' ? repoDesc.trim() : '',
+        isPrivate: Boolean(isPrivate),
+      })
+    })
+
+    sshUrl = newRepo.ssh_url
+
+  // ── PICK EXISTING REPO ─────────────────────────────────────────────────────
+  } else {
+    let repos = []
+    const fetchSpinner = p.spinner()
+    fetchSpinner.start('Fetching your repositories...')
+    try {
+      repos = await listUserRepos(token.trim())
+      fetchSpinner.stop(pc.green(`✓ Found ${repos.length} repositories`))
+    } catch (err) {
+      fetchSpinner.stop(pc.red('✗ Failed to fetch repositories'))
+      p.log.error(pc.red(err.message))
+      p.log.warn('GitHub setup skipped.')
+      return
+    }
+
+    if (repos.length === 0) {
+      p.log.warn('No repositories found on your account. Try creating one instead.')
+      return
+    }
+
+    const picked = await p.select({
+      message: 'Select a repository:',
+      options: repos.map((r) => ({
+        value: r.ssh_url,
+        label: r.full_name,
+        hint: r.private ? 'private' : 'public',
+      })),
+    })
+    if (p.isCancel(picked)) { p.log.warn('GitHub setup skipped.'); return }
+
+    sshUrl = picked
+  }
+
+  // ── Git init + remote + staging branch ────────────────────────────────────
+  await safeStep('Creating initial commit', () => {
+    gitRun('git add -A', targetDir)
+    gitRun('git commit -m "chore: initial commit from create-nexora-next"', targetDir)
+  })
+
+  await safeStep(`Adding remote origin → ${pc.cyan(sshUrl)}`, () => {
+    gitRun(`git remote add origin ${sshUrl}`, targetDir)
+  })
+
+  await safeStep('Pushing main branch', () => {
+    gitRun('git branch -M main', targetDir)
+    gitRun('git push -u origin main', targetDir)
+  })
+
+  await safeStep('Creating staging branch', () => {
+    gitRun('git checkout -b staging', targetDir)
+    gitRun('git push -u origin staging', targetDir)
+    gitRun('git checkout main', targetDir)
+  })
+
+  p.log.success(
+    pc.green(`\n  ✓ Repository connected`) +
+    pc.dim(`\n    ${sshUrl}`) +
+    pc.dim(`\n    Branches: main · staging`)
+  )
+}

package/src/templates/files.js

@@ -593,9 +593,9 @@ export const proxyAuthTs = `import { NextFetchEvent, NextRequest, NextResponse }
 import type { ContextualProxy, ProxyContext } from '.'
 
 export const authProxy: ContextualProxy = async (
-  req: NextRequest,
+  _req: NextRequest,
   _event: NextFetchEvent,
-  ctx: ProxyContext,
+  _ctx: ProxyContext,
 ) => {
   // TODO: implement auth checks — verify session/token, set ctx.role, redirect if needed
   return NextResponse.next()

package/src/utils/args.js

@@ -11,9 +11,11 @@ const FLAGS = {
   '--husky':          { key: 'husky' },
   '--rc':             { key: 'reactCompiler' },
   '--react-compiler': { key: 'reactCompiler' },
+  '--github':         { key: 'github' },
   '--no-theming':     { key: 'theming',       value: false },
   '--no-husky':       { key: 'husky',         value: false },
   '--no-rc':          { key: 'reactCompiler', value: false },
+  '--no-github':      { key: 'github',        value: false },
   '--pm':             { key: 'pm',            takesValue: true },
   '-y':               { key: 'yes' },
   '--yes':            { key: 'yes' },
@@ -40,6 +42,7 @@ export function parseArgs(argv) {
     axios:         null,
     husky:         null,
     reactCompiler: null,
+    github:        null,
   }
 
   let i = 0
@@ -62,7 +65,7 @@ export function parseArgs(argv) {
   }
 
   if (result.all) {
-    for (const key of ['i18n','query','theming','animations','auth','axios','husky','reactCompiler']) {
+    for (const key of ['i18n','query','theming','animations','auth','axios','husky','reactCompiler','github']) {
       if (result[key] === null) result[key] = true
     }
   }
@@ -80,7 +83,7 @@ export function hasAnyFlag(parsed) {
     parsed.all ||
     parsed.name !== null ||
     parsed.pm !== null ||
-    ['i18n','query','theming','animations','auth','axios','husky','reactCompiler']
+    ['i18n','query','theming','animations','auth','axios','husky','reactCompiler','github']
       .some(k => parsed[k] !== null)
   )
 }
@@ -103,9 +106,11 @@ export function printHelp(version) {
     --axios                    Axios client/server instances
     --husky                    Husky pre-commit hooks
     --rc / --react-compiler    React Compiler
+    --github                   Connect a GitHub repository
     --no-theming               Skip theming
     --no-husky                 Skip Husky
     --no-rc                    Skip React Compiler
+    --no-github                Skip GitHub setup
     -y / --yes                 Accept all defaults (no prompts)
     -v / --version             Print version
     -h / --help                Show this help