create-nexora-next 0.1.0

package/README.md

@@ -0,0 +1,46 @@
+# create-nexora-next
+
+> The official Next.js scaffolding CLI by Rayan — batteries included.
+
+## 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 |
+|---|---|
+| 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` |
+
+## Requirements
+
+- Node.js 18+
+- npm, pnpm, bun, or yarn

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "create-nexora-next",
+  "version": "0.1.0",
+  "description": "The official Next.js scaffolding CLI by Rayan — batteries included.",
+  "type": "module",
+  "bin": {
+    "create-nexora-next": "src/index.js"
+  },
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "dev": "node src/index.js"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "picocolors": "^1.1.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "nextjs",
+    "scaffold",
+    "cli",
+    "create-app",
+    "rayan",
+    "next-intl",
+    "shadcn",
+    "tanstack"
+  ],
+  "author": "Rayan",
+  "license": "MIT"
+}

package/src/index.js

@@ -0,0 +1,267 @@
+#!/usr/bin/env node
+import * as p from '@clack/prompts'
+import pc from 'picocolors'
+import path from 'path'
+import { existsSync } from 'fs'
+import { createRequire } from 'module'
+
+const require = createRequire(import.meta.url)
+const { version } = require('../package.json')
+
+import { stepCreateNextApp }  from './steps/01-create-next-app.js'
+import { stepSetupShadcn }    from './steps/02-shadcn.js'
+import { stepWriteBaseFiles } from './steps/03-base-files.js'
+import { stepWriteProviders } from './steps/04-providers.js'
+import { stepSetupI18n }      from './steps/05-i18n.js'
+import { stepSetupAuth }      from './steps/06-auth.js'
+import { stepWriteProxy }     from './steps/07-proxy.js'
+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'
+
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function bail(msg) {
+  p.cancel(pc.red(msg))
+  process.exit(1)
+}
+
+function onCancel() {
+  bail('Setup cancelled.')
+}
+
+function section(title) {
+  p.log.step(pc.bold(pc.cyan(`\n  ${title}`)))
+}
+
+// ─── Banner ───────────────────────────────────────────────────────────────────
+
+function printBanner() {
+  const art = [
+    '  ███╗   ██╗███████╗██╗  ██╗ ██████╗ ██████╗  █████╗ ',
+    '  ████╗  ██║██╔════╝╚██╗██╔╝██╔═══██╗██╔══██╗██╔══██╗',
+    '  ██╔██╗ ██║█████╗   ╚███╔╝ ██║   ██║██████╔╝███████║',
+    '  ██║╚██╗██║██╔══╝   ██╔██╗ ██║   ██║██╔══██╗██╔══██║',
+    '  ██║ ╚████║███████╗██╔╝ ██╗╚██████╔╝██║  ██║██║  ██║',
+    '  ╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝',
+  ]
+  // Fade from cyan → blue top to bottom
+  const gradient = [pc.cyan, pc.cyan, pc.cyan, pc.blue, pc.blue, pc.blue]
+
+  console.log()
+  art.forEach((line, i) => console.log(pc.bold(gradient[i](line))))
+  console.log()
+  const W = 44
+  const centre = (str) => {
+    const pad = W - str.length
+    const l = Math.floor(pad / 2)
+    const r = pad - l
+    return ' '.repeat(l) + str + ' '.repeat(r)
+  }
+  const bar = '═'.repeat(W)
+  console.log(pc.bold(pc.cyan(
+    `  ╔${bar}╗\n` +
+    `  ║${centre(`create-nexora-next  v${version}`)}║\n` +
+    `  ║${centre('Next.js scaffold · by Rayan')}║\n` +
+    `  ╚${bar}╝`
+  )))
+  console.log()
+}
+
+// ─── Summary ──────────────────────────────────────────────────────────────────
+
+function printSummary(opts, projectName, pm) {
+  const yes  = pc.green('✓')
+  const skip = pc.dim('–')
+  const row  = (label, on) =>
+    `  ${on ? yes : skip}  ${on ? pc.white(label) : pc.dim(label)}`
+
+  console.log()
+  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('shadcn/ui + custom globals.css utilities',    true))
+  console.log(row('Prettier + tailwind class sorting',           true))
+  console.log(row('Poppins font + path alias ~/',                true))
+  console.log(row('Localization via next-intl',                  opts.i18n))
+  console.log(row('TanStack Query + local persistence',          opts.query))
+  console.log(row('Theming with next-themes',                    opts.theming))
+  console.log(row('Animations — motion + gsap',                  opts.animations))
+  console.log(row('Auth proxy + zod validators',                 opts.auth))
+  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()
+  console.log(pc.bold('  Next steps:'))
+  console.log(`  ${pc.cyan('cd')} ${projectName}`)
+  const devCmd = pm === 'npm' ? 'npm run dev' : `${pm} dev`
+  console.log(`  ${pc.cyan(devCmd)}`)
+  console.log()
+  console.log(pc.dim('  Happy shipping, Rayan. 🔥'))
+  console.log()
+}
+
+// ─── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  printBanner()
+  p.intro(pc.bgCyan(pc.black(" create-nexora-next ")))
+
+  // ── Phase 1: Identity ──────────────────────────────────────────────────────
+  section('Phase 1 — Project identity')
+
+  const projectName = await p.text({
+    message: 'What is your project name?',
+    placeholder: 'my-app',
+    validate: (v) => {
+      if (!v || !v.trim()) return 'Project name is required.'
+      if (!/^[a-z0-9-_]+$/.test(v.trim()))
+        return 'Use lowercase letters, numbers, hyphens or underscores only.'
+    },
+  })
+  if (p.isCancel(projectName)) onCancel()
+  const name = projectName.trim()
+
+  const targetDir = path.resolve(process.cwd(), name)
+  if (existsSync(targetDir)) {
+    bail(`Directory "${name}" already exists. Choose a different name.`)
+  }
+
+  const pm = await p.select({
+    message: 'Which package manager?',
+    options: [
+      { value: 'pnpm', label: 'pnpm', hint: 'recommended' },
+      { value: 'bun',  label: 'bun',  hint: 'fastest'     },
+      { value: 'npm',  label: 'npm',  hint: 'classic'     },
+      { value: 'yarn', label: 'yarn', hint: 'classic alt'  },
+    ],
+  })
+  if (p.isCancel(pm)) onCancel()
+
+  // ── Phase 2: Feature flags ─────────────────────────────────────────────────
+  section('Phase 2 — Features')
+
+  const i18n = await p.confirm({
+    message: 'Set up localization? (next-intl)',
+    initialValue: false,
+  })
+  if (p.isCancel(i18n)) onCancel()
+
+  const query = await p.confirm({
+    message: 'Set up TanStack Query + local persistence?',
+    initialValue: false,
+  })
+  if (p.isCancel(query)) onCancel()
+
+  const theming = await p.confirm({
+    message: 'Set up theming? (next-themes dark/light)',
+    initialValue: true,
+  })
+  if (p.isCancel(theming)) onCancel()
+
+  const animations = await p.confirm({
+    message: 'Install animation libraries? (motion + gsap)',
+    initialValue: false,
+  })
+  if (p.isCancel(animations)) onCancel()
+
+  const auth = await p.confirm({
+    message: 'Set up auth proxy + zod validators?',
+    initialValue: false,
+  })
+  if (p.isCancel(auth)) onCancel()
+
+  const axios = await p.confirm({
+    message: 'Set up axios client/server instances?',
+    initialValue: false,
+  })
+  if (p.isCancel(axios)) onCancel()
+
+  const husky = await p.confirm({
+    message: 'Configure Husky pre-commit hooks?',
+    initialValue: true,
+  })
+  if (p.isCancel(husky)) onCancel()
+
+  const reactCompiler = await p.confirm({
+    message: 'Enable React Compiler? (babel-plugin-react-compiler)',
+    initialValue: true,
+  })
+  if (p.isCancel(reactCompiler)) onCancel()
+
+  // ── Confirm ────────────────────────────────────────────────────────────────
+  const features = [
+    i18n       && 'i18n',
+    query      && 'query',
+    theming    && 'theming',
+    animations && 'animations',
+    auth       && 'auth',
+    axios      && 'axios',
+    husky      && 'husky',
+    reactCompiler && 'react-compiler',
+  ].filter(Boolean)
+
+  console.log()
+  p.log.info(
+    pc.bold(`  ${pc.cyan(name)}`) +
+    pc.dim(` · ${pm}`) +
+    (features.length ? pc.dim(' · ' + features.join(' · ')) : '')
+  )
+  console.log()
+
+  const go = await p.confirm({
+    message: 'Ready to scaffold?',
+    initialValue: true,
+  })
+  if (p.isCancel(go) || !go) onCancel()
+
+  // ── Phase 3: Execution ─────────────────────────────────────────────────────
+  section('Phase 3 — Building your project')
+
+  const opts = {
+    i18n:       Boolean(i18n),
+    query:      Boolean(query),
+    theming:    Boolean(theming),
+    animations: Boolean(animations),
+    auth:       Boolean(auth),
+    axios:      Boolean(axios),
+    husky:      Boolean(husky),
+    reactCompiler: Boolean(reactCompiler),
+  }
+
+  await stepCreateNextApp(name, pm, targetDir)
+  await stepSetupShadcn(targetDir, pm)
+  await stepWriteBaseFiles(targetDir, opts)
+  await stepWriteProviders(targetDir, opts)
+
+  if (opts.i18n) {
+    await stepSetupI18n(targetDir, pm, opts)
+  }
+
+  if (opts.auth || opts.i18n) {
+    await stepSetupAuth(targetDir, opts)
+  }
+
+  await stepWriteProxy(targetDir, opts)
+
+  if (opts.axios) {
+    await stepSetupAxios(targetDir)
+  }
+
+  await stepInstallDeps(targetDir, pm, opts)
+  await stepPatchPackageJson(targetDir)
+
+  if (opts.husky) {
+    await stepSetupHusky(targetDir, pm)
+  }
+
+  printSummary(opts, name, pm)
+  p.outro(pc.bgGreen(pc.black(' Done! ')))
+}
+
+main().catch((err) => {
+  console.error(pc.red('\n  Unexpected error:'), err.message || err)
+  process.exit(1)
+})

package/src/steps/01-create-next-app.js

@@ -0,0 +1,19 @@
+import path from 'path'
+import { run, execCmd } from '../utils/runner.js'
+import { safeStep } from '../utils/safe-step.js'
+
+/**
+ * @param {string} projectName
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ * @param {string} targetDir  Absolute path where the project will live
+ */
+export async function stepCreateNextApp(projectName, pm, targetDir) {
+  await safeStep('Scaffolding Next.js app', () => {
+    const x = execCmd(pm)
+    // create-next-app flags: TypeScript, Tailwind, ESLint, App Router, src dir, no Turbopack prompt, import alias ~
+    run(
+      `${x} create-next-app@latest ${projectName} --typescript --tailwind --eslint --app --src-dir --no-turbopack --import-alias "~/*" --use-${pm === 'npm' ? 'npm' : pm}`,
+      path.dirname(targetDir),
+    )
+  })
+}

package/src/steps/02-shadcn.js

@@ -0,0 +1,39 @@
+import path from 'path'
+import fs from 'fs'
+import { run, execCmd } from '../utils/runner.js'
+import { appendFile } from '../utils/writer.js'
+import { safeStep } from '../utils/safe-step.js'
+import { globalsCssAppend } from '../templates/files.js'
+
+/**
+ * @param {string} targetDir
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ */
+export async function stepSetupShadcn(targetDir, pm) {
+  await safeStep('Initialising shadcn/ui', () => {
+    const x = execCmd(pm)
+    run(`${x} shadcn@latest init -y -d`, targetDir)
+  })
+
+  await safeStep('Patching shadcn config + cleaning up', () => {
+    // 1. Delete src/lib/utils.ts if shadcn created it (we use src/lib/utils/index.ts)
+    const shadcnUtils = path.join(targetDir, 'src', 'lib', 'utils.ts')
+    if (fs.existsSync(shadcnUtils)) fs.unlinkSync(shadcnUtils)
+
+    // 2. Update components.json utils path to point at our index.ts
+    const componentsJson = path.join(targetDir, 'components.json')
+    if (fs.existsSync(componentsJson)) {
+      const raw = fs.readFileSync(componentsJson, 'utf8')
+      const patched = raw.replace(
+        '"utils": "~/lib/utils"',
+        '"utils": "~/lib/utils/index.ts"',
+      )
+      fs.writeFileSync(componentsJson, patched, 'utf8')
+    }
+  })
+
+  await safeStep('Appending custom styles to globals.css', () => {
+    const globalsPath = path.join(targetDir, 'src', 'app', 'globals.css')
+    appendFile(globalsPath, globalsCssAppend)
+  })
+}

package/src/steps/03-base-files.js

@@ -0,0 +1,110 @@
+import path from 'path'
+import fs from 'fs'
+import { writeFile, mkdir } from '../utils/writer.js'
+import { safeStep } from '../utils/safe-step.js'
+import {
+  envLocal,
+  prettierRc,
+  fontsTs,
+  utilsTs,
+  utilsWithAxiosTs,
+  constantsTs,
+  seoTs,
+  seoWithLocaleTs,
+  sileoUiTsx,
+  sileoProviderTsx,
+  nuqsAdapterTsx,
+  rootLayoutI18nTs,
+  rootLayoutTs,
+  localeLayoutTs,
+  eslintConfigMjs,
+  sitemapTs,
+} from '../templates/files.js'
+
+/**
+ * @param {string} targetDir
+ * @param {{ i18n: boolean, axios: boolean, query: boolean }} opts
+ */
+export async function stepWriteBaseFiles(targetDir, opts) {
+  await safeStep('Writing base config files', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+
+    // .env.local
+    writeFile(p('.env.local'), envLocal)
+
+    // .prettierrc
+    writeFile(p('.prettierrc'), prettierRc)
+
+    // src/lib/fonts.ts
+    writeFile(p('src', 'lib', 'fonts.ts'), fontsTs)
+
+    // src/lib/utils/index.ts
+    writeFile(
+      p('src', 'lib', 'utils', 'index.ts'),
+      opts.axios ? utilsWithAxiosTs : utilsTs,
+    )
+
+    // src/constants/index.ts
+    writeFile(p('src', 'constants', 'index.ts'), constantsTs(opts))
+
+    // src/lib/seo/index.ts
+    writeFile(
+      p('src', 'lib', 'seo', 'index.ts'),
+      opts.i18n ? seoWithLocaleTs : seoTs,
+    )
+
+    // 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)
+
+    // Empty structural folders
+    const emptyDirs = [
+      ['src', 'hooks'],
+      ['src', 'components', 'atoms'],
+      ['src', 'components', 'molecules'],
+      ['src', 'components', 'organisms'],
+      ['src', 'components', 'primitives'],
+    ]
+    for (const parts of emptyDirs) {
+      mkdir(p(...parts))
+      writeFile(p(...parts, 'index.ts'), `// ${parts[parts.length - 1]}\n`)
+    }
+  })
+
+  // ── Layouts ────────────────────────────────────────────────────────────────
+  await safeStep('Setting up app layouts', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+
+    if (opts.i18n) {
+      // Replace root layout with passthrough shell
+      writeFile(p('src', 'app', 'layout.tsx'), rootLayoutI18nTs)
+
+      // Remove the default src/app/page.tsx (locale takes over routing)
+      const defaultPage = p('src', 'app', 'page.tsx')
+      if (fs.existsSync(defaultPage)) fs.unlinkSync(defaultPage)
+
+      // Create src/app/[locale]/layout.tsx
+      writeFile(p('src', 'app', '[locale]', 'layout.tsx'), localeLayoutTs)
+    } else {
+      // Standard root layout wiring up Providers
+      writeFile(p('src', 'app', 'layout.tsx'), rootLayoutTs)
+    }
+  })
+
+  // ── ESLint config ──────────────────────────────────────────────────────────
+  await safeStep('Replacing ESLint config', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+    writeFile(p('eslint.config.mjs'), eslintConfigMjs(opts))
+  })
+
+  // ── Sitemap ────────────────────────────────────────────────────────────────
+  await safeStep('Writing sitemap', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+    writeFile(p('src', 'app', 'sitemap.ts'), sitemapTs)
+  })
+}

