create-reactivite 1.1.0 → 1.3.0

package/template2/components/ui/button.tsx

@@ -0,0 +1,60 @@
+import * as React from "react"
+import { Slot } from "@radix-ui/react-slot"
+import { cva, type VariantProps } from "class-variance-authority"
+
+import { cn } from "@/lib/utils"
+
+const buttonVariants = cva(
+  "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+  {
+    variants: {
+      variant: {
+        default: "bg-primary text-primary-foreground hover:bg-primary/90",
+        destructive:
+          "bg-destructive text-white hover:bg-destructive/90 focus-visible:ring-destructive/20 dark:focus-visible:ring-destructive/40 dark:bg-destructive/60",
+        outline:
+          "border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50",
+        secondary:
+          "bg-secondary text-secondary-foreground hover:bg-secondary/80",
+        ghost:
+          "hover:bg-accent hover:text-accent-foreground dark:hover:bg-accent/50",
+        link: "text-primary underline-offset-4 hover:underline",
+      },
+      size: {
+        default: "h-9 px-4 py-2 has-[>svg]:px-3",
+        sm: "h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5",
+        lg: "h-10 rounded-md px-6 has-[>svg]:px-4",
+        icon: "size-9",
+        "icon-sm": "size-8",
+        "icon-lg": "size-10",
+      },
+    },
+    defaultVariants: {
+      variant: "default",
+      size: "default",
+    },
+  }
+)
+
+function Button({
+  className,
+  variant,
+  size,
+  asChild = false,
+  ...props
+}: React.ComponentProps<"button"> &
+  VariantProps<typeof buttonVariants> & {
+    asChild?: boolean
+  }) {
+  const Comp = asChild ? Slot : "button"
+
+  return (
+    <Comp
+      data-slot="button"
+      className={cn(buttonVariants({ variant, size, className }))}
+      {...props}
+    />
+  )
+}
+
+export { Button, buttonVariants }

package/template2/components/ui/card.tsx

