@thinhnguyencth1204/nextcli 0.1.0

package/templates/next-base/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "db:generate": "prisma generate",
+    "db:migrate": "prisma migrate dev",
+    "db:studio": "prisma studio"
+  },
+  "dependencies": {
+    "@prisma/client": "^7.8.0",
+    "@tanstack/react-form": "^1.0.3",
+    "@tanstack/react-query": "^5.56.2",
+    "@tanstack/react-query-devtools": "^5.56.2",
+    "@tanstack/react-table": "^8.20.5",
+    "axios": "^1.7.7",
+    "better-auth": "^1.6.11",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.1",
+    "date-fns": "^3.6.0",
+    "next": "^16.1.6",
+    "next-intl": "^4.13.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sonner": "^1.7.1",
+    "tailwind-merge": "^2.5.3",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "dotenv": "^17.4.2",
+    "@types/node": "^22.7.4",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "eslint": "^9.11.1",
+    "eslint-config-next": "^16.1.6",
+    "prisma": "^7.8.0",
+    "tailwindcss": "^3.4.13",
+    "typescript": "^5.6.2"
+  }
+}

package/templates/next-base/prisma/migrations/.gitkeep

@@ -0,0 +1 @@
+

package/templates/next-base/prisma/schema.prisma

@@ -0,0 +1,72 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+}
+
+model User {
+  id            String    @id @default(cuid())
+  email         String    @unique
+  name          String?
+  image         String?
+  emailVerified Boolean   @default(false)
+  createdAt     DateTime  @default(now())
+  updatedAt     DateTime  @updatedAt
+  sessions      Session[]
+  accounts      Account[]
+}
+
+// Starter demo table for template onboarding only.
+// Rename/remove this `Example` model before production migration.
+// Keep this block under review to avoid creating unwanted prod tables.
+model Example {
+  id          String   @id @default(cuid())
+  name        String
+  description String?
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+}
+
+model Session {
+  id        String   @id @default(cuid())
+  token     String   @unique
+  expiresAt DateTime
+  ipAddress String?
+  userAgent String?
+  userId    String
+  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+}
+
+model Account {
+  id                    String    @id @default(cuid())
+  accountId             String
+  providerId            String
+  userId                String
+  user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+  accessToken           String?
+  refreshToken          String?
+  idToken               String?
+  accessTokenExpiresAt  DateTime?
+  refreshTokenExpiresAt DateTime?
+  scope                 String?
+  password              String?
+  createdAt             DateTime  @default(now())
+  updatedAt             DateTime  @updatedAt
+
+  @@unique([providerId, accountId])
+}
+
+model Verification {
+  id         String    @id @default(cuid())
+  identifier String
+  value      String
+  expiresAt  DateTime
+  createdAt  DateTime? @default(now())
+  updatedAt  DateTime? @updatedAt
+}
+// Optional Chatbox models are appended by NexTCLI only when adding the chat feature.
+// Review generated schema changes before running migrations on production databases.

package/templates/next-base/prisma.config.ts

@@ -0,0 +1,16 @@
+import "dotenv/config";
+import { defineConfig, env } from "prisma/config";
+
+type Env = {
+  DATABASE_URL: string;
+};
+
+export default defineConfig({
+  schema: "prisma/schema.prisma",
+  migrations: {
+    path: "prisma/migrations",
+  },
+  datasource: {
+    url: env<Env>("DATABASE_URL"),
+  },
+});

package/templates/next-base/src/app/(auth)/.gitkeep

@@ -0,0 +1 @@
+

package/templates/next-base/src/app/(auth)/sign-in/page.tsx

@@ -0,0 +1,11 @@
+import { SignInForm } from "@/features/auth/components/sign-in-form";
+
+export default function SignInPage() {
+  return (
+    <main style={{ padding: 24 }}>
+      <h1>Sign in</h1>
+      <p>Use your email and password to get access.</p>
+      <SignInForm />
+    </main>
+  );
+}