package/src/steps/04-providers.js

@@ -0,0 +1,51 @@
+import path from "path";
+import {
+  localeProviderTsx,
+  providersIndexTsx,
+  queryClientProviderTsx,
+  themeProviderTsx,
+  tzProviderTsx,
+} from "../templates/files.js";
+import { safeStep } from "../utils/safe-step.js";
+import { writeFile } from "../utils/writer.js";
+
+/**
+ * @param {string} targetDir
+ * @param {{ i18n: boolean, theming: boolean, query: boolean }} opts
+ */
+export async function stepWriteProviders(targetDir, opts) {
+  await safeStep("Generating providers", () => {
+    const p = (...parts) => path.join(targetDir, ...parts);
+
+    // Dynamic providers/index.ts
+    writeFile(
+      p("src", "components", "providers", "index.tsx"),
+      providersIndexTsx(opts),
+    );
+
+    if (opts.theming) {
+      writeFile(
+        p("src", "components", "providers", "theme.provider.tsx"),
+        themeProviderTsx,
+      );
+    }
+
+    if (opts.i18n) {
+      writeFile(
+        p("src", "components", "providers", "locale.provider.tsx"),
+        localeProviderTsx,
+      );
+      writeFile(
+        p("src", "components", "providers", "tz.provider.tsx"),
+        tzProviderTsx,
+      );
+    }
+
+    if (opts.query) {
+      writeFile(
+        p("src", "components", "providers", "query-client.provider.tsx"),
+        queryClientProviderTsx,
+      );
+    }
+  });
+}

