create-reactivite 1.0.4 → 1.2.0

package/template2/README.md

@@ -0,0 +1,73 @@
+# Nextivite
+
+Next.js 16 (App Router) boilerplate scaffolded by **create-reactivite**.
+
+## Stack
+
+- **Next.js 16** + React 19 (App Router, `output: "standalone"`)
+- **Tailwind CSS v4** (`@tailwindcss/postcss`, config-less) + shadcn/ui (new-york)
+- **i18n** — `app/[locale]` routing with a lightweight `TranslationProvider` + `locales/*.json`
+- **TanStack Query** (+ Devtools) via `hoc/provider.tsx`
+- **axios** httpClient with interceptors + **orval** for type-safe API hooks
+- **Zustand** stores (`store/`)
+- **react-hook-form** + **zod** forms
+- **Vitest** + **MSW** + Testing Library
+- **husky** pre-commit (lint + format + tests), **prettier**, **eslint-config-next**
+
+## Getting started
+
+```bash
+pnpm install      # or npm install
+pnpm dev          # http://localhost:3000  → redirects to /az
+```
+
+## Structure
+
+```
+app/
+  layout.tsx              # root passthrough
+  page.tsx                # redirects to /{DEFAULT_LOCALE}
+  globals.css             # Tailwind v4 theme tokens
+  api/clear-session/      # cookie-clearing route
+  [locale]/
+    layout.tsx            # html/body shell + all providers
+    locales.ts            # server-only dictionary loader
+    page.tsx              # Home
+    (public)/login/       # login (react-hook-form + zod)
+    (private)/dashboard/  # guarded page
+components/
+  ui/                     # shadcn/ui components
+  theme-provider.tsx
+  AuthEventListener.tsx
+config/                   # env + constants (LOCALES, timeouts)
+contexts/                 # translation-context
+hoc/                      # QueryProvider
+lib/                      # utils, paramsSerializer
+services/
+  httpClient/             # axios instance + orval mutator
+  generated/              # orval output (git-ignored content)
+store/                    # zustand stores
+locales/                  # az.json, en.json
+testing/msw/              # mock server + handlers
+__tests__/                # vitest specs
+```
+
+## API codegen (orval)
+
+1. Point `orval.config.ts` `input.target` at your OpenAPI schema (or set `OPENAPI_TARGET`).
+2. `pnpm generate:api` → writes react-query hooks + models to `services/generated/`.
+
+## Scripts
+
+- `pnpm dev` / `pnpm build` / `pnpm start`
+- `pnpm lint` / `pnpm format`
+- `pnpm test` / `pnpm test:run`
+- `pnpm generate` / `pnpm generate:api`
+
+## Adding components
+
+```bash
+npx shadcn@latest add <name>
+```
+
+`components.json` points `css` at `app/globals.css`.

package/template2/__tests__/example.test.ts

@@ -0,0 +1,20 @@
+import { describe, it, expect } from 'vitest';
+import { paramsSerializer } from '@/lib/paramsSerializer';
+
+describe('paramsSerializer', () => {
+  it('flattens nested objects', () => {
+    expect(paramsSerializer({ pageable: { page: 0, size: 10 } })).toBe(
+      'page=0&size=10',
+    );
+  });
+
+  it('repeats array values', () => {
+    expect(paramsSerializer({ sort: ['name,asc', 'id,desc'] })).toBe(
+      'sort=name%2Casc&sort=id%2Cdesc',
+    );
+  });
+
+  it('omits null and undefined', () => {
+    expect(paramsSerializer({ a: 1, b: null, c: undefined })).toBe('a=1');
+  });
+});

package/template2/_gitignore

@@ -0,0 +1,37 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

package/template2/app/[locale]/(private)/dashboard/page.tsx