package/templates/next-base/src/app/(dashboard)/account/page.tsx

@@ -0,0 +1,14 @@
+import Link from "next/link";
+import { AccountPanel } from "@/features/auth/components/account-panel";
+
+export default function AccountPage() {
+  return (
+    <main style={{ padding: 24 }}>
+      <h1>Account</h1>
+      <AccountPanel />
+      <p style={{ marginTop: 16 }}>
+        <Link href="/sign-in">Go to sign in</Link>
+      </p>
+    </main>
+  );
+}

package/templates/next-base/src/app/(dashboard)/example/page.tsx

@@ -0,0 +1,10 @@
+import { ExampleTable } from "@/example/components/example-table";
+
+export default function ExamplePage() {
+  return (
+    <main style={{ padding: 24 }}>
+      <h1>Example</h1>
+      <ExampleTable />
+    </main>
+  );
+}

package/templates/next-base/src/app/api/auth/[...all]/route.ts

@@ -0,0 +1,4 @@
+import { toNextJsHandler } from "better-auth/next-js";
+import { auth } from "@/lib/auth";
+
+export const { GET, POST } = toNextJsHandler(auth);

package/templates/next-base/src/app/api/v1/auth/login/route.ts

@@ -0,0 +1,60 @@
+import { getRefreshCookieName, refreshCookieOptions } from "@/lib/auth-cookies";
+import { fail, ok } from "@/lib/api-response";
+
+const authBaseUrl =
+  process.env.BETTER_AUTH_URL ??
+  process.env.NEXT_PUBLIC_APP_URL ??
+  "http://localhost:3000";
+
+export async function POST(request: Request) {
+  const payload = (await request.json().catch(() => ({}))) as {
+    email?: string;
+    password?: string;
+  };
+
+  if (!payload.email || !payload.password) {
+    return fail("BAD_REQUEST", "Email and password are required.", { status: 400 });
+  }
+
+  const signInResponse = await fetch(`${authBaseUrl}/api/auth/sign-in/email`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      email: payload.email,
+      password: payload.password,
+    }),
+  });
+
+  if (!signInResponse.ok) {
+    return fail("UNAUTHORIZED", "Invalid credentials.", {
+      status: signInResponse.status,
+    });
+  }
+
+  const cookieHeader = signInResponse.headers.get("set-cookie");
+
+  const tokenResponse = await fetch(`${authBaseUrl}/api/auth/token`, {
+    method: "GET",
+    headers: cookieHeader ? { cookie: cookieHeader } : undefined,
+  });
+
+  if (!tokenResponse.ok) {
+    return fail("UPSTREAM_ERROR", "Unable to issue access token.", {
+      status: tokenResponse.status,
+    });
+  }
+
+  const tokenPayload = await tokenResponse.json();
+  const response = ok({
+    accessToken: tokenPayload.token,
+  });
+
+  if (cookieHeader) {
+    response.headers.set("set-cookie", cookieHeader);
+  }
+  response.cookies.set(getRefreshCookieName(), crypto.randomUUID(), refreshCookieOptions());
+
+  return response;
+}

package/templates/next-base/src/app/api/v1/auth/logout/route.ts

@@ -0,0 +1,28 @@
+import { getRefreshCookieName, refreshCookieOptions } from "@/lib/auth-cookies";
+import { fail, ok } from "@/lib/api-response";
+
+const authBaseUrl =
+  process.env.BETTER_AUTH_URL ??
+  process.env.NEXT_PUBLIC_APP_URL ??
+  "http://localhost:3000";
+
+export async function POST(request: Request) {
+  const incomingCookie = request.headers.get("cookie") ?? "";
+  const signOutResponse = await fetch(`${authBaseUrl}/api/auth/sign-out`, {
+    method: "POST",
+    headers: {
+      cookie: incomingCookie,
+    },
+  });
+
+  const response = signOutResponse.ok
+    ? ok({ loggedOut: true })
+    : fail("UPSTREAM_ERROR", "Failed to sign out.", {
+        status: signOutResponse.status,
+      });
+  response.cookies.set(getRefreshCookieName(), "", {
+    ...refreshCookieOptions(),
+    maxAge: 0,
+  });
+  return response;
+}

