create-nexora-next 0.1.0

package/src/templates/files.js

@@ -0,0 +1,908 @@
+// ─── globals.css append ───────────────────────────────────────────────────────
+export const globalsCssAppend = `
+@utility container {
+  padding-inline: 1.25rem;
+  margin-inline: auto;
+  @variant sm {
+    padding-inline: 2rem;
+  }
+  @variant lg {
+    padding-inline: 2rem;
+    max-width: 1024px;
+  }
+  @variant xl {
+    padding-inline: 2.5rem;
+    max-width: 1280px;
+  }
+  @variant 2xl {
+    padding-inline: 3rem;
+  }
+}
+@layer theme {
+  @theme {
+    --breakpoint-dash-lg: 1010px;
+    --breakpoint-xs: 480px;
+  }
+}
+
+@keyframes skeleton {
+  0% { background-position: 200% 0; }
+  100% { background-position: -200% 0; }
+}
+
+@utility corner-squircle { @apply corner-squircle-md; }
+@utility corner-squircle-xs {
+  border-radius: 6px;
+  @supports (corner-shape: squircle) { border-radius: 8px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-sm {
+  border-radius: 8px;
+  @supports (corner-shape: squircle) { border-radius: 12px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-md {
+  border-radius: 12px;
+  @supports (corner-shape: squircle) { border-radius: 16px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-lg {
+  border-radius: 16px;
+  @supports (corner-shape: squircle) { border-radius: 24px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-xl {
+  border-radius: 24px;
+  @supports (corner-shape: squircle) { border-radius: 32px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-2xl {
+  border-radius: 32px;
+  @supports (corner-shape: squircle) { border-radius: 48px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-3xl {
+  border-radius: 48px;
+  @supports (corner-shape: squircle) { border-radius: 64px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-l-lg {
+  border-top-left-radius: 16px; border-bottom-left-radius: 16px;
+  @supports (corner-shape: squircle) { border-top-left-radius: 24px !important; border-bottom-left-radius: 24px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-t-lg {
+  border-top-left-radius: 16px; border-top-right-radius: 16px;
+  @supports (corner-shape: squircle) { border-top-left-radius: 24px !important; border-top-right-radius: 24px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-tl-2xl {
+  border-top-left-radius: 32px;
+  @supports (corner-shape: squircle) { border-top-left-radius: 48px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-r-lg {
+  border-top-right-radius: 16px; border-bottom-right-radius: 16px;
+  @supports (corner-shape: squircle) { border-top-right-radius: 24px !important; border-bottom-right-radius: 24px !important; corner-shape: squircle; }
+}
+@utility corner-squircle-full {
+  border-radius: 9999px !important;
+  @supports (corner-shape: squircle) { corner-shape: squircle; }
+}
+@utility corner-squircle-none {
+  border-radius: initial; corner-shape: initial;
+  @supports (corner-shape: squircle) { border-radius: initial; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *, ::before, ::after {
+    animation-delay: -1ms !important;
+    animation-duration: 1ms !important;
+    animation-iteration-count: 1 !important;
+    background-attachment: initial !important;
+    scroll-behavior: auto !important;
+    transition-duration: 1ms !important;
+    transition-delay: -1ms !important;
+  }
+}
+`
+
+// ─── .env.local ───────────────────────────────────────────────────────────────
+export const envLocal = `NEXT_PUBLIC_SITE_URL="http://localhost:3000"
+`
+
+// ─── .prettierrc ──────────────────────────────────────────────────────────────
+export const prettierRc = `{
+  "plugins": ["prettier-plugin-tailwindcss"],
+  "semi": false,
+  "singleQuote": true,
+  "bracketSameLine": false,
+  "bracketSpacing": true
+}
+`
+
+// ─── src/lib/fonts.ts ─────────────────────────────────────────────────────────
+export const fontsTs = `import { Poppins } from 'next/font/google'
+
+export const PoppinsFont = Poppins({
+  subsets: ['latin'],
+  display: 'swap',
+  variable: '--font-poppins',
+  weight: ['200', '300', '400', '500', '600', '700', '800'],
+})
+`
+
+// ─── src/lib/utils/index.ts (no axios) ───────────────────────────────────────
+export const utilsTs = `import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
+
+export function toSlug(str?: string | null) {
+  if (!str) return ''
+  return str
+    .toString()
+    .trim()
+    .toLowerCase()
+    .replace(/\\s+/g, '-')
+    .replace(/[^\\w-]+/g, '')
+    .replace(/--+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}
+
+export const createInitials = (input?: string | null, count = 2): string => {
+  if (!input) return ''
+  try {
+    const words = input.split(/(?=[A-Z])|[\\W_]+/).filter(Boolean)
+    const abbreviation = words
+      .map((word) => word[0].toUpperCase())
+      .join('')
+      .slice(0, Math.min(count, 3))
+    return abbreviation.length < 2 && input.length > 1
+      ? abbreviation + input[1].toUpperCase()
+      : abbreviation
+  } catch (_) {
+    return input.toUpperCase()
+  }
+}
+
+export function normalizeEmail(email: string) {
+  const trimmed = email.trim().toLowerCase()
+  if (trimmed.endsWith('@gmail.com')) {
+    const [local, domain] = trimmed.split('@')
+    return \`\${local.replace(/\\./g, '')}@\${domain}\`
+  }
+  return trimmed
+}
+
+export function sanitizeName(name: string) {
+  return name.trim().replace(/<[^>]*>/g, '').replace(/\\0/g, '').substring(0, 255)
+}
+
+export const trycatch = async <T, E = Error>(
+  promise: Promise<T>,
+): Promise<[T, null] | [null, E]> => {
+  try {
+    return [await promise, null]
+  } catch (err) {
+    return [null, err as E]
+  }
+}
+`
+
+// ─── src/lib/utils/index.ts (with axios) ─────────────────────────────────────
+export const utilsWithAxiosTs = `import { AxiosError } from 'axios'
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
+
+export function toSlug(str?: string | null) {
+  if (!str) return ''
+  return str
+    .toString()
+    .trim()
+    .toLowerCase()
+    .replace(/\\s+/g, '-')
+    .replace(/[^\\w-]+/g, '')
+    .replace(/--+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}
+
+export const createInitials = (input?: string | null, count = 2): string => {
+  if (!input) return ''
+  try {
+    const words = input.split(/(?=[A-Z])|[\\W_]+/).filter(Boolean)
+    const abbreviation = words
+      .map((word) => word[0].toUpperCase())
+      .join('')
+      .slice(0, Math.min(count, 3))
+    return abbreviation.length < 2 && input.length > 1
+      ? abbreviation + input[1].toUpperCase()
+      : abbreviation
+  } catch (_) {
+    return input.toUpperCase()
+  }
+}
+
+export function normalizeEmail(email: string) {
+  const trimmed = email.trim().toLowerCase()
+  if (trimmed.endsWith('@gmail.com')) {
+    const [local, domain] = trimmed.split('@')
+    return \`\${local.replace(/\\./g, '')}@\${domain}\`
+  }
+  return trimmed
+}
+
+export function sanitizeName(name: string) {
+  return name.trim().replace(/<[^>]*>/g, '').replace(/\\0/g, '').substring(0, 255)
+}
+
+export const trycatch = async <T, E = AxiosError>(
+  promise: Promise<T>,
+): Promise<[T, null] | [null, E]> => {
+  try {
+    return [await promise, null]
+  } catch (err) {
+    return [null, err as E]
+  }
+}
+`
+
+// ─── src/constants/index.ts ───────────────────────────────────────────────────
+export const constantsTs = (opts) => {
+  const lines = [
+    `export const TZ_COOKIE = 'app_tz'`,
+    `export const SITE_URL = process.env.NEXT_PUBLIC_SITE_URL || 'http://localhost:3000'`,
+  ]
+  if (opts.i18n) {
+    lines.push(`export const LOCALE_COOKIE = 'app_locale'`)
+    lines.push(`export const APP_LOCALES = ['en'] as const`)
+    lines.push(`export type AppLocale = (typeof APP_LOCALES)[number]`)
+  }
+  return lines.join('\n') + '\n'
+}
+
+// ─── src/lib/seo/index.ts ────────────────────────────────────────────────────
+export const seoWithLocaleTs = `import { Metadata } from 'next'
+import type { AppLocale } from '~/constants'
+
+export type AppMetadata = Record<AppLocale, Metadata>
+
+export default {
+  en: { title: 'App' },
+} satisfies AppMetadata
+`
+
+export const seoTs = `import { Metadata } from 'next'
+
+export default {
+  title: 'App',
+} satisfies Metadata
+`
+
+// ─── src/lib/fonts.ts ─────────────────────────────────────────────────────────
+// (already defined above as fontsTs)
+
+// ─── src/components/ui/sileo.tsx ─────────────────────────────────────────────
+export const sileoUiTsx = `import { Toaster as Sileo } from 'sileo'
+
+const SileoToaster = () => {
+  return (
+    <div className="relative z-100!">
+      <Sileo
+        position="top-center"
+        options={{
+          duration: 7000,
+          fill: 'var(--foreground)',
+          styles: { description: 'text-background/80!' },
+        }}
+      />
+    </div>
+  )
+}
+
+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) => {
+  const imports = [
+    `import NextTopLoader from 'nextjs-toploader'`,
+    `import type { PropsWithChildren } from 'react'`,
+    `import NuqsAdapter from '../adapters/nuqs.adapter'`,
+    `import { SileoToaster } from '../ui/sileo'`,
+  ]
+  if (opts.i18n)    imports.push(`import LocaleProvider from './locale.provider'`)
+  if (opts.theming) imports.push(`import ThemeProvider from './theme.provider'`)
+  if (opts.query)   imports.push(`import QueryClientProvider from './query-client.provider'`)
+
+  const open  = []
+  const close = []
+
+  if (opts.i18n)    { open.push(`    <LocaleProvider>`);       close.unshift(`    </LocaleProvider>`) }
+  if (opts.theming) { open.push(`      <ThemeProvider>`);      close.unshift(`      </ThemeProvider>`) }
+  if (opts.query)   { open.push(`        <QueryClientProvider>`); close.unshift(`        </QueryClientProvider>`) }
+
+  const indent = '        '
+  const inner = [
+    `${indent}<SileoToaster />`,
+    `${indent}<NextTopLoader height={2.5} color="var(--primary-text)" showSpinner={false} />`,
+    `${indent}<NuqsAdapter>{children}</NuqsAdapter>`,
+  ].join('\n')
+
+  return `${imports.join('\n')}
+
+export default ({ children }: PropsWithChildren) => {
+  return (
+${open.join('\n')}
+${inner}
+${close.join('\n')}
+  )
+}
+`
+}
+
+// ─── src/components/providers/theme.provider.tsx ─────────────────────────────
+export const themeProviderTsx = `import { ThemeProvider } from 'next-themes'
+import type { PropsWithChildren } from 'react'
+
+export default ({ children }: PropsWithChildren) => (
+  <ThemeProvider
+    defaultTheme="system"
+    attribute={['class']}
+    disableTransitionOnChange
+    enableSystem
+  >
+    {children}
+  </ThemeProvider>
+)
+`
+
+// ─── src/components/providers/locale.provider.tsx ────────────────────────────
+export const localeProviderTsx = `import { NextIntlClientProvider } from 'next-intl'
+import { Suspense, type PropsWithChildren } from 'react'
+import TzProvider from './tz.provider'
+
+export default ({ children }: PropsWithChildren) => {
+  return (
+    <Suspense fallback={null}>
+      <TzProvider />
+      <NextIntlClientProvider>{children}</NextIntlClientProvider>
+    </Suspense>
+  )
+}
+`
+
+// ─── src/components/providers/tz.provider.tsx ────────────────────────────────
+export const tzProviderTsx = `'use client'
+
+import { getCookie, setCookie } from 'cookies-next/client'
+import { useEffect } from 'react'
+import { TZ_COOKIE } from '~/constants'
+
+export default () => {
+  useEffect(() => {
+    const existing = getCookie(TZ_COOKIE)
+    const deviceTimezone = Intl.DateTimeFormat().resolvedOptions().timeZone
+    if (!existing || existing !== deviceTimezone) {
+      setCookie(TZ_COOKIE, deviceTimezone, {
+        path: '/',
+        maxAge: 60 * 60 * 24 * 365,
+        sameSite: 'lax',
+      })
+    }
+  }, [])
+  return null
+}
+`
+
+// ─── src/components/providers/query-client.provider.tsx ──────────────────────
+export const queryClientProviderTsx = `'use client'
+import { createAsyncStoragePersister } from '@tanstack/query-async-storage-persister'
+import {
+  DefaultOptions,
+  MutationCache,
+  QueryClient,
+  QueryClientProvider,
+  QueryKey,
+} from '@tanstack/react-query'
+import {
+  PersistQueryClientProvider,
+  removeOldestQuery,
+} from '@tanstack/react-query-persist-client'
+import { PropsWithChildren, useState } from 'react'
+
+const persister = createAsyncStoragePersister({
+  storage: typeof window !== 'undefined' ? localStorage : null,
+  key: 'rayan_app_persister_store',
+  retry: removeOldestQuery,
+  throttleTime: 3000,
+})
+
+const _5minutes = 5 * 60 * 1000
+const _24hours = 1000 * 60 * 60 * 24
+
+export const defaultOptions = {
+  queries: {
+    retry: false,
+    staleTime: _5minutes,
+    gcTime: _5minutes,
+    refetchOnWindowFocus: false,
+    refetchOnMount: 'always',
+    refetchOnReconnect: true,
+    refetchInterval: false,
+  },
+} satisfies DefaultOptions
+
+export default ({ children }: PropsWithChildren) => {
+  const mutationCache = new MutationCache({
+    async onSettled(_data, _error, _variables, _context, mutation) {
+      const meta = mutation.options.meta
+      const invalidateQueries = meta?.invalidateQueries as QueryKey | QueryKey[]
+      if (!invalidateQueries) return
+      const queryKeys = Array.isArray(invalidateQueries[0])
+        ? (invalidateQueries as QueryKey[])
+        : [invalidateQueries]
+      await Promise.all(
+        queryKeys.map((queryKey) => client.invalidateQueries({ queryKey })),
+      )
+    },
+  })
+
+  const [client] = useState(new QueryClient({ defaultOptions, mutationCache }))
+  const dehydrationKeys: string[] = []
+
+  return (
+    <QueryClientProvider client={client}>
+      <PersistQueryClientProvider
+        client={client}
+        persistOptions={{
+          persister,
+          maxAge: _24hours,
+          dehydrateOptions: {
+            shouldDehydrateQuery: (query) => {
+              const isSuccess =
+                query.state?.status === 'success' &&
+                typeof query.state?.data !== 'undefined'
+              return isSuccess && !dehydrationKeys.includes(query.queryKey[0] as string)
+            },
+          },
+        }}
+      >
+        {children}
+      </PersistQueryClientProvider>
+    </QueryClientProvider>
+  )
+}
+`
+
+// ─── src/components/adapters/nuqs.adapter.tsx ────────────────────────────────
+export const nuqsAdapterTsx = `import { NuqsAdapter } from 'nuqs/adapters/next/app'
+import type { PropsWithChildren } from 'react'
+
+export default ({ children }: PropsWithChildren) => {
+  return <NuqsAdapter>{children}</NuqsAdapter>
+}
+`
+
+// ─── src/i18n/routing.ts ─────────────────────────────────────────────────────
+export const i18nRoutingTs = `import { defineRouting } from 'next-intl/routing'
+import { APP_LOCALES, LOCALE_COOKIE } from '../constants'
+
+export const routing = defineRouting({
+  locales: APP_LOCALES,
+  localeCookie: { name: LOCALE_COOKIE, maxAge: 60 * 60 * 24 * 30 },
+  defaultLocale: 'en',
+})
+`
+
+// ─── src/i18n/request.ts ─────────────────────────────────────────────────────
+export const i18nRequestTs = `import { hasLocale } from 'next-intl'
+import { getRequestConfig } from 'next-intl/server'
+import { cookies } from 'next/headers'
+import { localeFormats } from '~/lib/utils/locale-date-formats'
+import { routing } from './routing'
+
+export default getRequestConfig(async ({ requestLocale }) => {
+  const requested = await requestLocale
+  const locale = hasLocale(routing.locales, requested)
+    ? requested
+    : routing.defaultLocale
+  const cookieStore = await cookies()
+  const timeZone =
+    cookieStore.get('app_tz')?.value ??
+    Intl.DateTimeFormat().resolvedOptions().timeZone
+
+  return {
+    locale,
+    timeZone,
+    formats: localeFormats,
+    messages: (await import(\`../../locales/\${locale}.json\`)).default,
+  }
+})
+`
+
+// ─── src/i18n/navigation.ts ──────────────────────────────────────────────────
+export const i18nNavigationTs = `import { createNavigation } from 'next-intl/navigation'
+import { routing } from './routing'
+
+export const { Link, redirect, usePathname, useRouter, getPathname } =
+  createNavigation(routing)
+`
+
+// ─── src/proxy.ts ─────────────────────────────────────────────────────────────
+export const proxyTs = (opts) => {
+  const lines = []
+  if (opts.i18n)  lines.push(`import createMiddleware from 'next-intl/middleware'`)
+  if (opts.i18n)  lines.push(`import { routing } from './i18n/routing'`)
+  lines.push(`import { ContextualProxy, withProxyChain } from './lib/proxy'`)
+  if (opts.auth)  lines.push(`import { authProxy } from './lib/proxy/auth'`)
+
+  const args = []
+  if (opts.i18n) args.push('createMiddleware(routing) as unknown as ContextualProxy')
+  if (opts.auth) args.push('authProxy')
+
+  lines.push('')
+  lines.push(`export default withProxyChain(${args.join(', ')})`)
+  lines.push('')
+  lines.push(`export const config = {`)
+  lines.push(`  matcher: '/((?!api|trpc|_next|_vercel|.*\\\\..*).*)',`)
+  lines.push(`}`)
+  return lines.join('\n') + '\n'
+}
+
+// ─── src/lib/proxy/index.ts ───────────────────────────────────────────────────
+export const proxyLibTs = `import {
+  NextFetchEvent,
+  NextRequest,
+  NextResponse,
+} from 'next/server'
+
+// TODO: import UserRole from your types once defined
+export interface ProxyContext {
+  role?: string
+}
+
+export type ContextualProxy = (
+  req: NextRequest,
+  event: NextFetchEvent,
+  ctx: ProxyContext,
+) => Promise<NextResponse | Response | undefined>
+
+export function withProxyChain(...proxies: ContextualProxy[]) {
+  return async (req: NextRequest, event: NextFetchEvent) => {
+    const ctx: ProxyContext = {}
+    let response: NextResponse | Response = NextResponse.next()
+
+    for (const proxy of proxies) {
+      const result = await proxy(req, event, ctx)
+      if (result) {
+        response = result
+        if (
+          result instanceof NextResponse &&
+          result.status >= 300 &&
+          result.status < 400
+        ) {
+          return response
+        }
+      }
+    }
+    return response
+  }
+}
+`
+
+// ─── src/lib/proxy/auth.ts ────────────────────────────────────────────────────
+export const proxyAuthTs = `import { NextFetchEvent, NextRequest, NextResponse } from 'next/server'
+import type { ContextualProxy, ProxyContext } from '.'
+
+export const authProxy: ContextualProxy = async (
+  req: NextRequest,
+  _event: NextFetchEvent,
+  ctx: ProxyContext,
+) => {
+  // TODO: implement auth checks — verify session/token, set ctx.role, redirect if needed
+  return NextResponse.next()
+}
+`
+
+// ─── src/lib/validators/index.ts ─────────────────────────────────────────────
+export const validatorsTs = `import * as z from 'zod'
+import { normalizeEmail, sanitizeName } from '../utils'
+
+const StrongPasswordRegex =
+  /^(?=.*[a-z])(?=.*[A-Z])(?=.*\\d)(?=.*[^A-Za-z0-9]).{8,}$/
+const OTPRegex = /^[a-zA-Z0-9]{6}$/
+
+const StringValidator = z.string()
+const EmailValidator = z
+  .string()
+  .email({ message: 'Invalid email' })
+  .transform((val) => normalizeEmail(val))
+const NumberValidator = z.coerce.number()
+const BooleanValidator = z.boolean().default(false)
+const PasswordValidator = StringValidator.regex(StrongPasswordRegex, 'Password too weak')
+const DateValidator = z.date()
+const NameValidator = StringValidator.min(2, 'Name is required').transform(
+  (name) => sanitizeName(name),
+)
+const OTPValidator = StringValidator.regex(OTPRegex, 'Invalid OTP')
+const IntValidator = NumberValidator.int()
+const AgeValidator = IntValidator.min(0, 'Invalid age').max(150, 'Invalid age')
+const FileValidator = z.instanceof(File)
+
+export {
+  AgeValidator,
+  BooleanValidator,
+  DateValidator,
+  EmailValidator,
+  FileValidator,
+  IntValidator,
+  NameValidator,
+  NumberValidator,
+  OTPValidator,
+  PasswordValidator,
+  StringValidator,
+}
+export default z
+`
+
+// ─── src/lib/validators/auth.ts ───────────────────────────────────────────────
+export const validatorsAuthTs = `// TODO: Define your auth-specific validators here
+import z from '.'
+import { EmailValidator, PasswordValidator, NameValidator } from '.'
+
+export const LoginSchema = z.object({
+  email: EmailValidator,
+  password: PasswordValidator,
+})
+
+export const RegisterSchema = z.object({
+  name: NameValidator,
+  email: EmailValidator,
+  password: PasswordValidator,
+})
+
+export type LoginInput = z.infer<typeof LoginSchema>
+export type RegisterInput = z.infer<typeof RegisterSchema>
+`
+
+// ─── src/lib/utils/locale-date-formats.ts ────────────────────────────────────
+export const localeDateFormatsTs = `import type { Formats } from 'next-intl'
+
+export const localeFormats = {
+  dateTime: {},
+  number: {
+    precise: { maximumFractionDigits: 5 },
+    decimal: { style: 'decimal', minimumFractionDigits: 2, maximumFractionDigits: 2 },
+    percent: { style: 'percent', minimumFractionDigits: 0, maximumFractionDigits: 1 },
+    currency: { style: 'currency', currency: 'USD', minimumFractionDigits: 2 },
+    compact: { notation: 'compact', maximumFractionDigits: 1 },
+  },
+  list: {
+    enumeration: { style: 'long', type: 'conjunction' },
+    disjunction: { style: 'long', type: 'disjunction' },
+    unit: { style: 'narrow', type: 'unit' },
+  },
+} satisfies Formats
+`
+
+// ─── next-intl.ts ─────────────────────────────────────────────────────────────
+export const nextIntlTs = `import { localeFormats } from './src/lib/utils/locale-date-formats'
+import { routing } from './src/i18n/routing'
+import locales from './locales/en.json'
+
+declare module 'next-intl' {
+  interface AppConfig {
+    Locale: (typeof routing.locales)[number]
+    Messages: typeof locales
+    Formats: typeof localeFormats
+  }
+}
+`
+
+// ─── locales/en.json ──────────────────────────────────────────────────────────
+export const localesEnJson = `{
+  "Locale": {
+    "en": "English"
+  },
+  "Form": {
+    "Validators": {}
+  }
+}
+`
+
+// ─── src/app/[locale]/page.tsx ────────────────────────────────────────────────
+export const localPageTsx = `// TODO: This is the localized home page entry point.
+// Import and render your home page content here.
+// You have access to locale via: import { useLocale } from 'next-intl'
+// And to translations via: import { useTranslations } from 'next-intl'
+
+export default function LocalePage() {
+  return (
+    <main>
+      {/* TODO: Add your localized page content */}
+    </main>
+  )
+}
+`
+
+// ─── src/lib/axios/axios.client.ts ────────────────────────────────────────────
+export const axiosClientTs = `// TODO: configure your client-side axios instance
+import axios from 'axios'
+import { SITE_URL } from '~/constants'
+
+const client = axios.create({
+  baseURL: SITE_URL,
+  withCredentials: true,
+})
+
+export default client
+`
+
+// ─── src/lib/axios/axios.server.ts ───────────────────────────────────────────
+export const axiosServerTs = `// TODO: configure your server-side axios instance
+import axios from 'axios'
+import { SITE_URL } from '~/constants'
+
+const server = axios.create({
+  baseURL: SITE_URL,
+})
+
+export default server
+`
+
+// ─── src/apis/client/index.ts ────────────────────────────────────────────────
+export const apisClientTs = `// TODO: add your client-side API functions here
+`
+
+// ─── src/apis/server/index.ts ────────────────────────────────────────────────
+export const apisServerTs = `// TODO: add your server-side API functions here
+`
+
+// ─── src/app/layout.tsx (i18n — passthrough shell) ───────────────────────────
+export const rootLayoutI18nTs = `
+
+export default ({ children }: LayoutProps<'/'>) => children
+`
+
+// ─── src/app/[locale]/layout.tsx ─────────────────────────────────────────────
+export const localeLayoutTs = `import Providers from '../../components/providers'
+import seo from '../../lib/seo'
+import '../globals.css'
+import { hasLocale } from 'next-intl'
+import { notFound } from 'next/navigation'
+import { routing } from '../../i18n/routing'
+import { APP_LOCALES, type AppLocale } from '../../constants'
+import { setRequestLocale } from 'next-intl/server'
+import type { Metadata } from 'next'
+import { PoppinsFont } from '../../lib/fonts'
+
+export const generateStaticParams = () =>
+  APP_LOCALES.map((locale) => ({ locale }))
+
+export const generateMetadata = async ({
+  params,
+}: LayoutProps<'/[locale]'>): Promise<Metadata> => {
+  const locale = (await params).locale as AppLocale
+  return seo[locale]
+}
+
+export default async function RootLayout({
+  params,
+  children,
+}: LayoutProps<'/[locale]'>) {
+  const { locale } = await params
+  if (!hasLocale(routing.locales, locale)) {
+    notFound()
+  }
+
+  setRequestLocale(locale)
+
+  return (
+    <html
+      lang={locale}
+      className="scroll-smooth"
+      suppressHydrationWarning
+      data-scroll-behavior="smooth"
+    >
+      <body className={\`antialiased \${PoppinsFont.className}\`}>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  )
+}
+`
+
+// ─── src/app/layout.tsx (no i18n — standard root layout) ─────────────────────
+export const rootLayoutTs = `import Providers from '../components/providers'
+import { PoppinsFont } from '../lib/fonts'
+import './globals.css'
+import type { Metadata } from 'next'
+import seo from '../lib/seo'
+
+export const metadata: Metadata = seo
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en" className="scroll-smooth" suppressHydrationWarning>
+      <body className={\`antialiased \${PoppinsFont.className}\`}>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  )
+}
+`
+
+// ─── eslint.config.mjs ────────────────────────────────────────────────────────
+export const eslintConfigMjs = (opts) => `import { defineConfig, globalIgnores } from 'eslint/config'
+import nextVitals from 'eslint-config-next/core-web-vitals'
+import nextTs from 'eslint-config-next/typescript'
+${opts.query ? `import tanstackPluginQuery from '@tanstack/eslint-plugin-query'` : ''}
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  ${opts.query ? `...tanstackPluginQuery.configs['flat/recommended'],` : ''}
+  globalIgnores(['.next/**', 'out/**', 'build/**', 'next-env.d.ts']),
+  {
+    rules: {
+      '@next/next/no-html-link-for-pages': ['error'],
+      'react/display-name': 'off',
+      'import/no-anonymous-default-export': [
+        'error',
+        {
+          allowArray: true,
+          allowArrowFunction: true,
+          allowObject: true,
+        },
+      ],
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          args: 'all',
+          caughtErrors: 'all',
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+          caughtErrorsIgnorePattern: '^_',
+          destructuredArrayIgnorePattern: '^_',
+        },
+      ],
+    },
+  },
+])
+
+export default eslintConfig
+`
+
+// ─── src/app/sitemap.ts ───────────────────────────────────────────────────────
+export const sitemapTs = `import type { MetadataRoute } from 'next'
+import { SITE_URL } from '../constants'
+
+export default function sitemap(): MetadataRoute.Sitemap {
+  return [
+    {
+      url: SITE_URL,
+      lastModified: new Date(),
+      changeFrequency: 'weekly',
+      priority: 1,
+    },
+  ]
+}
+`
+// ─── next.config.ts (i18n) ────────────────────────────────────────────────────
+export const nextConfigI18nTs = (opts) => `import { NextConfig } from 'next'
+import createNextIntlPlugin from 'next-intl/plugin'
+ 
+const nextConfig: NextConfig = {${opts.reactCompiler ? `
+  reactCompiler: true,` : ''}
+}
+ 
+const withNextIntl = createNextIntlPlugin()
+export default withNextIntl(nextConfig)
+`