create-nexora-next 0.4.7 → 0.4.9

package/README.md

@@ -1,46 +1,371 @@
-# create-nexora-next
+<div align="center">
 
-> The official Next.js scaffolding CLI by Rayan — batteries included.
+```
+  ███╗   ██╗███████╗██╗  ██╗ ██████╗ ██████╗  █████╗
+  ████╗  ██║██╔════╝╚██╗██╔╝██╔═══██╗██╔══██╗██╔══██╗
+  ██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║██████╔╝███████║
+  ██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║██╔══██╗██╔══██║
+  ██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝██║  ██║██║  ██║
+  ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝
+```
+
+**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)
+[![npm downloads](https://img.shields.io/npm/dm/create-nexora-next?color=blue&style=flat-square)](https://www.npmjs.com/package/create-nexora-next)
+[![license](https://img.shields.io/npm/l/create-nexora-next?style=flat-square)](./LICENSE)
+[![node](https://img.shields.io/node/v/create-nexora-next?style=flat-square)](https://nodejs.org)
+
+</div>
+
+---
 
 ## Usage
 
 ```bash
-npx create-nexora-next
-pnpm dlx create-nexora-next
-bunx create-nexora-next
-```
-
-## What it sets up
-
-### Always included
-- Next.js (TypeScript, Tailwind CSS v4, ESLint, App Router, `~/` alias)
-- shadcn/ui initialized with defaults
-- Custom `globals.css` (squircle utilities, container, skeleton animation)
-- `.prettierrc` with `prettier-plugin-tailwindcss`
-- `.env.local` pre-populated
-- Poppins font via `next/font/google`
-- `cn()`, `toSlug()`, `trycatch()`, and other utils
-- Typed constants (`TZ_COOKIE`, `SITE_URL`)
-- SEO metadata scaffold
-- `SileoToaster` component
-- Providers pattern (`src/components/providers/`)
-- nuqs adapter (URL state management)
-- Core deps: `zustand`, `zod`, `react-hook-form`, `date-fns`, `nuqs`, `cookies-next`, `nextjs-toploader`
-- Dev deps: `prettier`, `prettier-plugin-tailwindcss`, `babel-plugin-react-compiler`
-
-### Optional features (prompted)
-
-| Feature | What gets installed / created |
+# npm
+npx create-nexora-next@latest
+
+# pnpm
+pnpm dlx create-nexora-next@latest
+
+# bun
+bunx create-nexora-next@latest
+
+# yarn
+yarn dlx create-nexora-next@latest
+```
+
+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 gets this baseline — no questions asked:
+
+| What | Details |
 |---|---|
-| Husky | `husky`, `lint-staged`, pre-commit hook |
-| Localization | `next-intl`, `src/i18n/`, `locales/en.json`, `[locale]/page.tsx` |
-| TanStack Query | `@tanstack/react-query`, persist client, query-client provider |
-| Auth | proxy chain, auth validators, `src/apis/` |
-| Theming | `next-themes`, theme provider |
-| Animations | `motion`, `gsap` |
-| Axios | `axios`, `axios.client.ts`, `axios.server.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 (200–800) |
+| **Utility functions** | `cn()` · `toSlug()` · `createInitials()` · `normalizeEmail()` · `sanitizeName()` · `trycatch()` |
+| **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 · 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` |
+| **`type-check` script** | `tsc --pretty --noEmit` added to `package.json` |
+
+---
+
+## Optional features
+
+### 🌍 Localization (`next-intl`)
+
+```
+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
+
+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, and `disableTransitionOnChange`.
+
+---
+
+### 🔐 Auth
+
+- 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` (Framer Motion v11+)
+- `gsap`
+
+---
+
+### 🔄 Axios
+
+- `axios` installed
+- `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 — 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
+```
+
+---
+
+### ⚛️ React Compiler
+
+`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.
+
+---
+
+## Project structure
+
+```
+my-app/
+├── locales/
+│   └── 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
+│   │   ├── globals.css
+│   │   └── sitemap.ts
+│   ├── i18n/                             # (i18n)
+│   │   ├── routing.ts
+│   │   ├── request.ts
+│   │   └── navigation.ts
+│   ├── apis/                             # (auth)
+│   │   ├── client/index.ts
+│   │   └── server/index.ts
+│   ├── components/
+│   │   ├── adapters/nuqs.adapter.tsx
+│   │   ├── atoms/
+│   │   ├── molecules/
+│   │   ├── organisms/
+│   │   ├── primitives/
+│   │   ├── providers/
+│   │   │   ├── 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
+│   ├── hooks/
+│   ├── lib/
+│   │   ├── axios/                        # (axios)
+│   │   │   ├── axios.client.ts
+│   │   │   └── axios.server.ts
+│   │   ├── fonts.ts
+│   │   ├── proxy/                        # (auth or i18n)
+│   │   │   ├── index.ts
+│   │   │   └── auth.ts                   # (auth)
+│   │   ├── seo/index.ts
+│   │   ├── utils/
+│   │   │   ├── index.ts
+│   │   │   └── locale-date-formats.ts    # (i18n)
+│   │   └── validators/                   # (auth)
+│   │       ├── index.ts
+│   │       └── auth.ts
+│   └── proxy.ts                          # (i18n or auth)
+├── .env.local
+├── .prettierrc
+├── .husky/pre-commit                     # (husky)
+├── components.json
+├── eslint.config.mjs
+├── next-intl.ts                          # (i18n)
+└── next.config.ts
+```
+
+---
+
+## Error recovery
+
+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.
+
+---
 
 ## Requirements
 
-- Node.js 18+
-- npm, pnpm, bun, or yarn
+- **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 | Status |
+|---|---|---|
+| `create-nexora-next` | Next.js 16+ | ✅ Available |
+| `create-nexora-go` | Go | 🔜 Coming soon |
+
+---
+
+## Author
+
+**Chiatiah Rayan** · [rayanstudio.dev](https://rayanstudio.dev) · [@bbrainttech](https://github.com/bbrainttech)
+
+---
+
+<div align="center">
+
+Made with 🔥 by Rayan · MIT License
+
+</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-nexora-next",
-  "version": "0.4.7",
+  "version": "0.4.9",
   "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 15 + 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/03-base-files.js

@@ -1,25 +1,24 @@
-import path from 'path'
 import fs from 'fs'
-import { writeFile, mkdir } from '../utils/writer.js'
-import { safeStep } from '../utils/safe-step.js'
+import path from 'path'
 import {
+  constantsTs,
   envLocal,
-  prettierRc,
+  eslintConfigMjs,
   fontsTs,
-  utilsTs,
-  utilsWithAxiosTs,
-  constantsTs,
-  seoTs,
-  seoWithLocaleTs,
-  sileoUiTsx,
-  sileoProviderTsx,
+  localeLayoutTs,
   nuqsAdapterTsx,
+  prettierRc,
   rootLayoutI18nTs,
   rootLayoutTs,
-  localeLayoutTs,
-  eslintConfigMjs,
+  seoTs,
+  seoWithLocaleTs,
+  sileoUiTsx,
   sitemapTs,
+  utilsTs,
+  utilsWithAxiosTs
 } from '../templates/files.js'
+import { safeStep } from '../utils/safe-step.js'
+import { mkdir, writeFile } from '../utils/writer.js'
 
 /**
  * @param {string} targetDir
@@ -56,8 +55,6 @@ export async function stepWriteBaseFiles(targetDir, opts) {
     // src/components/ui/sileo.tsx
     writeFile(p('src', 'components', 'ui', 'sileo.tsx'), sileoUiTsx)
 
-    // src/components/providers/sileo.provider.tsx
-    writeFile(p('src', 'components', 'providers', 'sileo.provider.tsx'), sileoProviderTsx)
 
     // src/components/adapters/nuqs.adapter.tsx
     writeFile(p('src', 'components', 'adapters', 'nuqs.adapter.tsx'), nuqsAdapterTsx)

package/src/steps/04-providers.js

@@ -17,7 +17,7 @@ export async function stepWriteProviders(targetDir, opts) {
   await safeStep("Generating providers", () => {
     const p = (...parts) => path.join(targetDir, ...parts);
 
-    // Dynamic providers/index.ts
+    // Dynamic providers/index.tsx
     writeFile(
       p("src", "components", "providers", "index.tsx"),
       providersIndexTsx(opts),

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

@@ -299,14 +299,6 @@ const SileoToaster = () => {
 export { SileoToaster }
 `
 
-// ─── src/components/providers/sileo.provider.tsx ─────────────────────────────
-export const sileoProviderTsx = `// Sileo root provider — wrap app-level providers here as needed
-import type { PropsWithChildren } from 'react'
-
-export default ({ children }: PropsWithChildren) => {
-  return <>{children}</>
-}
-`
 
 // ─── src/components/providers/index.tsx (dynamic) ─────────────────────────────
 export const providersIndexTsx = (opts) => {
@@ -601,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