@@ -0,0 +1,92 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Card({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card"
+      className={cn(
+        "bg-card text-card-foreground flex flex-col gap-6 rounded-xl border py-6 shadow-sm",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-header"
+      className={cn(
+        "@container/card-header grid auto-rows-min grid-rows-[auto_auto] items-start gap-2 px-6 has-data-[slot=card-action]:grid-cols-[1fr_auto] [.border-b]:pb-6",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-title"
+      className={cn("leading-none font-semibold", className)}
+      {...props}
+    />
+  )
+}
+
+function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-description"
+      className={cn("text-muted-foreground text-sm", className)}
+      {...props}
+    />
+  )
+}
+
+function CardAction({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-action"
+      className={cn(
+        "col-start-2 row-span-2 row-start-1 self-start justify-self-end",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function CardContent({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-content"
+      className={cn("px-6", className)}
+      {...props}
+    />
+  )
+}
+
+function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
+  return (
+    <div
+      data-slot="card-footer"
+      className={cn("flex items-center px-6 [.border-t]:pt-6", className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Card,
+  CardHeader,
+  CardFooter,
+  CardTitle,
+  CardAction,
+  CardDescription,
+  CardContent,
+}

package/template2/components/ui/input.tsx

@@ -0,0 +1,21 @@
+import * as React from "react"
+
+import { cn } from "@/lib/utils"
+
+function Input({ className, type, ...props }: React.ComponentProps<"input">) {
+  return (
+    <input
+      type={type}
+      data-slot="input"
+      className={cn(
+        "file:text-foreground placeholder:text-muted-foreground selection:bg-primary selection:text-primary-foreground dark:bg-input/30 border-input h-9 w-full min-w-0 rounded-md border bg-transparent px-3 py-1 text-base shadow-xs transition-[color,box-shadow] outline-none file:inline-flex file:h-7 file:border-0 file:bg-transparent file:text-sm file:font-medium disabled:pointer-events-none disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+        "focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px]",
+        "aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Input }

package/template2/components/ui/label.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+
+import { cn } from "@/lib/utils"
+
+function Label({
+  className,
+  ...props
+}: React.ComponentProps<typeof LabelPrimitive.Root>) {
+  return (
+    <LabelPrimitive.Root
+      data-slot="label"
+      className={cn(
+        "flex items-center gap-2 text-sm leading-none font-medium select-none group-data-[disabled=true]:pointer-events-none group-data-[disabled=true]:opacity-50 peer-disabled:cursor-not-allowed peer-disabled:opacity-50",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Label }

package/template2/components/ui/sonner.tsx

@@ -0,0 +1,40 @@
+"use client"
+
+import {
+  CircleCheckIcon,
+  InfoIcon,
+  Loader2Icon,
+  OctagonXIcon,
+  TriangleAlertIcon,
+} from "lucide-react"
+import { useTheme } from "next-themes"
+import { Toaster as Sonner, type ToasterProps } from "sonner"
+
+const Toaster = ({ ...props }: ToasterProps) => {
+  const { theme = "system" } = useTheme()
+
+  return (
+    <Sonner
+      theme={theme as ToasterProps["theme"]}
+      className="toaster group"
+      icons={{
+        success: <CircleCheckIcon className="size-4" />,
+        info: <InfoIcon className="size-4" />,
+        warning: <TriangleAlertIcon className="size-4" />,
+        error: <OctagonXIcon className="size-4" />,
+        loading: <Loader2Icon className="size-4 animate-spin" />,
+      }}
+      style={
+        {
+          "--normal-bg": "var(--popover)",
+          "--normal-text": "var(--popover-foreground)",
+          "--normal-border": "var(--border)",
+          "--border-radius": "var(--radius)",
+        } as React.CSSProperties
+      }
+      {...props}
+    />
+  )
+}
+
+export { Toaster }

package/template2/components.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "app/globals.css",
+    "baseColor": "slate",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/lib/hooks"
+  },
+  "registries": {}
+}

package/template2/config/constants.ts

@@ -0,0 +1,7 @@
+export const LOCALES = ['az', 'en'] as const;
+export type Locale = (typeof LOCALES)[number];
+export const DEFAULT_LOCALE: Locale = 'az';
+
+export const DEFAULT_PAGE_SIZE = 9;
+export const QUERY_STALE_TIME_TAGS = 5 * 60 * 1000;
+export const AXIOS_TIMEOUT_MS = 15000;

package/template2/config/env.ts

@@ -0,0 +1,5 @@
+export const env = {
+  apiBaseUrl: process.env.NEXT_PUBLIC_API_BASE_URL ?? '/api/backend',
+  apiBaseUrlServer: process.env.API_BASE_URL,
+  nodeEnv: process.env.NODE_ENV ?? 'development',
+} as const;

package/template2/contexts/translation-context.tsx

@@ -0,0 +1,70 @@
+'use client';
+
+import { createContext, useContext, ReactNode, useMemo } from 'react';
+
+type MessageValue = string | Record<string, string>;
+type Messages = Record<string, MessageValue>;
+
+interface TranslationContextType {
+  locale: string;
+  messages: Messages;
+}
+
+const TranslationContext = createContext<TranslationContextType | undefined>(
+  undefined,
+);
+
+interface TranslationProviderProps {
+  children: ReactNode;
+  locale: string;
+  messages: Messages;
+}
+
+export function TranslationProvider({
+  children,
+  locale,
+  messages,
+}: Readonly<TranslationProviderProps>) {
+  const value = useMemo(() => ({ locale, messages }), [locale, messages]);
+
+  return (
+    <TranslationContext.Provider value={value}>
+      {children}
+    </TranslationContext.Provider>
+  );
+}
+
+export function useTranslations(namespace?: string) {
+  const context = useContext(TranslationContext);
+
+  if (!context) {
+    throw new Error('useTranslations must be used within TranslationProvider');
+  }
+
+  return (key: string): string => {
+    const { messages } = context;
+
+    if (!namespace) {
+      const value = messages[key];
+      return typeof value === 'string' ? value : key;
+    }
+
+    const ns = messages[namespace];
+
+    if (!ns || typeof ns !== 'object') {
+      return key;
+    }
+
+    return ns[key] ?? key;
+  };
+}
+
+export function useLocale(): string {
+  const context = useContext(TranslationContext);
+
+  if (!context) {
+    throw new Error('useLocale must be used within TranslationProvider');
+  }
+
+  return context.locale;
+}

package/template2/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  globalIgnores([
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+    // Auto-generated by orval — do not lint
+    "services/generated/**",
+  ]),
+]);
+
+export default eslintConfig;

package/template2/hoc/provider.tsx

@@ -0,0 +1,27 @@
+'use client';
+
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
+import { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+import { useState } from 'react';
+
+export function QueryProvider({
+  children,
+}: Readonly<{ children: React.ReactNode }>) {
+  const [queryClient] = useState(
+    () =>
+      new QueryClient({
+        defaultOptions: {
+          queries: {
+            staleTime: 0,
+          },
+        },
+      }),
+  );
+
+  return (
+    <QueryClientProvider client={queryClient}>
+      {children}
+      <ReactQueryDevtools initialIsOpen={false} />
+    </QueryClientProvider>
+  );
+}

package/template2/lib/paramsSerializer.ts

@@ -0,0 +1,40 @@
+/**
+ * Flattens one level of nested objects before serializing to a query string.
+ * Useful when a backend (e.g. Spring Boot Pageable / @ModelAttribute) expects
+ * flat params (page=0&size=10) instead of Axios's default bracket notation
+ * (pageable[page]=0&pageable[size]=10).
+ *
+ * Arrays at any level are repeated: sort=name,asc&sort=id,desc
+ * null/undefined values are omitted.
+ */
+export const paramsSerializer = (params: Record<string, unknown>): string => {
+  const parts: string[] = [];
+  for (const [key, value] of Object.entries(params)) {
+    if (value === undefined || value === null) continue;
+    if (typeof value === 'object' && !Array.isArray(value)) {
+      for (const [k, v] of Object.entries(value as Record<string, unknown>)) {
+        if (v === undefined || v === null) continue;
+        if (Array.isArray(v)) {
+          for (const item of v)
+            parts.push(
+              `${encodeURIComponent(k)}=${encodeURIComponent(String(item))}`,
+            );
+        } else {
+          parts.push(
+            `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`,
+          );
+        }
+      }
+    } else if (Array.isArray(value)) {
+      for (const item of value)
+        parts.push(
+          `${encodeURIComponent(key)}=${encodeURIComponent(String(item))}`,
+        );
+    } else {
+      parts.push(
+        `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`,
+      );
+    }
+  }
+  return parts.join('&');
+};

package/template2/lib/utils.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/template2/locales/az.json

@@ -0,0 +1,20 @@
+{
+  "home": {
+    "title": "Nextivite-ə xoş gəlmisən",
+    "subtitle": "Next.js 16, Tailwind v4, TanStack Query, Zustand, orval və husky ilə hazır boilerplate.",
+    "login": "Daxil ol",
+    "dashboard": "Panelə keç"
+  },
+  "login": {
+    "title": "Daxil ol",
+    "email": "E-poçt",
+    "password": "Şifrə",
+    "submit": "Daxil ol",
+    "success": "Uğurla daxil oldun"
+  },
+  "dashboard": {
+    "title": "Panel",
+    "welcome": "Xoş gəldin",
+    "logout": "Çıxış"
+  }
+}

package/template2/locales/en.json

@@ -0,0 +1,20 @@
+{
+  "home": {
+    "title": "Welcome to Nextivite",
+    "subtitle": "A ready-to-go boilerplate with Next.js 16, Tailwind v4, TanStack Query, Zustand, orval and husky.",
+    "login": "Sign in",
+    "dashboard": "Go to dashboard"
+  },
+  "login": {
+    "title": "Sign in",
+    "email": "Email",
+    "password": "Password",
+    "submit": "Sign in",
+    "success": "Signed in successfully"
+  },
+  "dashboard": {
+    "title": "Dashboard",
+    "welcome": "Welcome",
+    "logout": "Log out"
+  }
+}

package/template2/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/template2/next.config.ts

@@ -0,0 +1,17 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  async rewrites() {
+    const backendUrl = process.env.API_BASE_URL;
+    if (!backendUrl) return [];
+    return [
+      {
+        source: "/api/backend/:path*",
+        destination: `${backendUrl}/:path*`,
+      },
+    ];
+  },
+  output: "standalone",
+};
+
+export default nextConfig;

package/template2/orval.config.ts

@@ -0,0 +1,66 @@
+import { defineConfig } from 'orval';
+
+const SKIP = new Set(['public', 'api', 'v1', 'v2', 'v3']);
+const VERB_PREFIX: Record<string, string> = {
+  get: 'get',
+  post: 'create',
+  put: 'update',
+  patch: 'patch',
+  delete: 'delete',
+};
+
+// Converts path + HTTP verb → semantic camelCase name.
+// GET /users/public/{id}/posts → getUsersByIdPosts
+// POST /public/auth/login      → createAuthLogin
+export function buildOperationName(
+  _operation: unknown,
+  route: string,
+  verb: string,
+): string {
+  const prefix = VERB_PREFIX[verb] ?? verb;
+  const parts = route
+    .replace(/\{([^}]+)\}/g, (_, p) =>
+      'By' + p.charAt(0).toUpperCase() + p.slice(1),
+    )
+    .split('/')
+    .filter((s) => s && !SKIP.has(s))
+    .map((s) =>
+      s
+        .charAt(0)
+        .toUpperCase()
+        .concat(s.slice(1))
+        .replace(/-([a-z])/g, (_, c) => c.toUpperCase()),
+    );
+
+  const deduped = parts.filter((p, i) => p !== parts[i - 1]);
+  return prefix + deduped.join('');
+}
+
+export default defineConfig({
+  api: {
+    input: {
+      // Replace with your OpenAPI/Swagger schema URL or local file path.
+      target: process.env.OPENAPI_TARGET ?? 'http://localhost:8080/v3/api-docs',
+    },
+    output: {
+      mode: 'tags-split',
+      target: 'services/generated',
+      schemas: 'services/generated/model',
+      client: 'react-query',
+      httpClient: 'axios',
+      baseUrl: process.env.NEXT_PUBLIC_API_BASE_URL,
+      override: {
+        operationName: buildOperationName,
+        mutator: {
+          path: 'services/httpClient/orvalMutator.ts',
+          name: 'customMutator',
+        },
+        query: {
+          useQuery: true,
+          useMutation: true,
+          signal: true,
+        },
+      },
+    },
+  },
+});

package/template2/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "nextivite-plate",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "dev:4000": "next dev -p 4000",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint",
+    "prepare": "husky",
+    "format": "prettier --write \"app/**/*.{js,ts,tsx}\"",
+    "format:services": "prettier --write \"services/**/*.{js,ts,tsx}\"",
+    "generate": "orval --config orval.config.ts",
+    "generate:api": "npm run generate && npm run format:services && node scripts/fix-generated-types.mjs",
+    "dev:full": "npm run generate:api && npm run dev",
+    "test": "vitest",
+    "test:run": "vitest run"
+  },
+  "dependencies": {
+    "@hookform/resolvers": "^5.2.2",
+    "@radix-ui/react-label": "^2.1.8",
+    "@radix-ui/react-slot": "^1.2.4",
+    "@tanstack/react-query": "^5.90.8",
+    "@tanstack/react-query-devtools": "^5.90.2",
+    "axios": "^1.13.2",
+    "class-variance-authority": "^0.7.1",
+    "clsx": "^2.1.1",
+    "lucide-react": "^0.548.0",
+    "next": "^16.2.2",
+    "next-themes": "^0.4.6",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "react-hook-form": "^7.66.0",
+    "sonner": "^2.0.7",
+    "tailwind-merge": "^3.3.1",
+    "zod": "^4.1.12",
+    "zustand": "^5.0.8"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitejs/plugin-react": "^6.0.2",
+    "eslint": "^9",
+    "eslint-config-next": "^16.2.2",
+    "eslint-config-prettier": "^10.1.8",
+    "figlet": "^1.9.3",
+    "husky": "^9.1.7",
+    "jsdom": "^29.1.1",
+    "msw": "^2.14.6",
+    "orval": "^8.12.3",
+    "prettier": "^3.6.2",
+    "tailwindcss": "^4",
+    "tw-animate-css": "^1.4.0",
+    "typescript": "5.9.3",
+    "vitest": "^4.1.7"
+  }
+}

package/template2/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/template2/scripts/fix-generated-types.mjs

@@ -0,0 +1,13 @@
+// Post-processing hook for orval output.
+// Runs after `npm run generate`. Add codemods here if your backend schema needs
+// tweaks the generator can't express. No-op when nothing is generated yet.
+import { existsSync } from 'node:fs';
+
+const GENERATED_DIR = new URL('../services/generated/', import.meta.url);
+
+if (!existsSync(GENERATED_DIR)) {
+  console.log('fix-generated-types: services/generated yox, keçildi.');
+  process.exit(0);
+}
+
+console.log('fix-generated-types: generated tipləri yoxlandı (no-op).');

package/template2/services/generated/.gitkeep

@@ -0,0 +1,2 @@
+# orval writes generated react-query hooks + models here.
+# Run `npm run generate:api` after pointing orval.config.ts at your schema.