package/templates/next-base/src/app/api/v1/auth/me/route.ts

@@ -0,0 +1,26 @@
+import { fail, ok } from "@/lib/api-response";
+
+const authBaseUrl =
+  process.env.BETTER_AUTH_URL ??
+  process.env.NEXT_PUBLIC_APP_URL ??
+  "http://localhost:3000";
+
+export async function GET(request: Request) {
+  const incomingCookie = request.headers.get("cookie") ?? "";
+
+  const sessionResponse = await fetch(`${authBaseUrl}/api/auth/get-session`, {
+    method: "GET",
+    headers: {
+      cookie: incomingCookie,
+    },
+  });
+
+  if (!sessionResponse.ok) {
+    return fail("UNAUTHORIZED", "Unauthorized", {
+      status: sessionResponse.status,
+    });
+  }
+
+  const payload = await sessionResponse.json();
+  return ok(payload);
+}

package/templates/next-base/src/app/api/v1/auth/refresh/route.ts

@@ -0,0 +1,32 @@
+import { getRefreshCookieName } from "@/lib/auth-cookies";
+import { fail, ok } from "@/lib/api-response";
+
+const authBaseUrl =
+  process.env.BETTER_AUTH_URL ??
+  process.env.NEXT_PUBLIC_APP_URL ??
+  "http://localhost:3000";
+
+export async function POST(request: Request) {
+  const incomingCookie = request.headers.get("cookie") ?? "";
+  if (!incomingCookie.includes(getRefreshCookieName())) {
+    return fail("UNAUTHORIZED", "Refresh cookie is missing.", { status: 401 });
+  }
+
+  const tokenResponse = await fetch(`${authBaseUrl}/api/auth/token`, {
+    method: "GET",
+    headers: {
+      cookie: incomingCookie,
+    },
+  });
+
+  if (!tokenResponse.ok) {
+    return fail("UNAUTHORIZED", "Failed to refresh access token.", {
+      status: tokenResponse.status,
+    });
+  }
+
+  const tokenPayload = await tokenResponse.json();
+  return ok({
+    accessToken: tokenPayload.token,
+  });
+}

package/templates/next-base/src/app/api/v1/example/route.ts

@@ -0,0 +1,34 @@
+import { createExampleSchema } from "@/example/validations";
+import { listExamples } from "@/example/services";
+import { fail, ok } from "@/lib/api-response";
+import prisma from "@/lib/prisma";
+
+export async function GET() {
+  try {
+    const examples = await listExamples();
+    return ok({ items: examples });
+  } catch {
+    return fail("INTERNAL_ERROR", "Failed to fetch examples.", { status: 500 });
+  }
+}
+
+export async function POST(request: Request) {
+  const payload = await request.json().catch(() => null);
+  const parsed = createExampleSchema.safeParse(payload);
+
+  if (!parsed.success) {
+    return fail("VALIDATION_ERROR", "Invalid example payload.", {
+      status: 400,
+      details: parsed.error.flatten(),
+    });
+  }
+
+  try {
+    const created = await prisma.example.create({
+      data: parsed.data,
+    });
+    return ok(created, { status: 201 });
+  } catch {
+    return fail("INTERNAL_ERROR", "Failed to create example.", { status: 500 });
+  }
+}

package/templates/next-base/src/app/layout.tsx

@@ -0,0 +1,28 @@
+import type { Metadata } from "next";
+import { Inter } from "next/font/google";
+import { Toaster } from "sonner";
+import type { ReactNode } from "react";
+import { QueryProvider } from "@/components/providers/query-provider";
+import "@/app/styles.css";
+
+const inter = Inter({ subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "__PROJECT_NAME__",
+  description: "Outsource-ready Next.js scaffolded by NexTCLI",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>
+        <QueryProvider>{children}</QueryProvider>
+        <Toaster richColors position="top-right" />
+      </body>
+    </html>
+  );
+}