package/src/steps/05-i18n.js

@@ -0,0 +1,42 @@
+import path from 'path'
+import { writeFile } from '../utils/writer.js'
+import { run, installCmd } from '../utils/runner.js'
+import { safeStep } from '../utils/safe-step.js'
+import {
+  i18nRoutingTs,
+  i18nRequestTs,
+  i18nNavigationTs,
+  nextIntlTs,
+  localesEnJson,
+  localPageTsx,
+  localeDateFormatsTs,
+  nextConfigI18nTs,
+} from '../templates/files.js'
+
+/**
+ * @param {string} targetDir
+ * @param {'npm'|'pnpm'|'bun'|'yarn'} pm
+ * @param {{ reactCompiler: boolean }} opts
+ */
+export async function stepSetupI18n(targetDir, pm, opts) {
+  await safeStep('Installing next-intl', () => {
+    run(installCmd(pm, ['next-intl']), targetDir)
+  })
+
+  await safeStep('Writing i18n files', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+
+    writeFile(p('locales', 'en.json'), localesEnJson)
+    writeFile(p('src', 'i18n', 'routing.ts'), i18nRoutingTs)
+    writeFile(p('src', 'i18n', 'request.ts'), i18nRequestTs)
+    writeFile(p('src', 'i18n', 'navigation.ts'), i18nNavigationTs)
+    writeFile(p('next-intl.ts'), nextIntlTs)
+    writeFile(p('src', 'app', '[locale]', 'page.tsx'), localPageTsx)
+    writeFile(p('src', 'lib', 'utils', 'locale-date-formats.ts'), localeDateFormatsTs)
+  })
+
+  await safeStep('Updating next.config.ts for next-intl', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+    writeFile(p('next.config.ts'), nextConfigI18nTs(opts))
+  })
+}