@@ -0,0 +1,52 @@
+'use client';
+
+import { useEffect } from 'react';
+import { useRouter, useParams } from 'next/navigation';
+import { Button } from '@/components/ui/button';
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { useTranslations } from '@/contexts/translation-context';
+import { useUserStore } from '@/store/user-store';
+
+export default function DashboardPage() {
+  const t = useTranslations('dashboard');
+  const router = useRouter();
+  const { locale } = useParams<{ locale: string }>();
+  const user = useUserStore((s) => s.user);
+  const clearUser = useUserStore((s) => s.clearUser);
+
+  // Client-side guard. For a real app prefer a server check via cookies.
+  useEffect(() => {
+    if (!user) router.replace(`/${locale}/login`);
+  }, [user, router, locale]);
+
+  if (!user) return null;
+
+  const logout = () => {
+    clearUser();
+    router.replace(`/${locale}/login`);
+  };
+
+  return (
+    <main className="flex min-h-screen items-center justify-center p-6">
+      <Card className="w-full max-w-xl">
+        <CardHeader>
+          <CardTitle>{t('title')}</CardTitle>
+          <CardDescription>
+            {t('welcome')}, {user.email}
+          </CardDescription>
+        </CardHeader>
+        <CardContent>
+          <Button variant="outline" onClick={logout}>
+            {t('logout')}
+          </Button>
+        </CardContent>
+      </Card>
+    </main>
+  );
+}

package/template2/app/[locale]/(public)/login/page.tsx