package/templates/next-base/src/app/page.tsx

@@ -0,0 +1,21 @@
+import Link from "next/link";
+
+export default function HomePage() {
+  return (
+    <main style={{ padding: 24 }}>
+      <h1>NexTCLI Base Template</h1>
+      <p>Ship outsource projects faster with standardized architecture.</p>
+      <ul style={{ display: "grid", gap: 8 }}>
+        <li>
+          <Link href="/example">Go to example dashboard page</Link>
+        </li>
+        <li>
+          <Link href="/sign-in">Go to sign-in page</Link>
+        </li>
+        <li>
+          <Link href="/account">Go to account page</Link>
+        </li>
+      </ul>
+    </main>
+  );
+}

package/templates/next-base/src/app/styles.css

@@ -0,0 +1,12 @@
+:root {
+  color-scheme: light dark;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: Arial, sans-serif;
+}

package/templates/next-base/src/components/providers/query-provider.tsx

@@ -0,0 +1,17 @@
+"use client";
+
+import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { ReactQueryDevtools } from "@tanstack/react-query-devtools";
+import { useState } from "react";
+import type { ReactNode } from "react";
+
+export function QueryProvider({ children }: { children: ReactNode }) {
+  const [queryClient] = useState(() => new QueryClient());
+
+  return (
+    <QueryClientProvider client={queryClient}>
+      {children}
+      <ReactQueryDevtools initialIsOpen={false} />
+    </QueryClientProvider>
+  );
+}

package/templates/next-base/src/components/ui/button.tsx

@@ -0,0 +1,16 @@
+import * as React from "react";
+import { cn } from "@/utils/cn";
+
+export type ButtonProps = React.ButtonHTMLAttributes<HTMLButtonElement>;
+
+export function Button({ className, ...props }: ButtonProps) {
+  return (
+    <button
+      className={cn(
+        "inline-flex items-center justify-center rounded-md border px-3 py-2 text-sm",
+        className,
+      )}
+      {...props}
+    />
+  );
+}

package/templates/next-base/src/example/api/use-example.ts

@@ -0,0 +1,21 @@
+"use client";
+
+import { useQuery } from "@tanstack/react-query";
+import { api } from "@/lib/axios-instance";
+import type { ApiSuccess } from "@/types";
+
+type ExampleItem = {
+  id: string;
+  name: string;
+  description?: string | null;
+};
+
+export function useExample() {
+  return useQuery({
+    queryKey: ["example"],
+    queryFn: async () => {
+      const { data } = await api.get("/api/v1/example");
+      return (data as ApiSuccess<{ items: ExampleItem[] }>).data.items;
+    },
+  });
+}

package/templates/next-base/src/example/api/use-mutations.ts

@@ -0,0 +1,20 @@
+"use client";
+
+import { useMutation, useQueryClient } from "@tanstack/react-query";
+import { api } from "@/lib/axios-instance";
+import type { CreateExampleInput } from "@/example/validations";
+import type { ApiSuccess } from "@/types";
+
+export function useCreateExample() {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (payload: CreateExampleInput) => {
+      const { data } = await api.post("/api/v1/example", payload);
+      return (data as ApiSuccess<{ id: string }>).data;
+    },
+    onSuccess: async () => {
+      await queryClient.invalidateQueries({ queryKey: ["example"] });
+    },
+  });
+}

package/templates/next-base/src/example/components/example-table.tsx