package/src/steps/06-auth.js

@@ -0,0 +1,31 @@
+import path from 'path'
+import { writeFile } from '../utils/writer.js'
+import { safeStep } from '../utils/safe-step.js'
+import {
+  proxyLibTs,
+  proxyAuthTs,
+  validatorsAuthTs,
+  validatorsTs,
+  apisClientTs,
+  apisServerTs,
+} from '../templates/files.js'
+
+/**
+ * @param {string} targetDir
+ * @param {{ i18n: boolean, auth: boolean, axios: boolean }} opts
+ */
+export async function stepSetupAuth(targetDir, opts) {
+  await safeStep('Writing auth & proxy files', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+
+    writeFile(p('src', 'lib', 'proxy', 'index.ts'), proxyLibTs)
+
+    if (opts.auth) {
+      writeFile(p('src', 'lib', 'proxy', 'auth.ts'), proxyAuthTs)
+      writeFile(p('src', 'lib', 'validators', 'index.ts'), validatorsTs)
+      writeFile(p('src', 'lib', 'validators', 'auth.ts'), validatorsAuthTs)
+      writeFile(p('src', 'apis', 'client', 'index.ts'), apisClientTs)
+      writeFile(p('src', 'apis', 'server', 'index.ts'), apisServerTs)
+    }
+  })
+}

package/src/steps/07-proxy.js

@@ -0,0 +1,17 @@
+import path from 'path'
+import { writeFile } from '../utils/writer.js'
+import { safeStep } from '../utils/safe-step.js'
+import { proxyTs } from '../templates/files.js'
+
+/**
+ * @param {string} targetDir
+ * @param {{ i18n: boolean, auth: boolean }} opts
+ */
+export async function stepWriteProxy(targetDir, opts) {
+  if (!opts.i18n && !opts.auth) return
+
+  await safeStep('Writing Next.js middleware (proxy)', () => {
+    const p = (...parts) => path.join(targetDir, ...parts)
+    writeFile(p('src', 'proxy.ts'), proxyTs(opts))
+  })
+}