@@ -0,0 +1,83 @@
+'use client';
+
+import { useForm } from 'react-hook-form';
+import { zodResolver } from '@hookform/resolvers/zod';
+import { z } from 'zod';
+import { useRouter, useParams } from 'next/navigation';
+import { toast } from 'sonner';
+import { Button } from '@/components/ui/button';
+import { Input } from '@/components/ui/input';
+import { Label } from '@/components/ui/label';
+import {
+  Card,
+  CardContent,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { useTranslations } from '@/contexts/translation-context';
+import { useUserStore } from '@/store/user-store';
+
+const schema = z.object({
+  email: z.string().email(),
+  password: z.string().min(6),
+});
+
+type FormValues = z.infer<typeof schema>;
+
+export default function LoginPage() {
+  const t = useTranslations('login');
+  const router = useRouter();
+  const { locale } = useParams<{ locale: string }>();
+  const setUser = useUserStore((s) => s.setUser);
+
+  const {
+    register,
+    handleSubmit,
+    formState: { errors, isSubmitting },
+  } = useForm<FormValues>({ resolver: zodResolver(schema) });
+
+  // Demo only: replace with a real orval-generated mutation.
+  const onSubmit = async (values: FormValues) => {
+    setUser({ id: 'demo', email: values.email });
+    toast.success(t('success'));
+    router.push(`/${locale}/dashboard`);
+  };
+
+  return (
+    <main className="flex min-h-screen items-center justify-center p-6">
+      <Card className="w-full max-w-sm">
+        <CardHeader>
+          <CardTitle>{t('title')}</CardTitle>
+        </CardHeader>
+        <CardContent>
+          <form
+            onSubmit={handleSubmit(onSubmit)}
+            className="flex flex-col gap-4"
+          >
+            <div className="flex flex-col gap-2">
+              <Label htmlFor="email">{t('email')}</Label>
+              <Input id="email" type="email" {...register('email')} />
+              {errors.email && (
+                <p className="text-destructive text-sm">
+                  {errors.email.message}
+                </p>
+              )}
+            </div>
+            <div className="flex flex-col gap-2">
+              <Label htmlFor="password">{t('password')}</Label>
+              <Input id="password" type="password" {...register('password')} />
+              {errors.password && (
+                <p className="text-destructive text-sm">
+                  {errors.password.message}
+                </p>
+              )}
+            </div>
+            <Button type="submit" disabled={isSubmitting}>
+              {t('submit')}
+            </Button>
+          </form>
+        </CardContent>
+      </Card>
+    </main>
+  );
+}

package/template2/app/[locale]/layout.tsx

@@ -0,0 +1,56 @@
+import type React from 'react';
+import type { Metadata } from 'next';
+import { Geist } from 'next/font/google';
+import { Suspense } from 'react';
+import { notFound } from 'next/navigation';
+import '../globals.css';
+import { ThemeProvider } from '@/components/theme-provider';
+import { TranslationProvider } from '@/contexts/translation-context';
+import { Toaster } from '@/components/ui/sonner';
+import { QueryProvider } from '@/hoc/provider';
+import { AuthEventListener } from '@/components/AuthEventListener';
+import { LOCALES, type Locale } from '@/config/constants';
+import { getDictionary } from './locales';
+
+const geist = Geist({ subsets: ['latin'] });
+
+export const metadata: Metadata = {
+  title: 'Nextivite',
+  description: 'Next.js boilerplate scaffolded by create-reactivite.',
+};
+
+export function generateStaticParams() {
+  return LOCALES.map((locale) => ({ locale }));
+}
+
+export default async function LocaleLayout({
+  children,
+  params,
+}: Readonly<{
+  children: React.ReactNode;
+  params: Promise<{ locale: string }>;
+}>) {
+  const { locale } = await params;
+
+  if (!LOCALES.includes(locale as Locale)) {
+    notFound();
+  }
+
+  const messages = await getDictionary(locale as Locale);
+
+  return (
+    <html lang={locale} suppressHydrationWarning>
+      <body className={`${geist.className} font-sans antialiased`}>
+        <QueryProvider>
+          <ThemeProvider defaultMode="light" storageKey="app-theme">
+            <TranslationProvider locale={locale} messages={messages}>
+              <AuthEventListener />
+              <Suspense fallback={null}>{children}</Suspense>
+            </TranslationProvider>
+            <Toaster />
+          </ThemeProvider>
+        </QueryProvider>
+      </body>
+    </html>
+  );
+}

package/template2/app/[locale]/locales.ts

@@ -0,0 +1,10 @@
+import 'server-only';
+import type { Locale } from '@/config/constants';
+
+const locales = {
+  az: () => import('../../locales/az.json').then((m) => m.default),
+  en: () => import('../../locales/en.json').then((m) => m.default),
+};
+
+export const getDictionary = async (locale: Locale) =>
+  locales[locale]?.() ?? locales.az();

package/template2/app/[locale]/page.tsx

@@ -0,0 +1,38 @@
+import Link from 'next/link';
+import { Button } from '@/components/ui/button';
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card';
+import { getDictionary } from './locales';
+import type { Locale } from '@/config/constants';
+
+export default async function HomePage({
+  params,
+}: Readonly<{ params: Promise<{ locale: Locale }> }>) {
+  const { locale } = await params;
+  const dict = await getDictionary(locale);
+  const t = dict.home;
+
+  return (
+    <main className="flex min-h-screen items-center justify-center p-6">
+      <Card className="w-full max-w-xl">
+        <CardHeader>
+          <CardTitle className="text-2xl">{t.title}</CardTitle>
+          <CardDescription>{t.subtitle}</CardDescription>
+        </CardHeader>
+        <CardContent className="flex flex-wrap gap-3">
+          <Button asChild>
+            <Link href={`/${locale}/login`}>{t.login}</Link>
+          </Button>
+          <Button asChild variant="outline">
+            <Link href={`/${locale}/dashboard`}>{t.dashboard}</Link>
+          </Button>
+        </CardContent>
+      </Card>
+    </main>
+  );
+}

package/template2/app/api/clear-session/route.ts

@@ -0,0 +1,10 @@
+import { NextResponse } from 'next/server';
+
+// Clears the auth cookie(s) when the backend logout call fails or is skipped.
+// Add the cookie names your backend sets.
+export async function POST() {
+  const res = NextResponse.json({ ok: true });
+  res.cookies.delete('access_token');
+  res.cookies.delete('refresh_token');
+  return res;
+}

package/template2/app/globals.css

@@ -0,0 +1,127 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+@custom-variant dark (&:is(.dark *));
+
+:root,
+.default {
+  --background: oklch(0.99 0 0);
+  --foreground: oklch(0.15 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.15 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.15 0 0);
+  --primary: oklch(0.55 0.18 250);
+  --primary-foreground: oklch(0.99 0 0);
+  --secondary: oklch(0.96 0 0);
+  --secondary-foreground: oklch(0.15 0 0);
+  --muted: oklch(0.96 0.01 250);
+  --muted-foreground: oklch(0.5 0 0);
+  --accent: oklch(0.65 0.2 30);
+  --accent-foreground: oklch(0.99 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --destructive-foreground: oklch(0.99 0 0);
+  --border: oklch(0.9 0 0);
+  --input: oklch(0.9 0 0);
+  --ring: oklch(0.55 0.18 250);
+  --chart-1: oklch(0.55 0.18 250);
+  --chart-2: oklch(0.65 0.2 30);
+  --chart-3: oklch(0.6 0.15 180);
+  --chart-4: oklch(0.7 0.18 320);
+  --chart-5: oklch(0.65 0.16 140);
+  --radius: 0.75rem;
+  --sidebar: oklch(0.99 0 0);
+  --sidebar-foreground: oklch(0.15 0 0);
+  --sidebar-primary: oklch(0.55 0.18 250);
+  --sidebar-primary-foreground: oklch(0.99 0 0);
+  --sidebar-accent: oklch(0.96 0 0);
+  --sidebar-accent-foreground: oklch(0.15 0 0);
+  --sidebar-border: oklch(0.9 0 0);
+  --sidebar-ring: oklch(0.55 0.18 250);
+}
+
+.dark {
+  --background: oklch(0.12 0 0);
+  --foreground: oklch(0.98 0 0);
+  --card: oklch(0.15 0 0);
+  --card-foreground: oklch(0.98 0 0);
+  --popover: oklch(0.15 0 0);
+  --popover-foreground: oklch(0.98 0 0);
+  --primary: oklch(0.65 0.2 250);
+  --primary-foreground: oklch(0.12 0 0);
+  --secondary: oklch(0.2 0 0);
+  --secondary-foreground: oklch(0.98 0 0);
+  --muted: oklch(0.2 0.01 250);
+  --muted-foreground: oklch(0.6 0 0);
+  --accent: oklch(0.7 0.22 30);
+  --accent-foreground: oklch(0.12 0 0);
+  --destructive: oklch(0.5 0.2 27);
+  --destructive-foreground: oklch(0.98 0 0);
+  --border: oklch(0.25 0 0);
+  --input: oklch(0.25 0 0);
+  --ring: oklch(0.65 0.2 250);
+  --chart-1: oklch(0.65 0.2 250);
+  --chart-2: oklch(0.7 0.22 30);
+  --chart-3: oklch(0.6 0.15 180);
+  --chart-4: oklch(0.7 0.18 320);
+  --chart-5: oklch(0.65 0.16 140);
+  --sidebar: oklch(0.15 0 0);
+  --sidebar-foreground: oklch(0.98 0 0);
+  --sidebar-primary: oklch(0.65 0.2 250);
+  --sidebar-primary-foreground: oklch(0.12 0 0);
+  --sidebar-accent: oklch(0.2 0 0);
+  --sidebar-accent-foreground: oklch(0.98 0 0);
+  --sidebar-border: oklch(0.25 0 0);
+  --sidebar-ring: oklch(0.65 0.2 250);
+}
+
+@theme inline {
+  --font-sans: "Geist", "Geist Fallback";
+  --font-mono: "Geist Mono", "Geist Mono Fallback";
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --color-chart-1: var(--chart-1);
+  --color-chart-2: var(--chart-2);
+  --color-chart-3: var(--chart-3);
+  --color-chart-4: var(--chart-4);
+  --color-chart-5: var(--chart-5);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --color-sidebar: var(--sidebar);
+  --color-sidebar-foreground: var(--sidebar-foreground);
+  --color-sidebar-primary: var(--sidebar-primary);
+  --color-sidebar-primary-foreground: var(--sidebar-primary-foreground);
+  --color-sidebar-accent: var(--sidebar-accent);
+  --color-sidebar-accent-foreground: var(--sidebar-accent-foreground);
+  --color-sidebar-border: var(--sidebar-border);
+  --color-sidebar-ring: var(--sidebar-ring);
+}
+
+@layer base {
+  * {
+    @apply border-border outline-ring/50;
+  }
+
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/template2/app/layout.tsx

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+
+// Root layout is a passthrough — the real <html>/<body> shell lives in
+// app/[locale]/layout.tsx so every page is locale-scoped.
+export default function RootLayout({ children }: { children: ReactNode }) {
+  return children;
+}

package/template2/app/page.tsx

@@ -0,0 +1,6 @@
+import { redirect } from 'next/navigation';
+import { DEFAULT_LOCALE } from '@/config/constants';
+
+export default function RootPage() {
+  redirect(`/${DEFAULT_LOCALE}`);
+}

package/template2/components/AuthEventListener.tsx

@@ -0,0 +1,22 @@
+'use client';
+
+import { useEffect } from 'react';
+import { usePathname } from 'next/navigation';
+
+// Listens for the `auth:unauthorized` event dispatched by the axios interceptor
+// (see services/httpClient/httpClient.ts) and bounces the user to /login.
+export function AuthEventListener() {
+  const pathname = usePathname();
+
+  useEffect(() => {
+    const locale = pathname.split('/')[1] || 'az';
+    const handler = async () => {
+      await fetch('/api/clear-session', { method: 'POST' }).catch(() => {});
+      window.location.href = `/${locale}/login`;
+    };
+    window.addEventListener('auth:unauthorized', handler);
+    return () => window.removeEventListener('auth:unauthorized', handler);
+  }, [pathname]);
+
+  return null;
+}

package/template2/components/theme-provider.tsx

@@ -0,0 +1,78 @@
+"use client";
+
+import * as React from "react";
+
+type Mode = "dark" | "light";
+
+type ThemeProviderProps = {
+  children: React.ReactNode;
+  defaultMode?: Mode;
+  storageKey?: string;
+};
+
+type ThemeProviderState = {
+  mode: Mode;
+  setMode: (mode: Mode) => void;
+  toggleMode: () => void;
+};
+
+const initialState: ThemeProviderState = {
+  mode: "light",
+  setMode: () => null,
+  toggleMode: () => null,
+};
+
+const ThemeProviderContext =
+  React.createContext<ThemeProviderState>(initialState);
+
+export function ThemeProvider({
+  children,
+  defaultMode = "light",
+  storageKey = "app-theme",
+  ...props
+}: Readonly<ThemeProviderProps>) {
+  const [mode, setModeState] = React.useState<Mode>(() => {
+    if (typeof window !== "undefined") {
+      return (localStorage.getItem(`${storageKey}-mode`) as Mode) || defaultMode;
+    }
+    return defaultMode;
+  });
+
+  React.useEffect(() => {
+    const root = window.document.documentElement;
+    root.classList.remove("light", "dark");
+    root.classList.add(mode);
+  }, [mode]);
+
+  const setMode = React.useCallback(
+    (next: Mode) => {
+      localStorage.setItem(`${storageKey}-mode`, next);
+      setModeState(next);
+    },
+    [storageKey],
+  );
+
+  const value = React.useMemo<ThemeProviderState>(
+    () => ({
+      mode,
+      setMode,
+      toggleMode: () => setMode(mode === "dark" ? "light" : "dark"),
+    }),
+    [mode, setMode],
+  );
+
+  return (
+    <ThemeProviderContext.Provider {...props} value={value}>
+      {children}
+    </ThemeProviderContext.Provider>
+  );
+}
+
+export const useTheme = () => {
+  const context = React.useContext(ThemeProviderContext);
+
+  if (context === undefined)
+    throw new Error("useTheme must be used within a ThemeProvider");
+
+  return context;
+};