@@ -0,0 +1,66 @@
+"use client";
+
+import { useMemo } from "react";
+import { createColumnHelper, getCoreRowModel, useReactTable } from "@tanstack/react-table";
+import { useExample } from "@/example/api/use-example";
+
+type ExampleItem = {
+  id: string;
+  name: string;
+  description?: string | null;
+};
+
+const columnHelper = createColumnHelper<ExampleItem>();
+
+const columns = [
+  columnHelper.accessor("name", {
+    header: "Name",
+  }),
+  columnHelper.accessor("description", {
+    header: "Description",
+  }),
+];
+
+export function ExampleTable() {
+  const { data, isLoading } = useExample();
+  const rows = useMemo(() => (Array.isArray(data) ? data : []), [data]);
+
+  const table = useReactTable({
+    data: rows,
+    columns,
+    getCoreRowModel: getCoreRowModel(),
+  });
+
+  if (isLoading) {
+    return <p>Loading examples...</p>;
+  }
+
+  return (
+    <table style={{ width: "100%", borderCollapse: "collapse" }}>
+      <thead>
+        {table.getHeaderGroups().map((headerGroup) => (
+          <tr key={headerGroup.id}>
+            {headerGroup.headers.map((header) => (
+              <th key={header.id} style={{ textAlign: "left", borderBottom: "1px solid #ccc" }}>
+                {typeof header.column.columnDef.header === "string"
+                  ? header.column.columnDef.header
+                  : null}
+              </th>
+            ))}
+          </tr>
+        ))}
+      </thead>
+      <tbody>
+        {table.getRowModel().rows.map((row) => (
+          <tr key={row.id}>
+            {row.getVisibleCells().map((cell) => (
+              <td key={cell.id} style={{ padding: "8px 0", borderBottom: "1px solid #eee" }}>
+                {String(cell.getValue() ?? "")}
+              </td>
+            ))}
+          </tr>
+        ))}
+      </tbody>
+    </table>
+  );
+}

package/templates/next-base/src/example/services.ts

@@ -0,0 +1,9 @@
+import prisma from "@/lib/prisma";
+
+export async function listExamples() {
+  return prisma.example.findMany({
+    orderBy: {
+      createdAt: "desc",
+    },
+  });
+}

package/templates/next-base/src/example/validations.ts

@@ -0,0 +1,8 @@
+import { z } from "zod";
+
+export const createExampleSchema = z.object({
+  name: z.string().min(2),
+  description: z.string().optional(),
+});
+
+export type CreateExampleInput = z.infer<typeof createExampleSchema>;

package/templates/next-base/src/features/auth/components/account-panel.tsx

@@ -0,0 +1,62 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import { publicApi } from "@/lib/axios-instance";
+import type { ApiSuccess } from "@/types";
+
+type SessionPayload = {
+  user?: {
+    id: string;
+    email: string;
+    name?: string | null;
+  };
+};
+
+export function AccountPanel() {
+  const [session, setSession] = useState<SessionPayload | null>(null);
+  const [loading, setLoading] = useState(true);
+
+  useEffect(() => {
+    let mounted = true;
+    const run = async () => {
+      try {
+        const response = await publicApi.get("/api/v1/auth/me", {
+          withCredentials: true,
+        });
+        if (mounted) {
+          setSession((response.data as ApiSuccess<SessionPayload>).data);
+        }
+      } catch {
+        if (mounted) {
+          setSession(null);
+        }
+      } finally {
+        if (mounted) {
+          setLoading(false);
+        }
+      }
+    };
+
+    void run();
+    return () => {
+      mounted = false;
+    };
+  }, []);
+
+  if (loading) {
+    return <p>Loading account...</p>;
+  }
+
+  if (!session?.user) {
+    return <p>No active session. Please sign in first.</p>;
+  }
+
+  return (
+    <section style={{ border: "1px solid #ddd", padding: 16, borderRadius: 8, maxWidth: 420 }}>
+      <h2>My account</h2>
+      <p>User ID: {session.user.id}</p>
+      <p>Email: {session.user.email}</p>
+      <p>Name: {session.user.name ?? "N/A"}</p>
+    </section>
+  );
+}