stackkit 0.3.0 → 0.3.2

package/modules/auth/better-auth/files/shared/prisma/{schema.prisma → auth.prisma}

@@ -69,15 +69,3 @@ model Verification {
     @@index([identifier])
     @@map("verification")
 }
-
-enum Role {
-    SUPER_ADMIN
-    ADMIN
-    USER
-}
-
-enum UserStatus {
-    ACTIVE
-    BLOCKED
-    DELETED
-}

package/modules/auth/better-auth/files/shared/prisma/enums.prisma

@@ -0,0 +1,11 @@
+enum Role {
+    SUPER_ADMIN
+    ADMIN
+    USER
+}
+
+enum UserStatus {
+    ACTIVE
+    BLOCKED
+    DELETED
+}

package/modules/auth/better-auth/generator.json

@@ -222,15 +222,10 @@
       "condition": { "framework": "react" }
     },
     {
-      "type": "patch-file",
-      "destination": "prisma/schema.prisma",
-      "condition": { "database": "prisma" },
-      "operations": [
-        {
-          "type": "add-to-bottom",
-          "source": "shared/prisma/schema.prisma"
-        }
-      ]
+      "type": "create-file",
+      "source": "shared/prisma/*",
+      "destination": "prisma/*",
+      "condition": { "database": "prisma" }
     },
     {
       "type": "add-dependency",

package/modules/database/prisma/files/prisma/schema.prisma

@@ -1,7 +1,8 @@
 generator client {
-    provider = "prisma-client-js"
+  provider = "prisma-client-js"
+  output   = "../src/generated/prisma"
 }
 
 datasource db {
-    provider = "{{prismaProvider}}"
+  provider = "{{prismaProvider}}"
 }

package/modules/database/prisma/files/prisma.config.ts

@@ -9,7 +9,7 @@ import { defineConfig } from "prisma/config";
 {{/switch}}
 
 export default defineConfig({
-  schema: "prisma/schema.prisma",
+  schema: "./prisma",
   migrations: {
     path: "prisma/migrations",
   },

package/modules/database/prisma/generator.json

@@ -34,23 +34,23 @@
     {
       "type": "add-script",
       "scripts": {
-        "db:generate": "npx prisma generate",
-        "db:push": "npx prisma db push",
-        "db:seed": "tsx prisma/seed.ts",
-        "db:migrate": "npx prisma migrate dev",
-        "db:studio": "npx prisma studio"
+        "generate": "prisma generate",
+        "push": "prisma db push",
+        "seed": "tsx prisma/seed.ts",
+        "migrate": "prisma migrate dev",
+        "studio": "prisma studio"
       }
     },
     {
       "type": "add-dependency",
       "condition": { "prismaProvider": "postgresql" },
       "dependencies": {
-        "@prisma/client": "^7.2.0",
+        "@prisma/client": "^7.4.2",
         "@prisma/adapter-pg": "^7.0.0",
         "pg": "^8.0.0"
       },
       "devDependencies": {
-        "prisma": "^7.2.0"
+        "prisma": "^7.4.2"
       }
     },
     {
@@ -64,12 +64,12 @@
       "type": "add-dependency",
       "condition": { "prismaProvider": "mysql" },
       "dependencies": {
-        "@prisma/client": "^7.2.0",
+        "@prisma/client": "^7.4.2",
         "@prisma/adapter-mariadb": "^7.0.0",
         "mysql2": "^3.0.0"
       },
       "devDependencies": {
-        "prisma": "^7.2.0"
+        "prisma": "^7.4.2"
       }
     },
     {
@@ -83,12 +83,12 @@
       "type": "add-dependency",
       "condition": { "prismaProvider": "sqlite" },
       "dependencies": {
-        "@prisma/client": "^7.2.0",
+        "@prisma/client": "^7.4.2",
         "@prisma/adapter-better-sqlite3": "^7.0.0",
         "better-sqlite3": "^9.0.0"
       },
       "devDependencies": {
-        "prisma": "^7.2.0"
+        "prisma": "^7.4.2"
       }
     },
     {
@@ -102,10 +102,10 @@
       "type": "add-dependency",
       "condition": { "prismaProvider": "mongodb" },
       "dependencies": {
-        "@prisma/client": "^6.19.0"
+        "@prisma/client": "^7.4.2"
       },
       "devDependencies": {
-        "prisma": "^6.19.0"
+        "prisma": "^7.4.2"
       }
     },
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stackkit",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Production-ready CLI to create and extend JavaScript or TypeScript apps with modular stacks.",
   "main": "dist/index.js",
   "bin": {
@@ -80,4 +80,4 @@
     "@types/validate-npm-package-name": "^4.0.2",
     "typescript": "^5.3.3"
   }
-}
+}

package/templates/express/README.md

@@ -31,6 +31,87 @@ npm run dev
 
 Use a `.env` file or environment variables for configuration. See `.env.example` for available keys.
 
+## Recommended Folder & File Structure
+
+```text
+express-api/
+├── src/
+│   ├── app.ts
+│   ├── server.ts
+│
+│   ├── config/
+│   │   ├── env.ts
+│   │   ├── cors.ts
+│   │   ├── rateLimit.ts
+│   │   └── logger.ts                    # (optional)
+│
+│   ├── database/
+│   │   └── prisma.ts                     # PrismaClient singleton
+│   
+│   ├── lib/ 
+│       └── auth.ts                   # Auth server config
+│
+│   ├── shared/
+│   │   ├── middlewares/
+│   │   │   ├── authorize.middleware.ts        # reads session + attaches req.user
+│   │   │   ├── error.middleware.ts
+│   │   │   └── notFound.middleware.ts
+│   │   ├── errors/
+│   │   │   ├── ApiError.ts
+│   │   │   └── errorCodes.ts
+│   │   ├── utils/
+│   │   │   ├── catchAsync.ts
+│   │   │   ├── sendResponse.ts
+│   │   │   └── pagination.ts
+│   │   └── logger/
+│   │       └── logger.ts
+│
+│   ├── modules/
+│   │   ├── auth/
+│   │   │   ├── auth.routes.ts
+│   │   │   ├── auth.controller.ts
+│   │   │   ├── auth.service.ts
+│   │   │   ├── auth.validator.ts
+│   │   │   └── auth.types.ts
+│   │   ├── users/
+│   │   │   ├── users.routes.ts
+│   │   │   ├── users.controller.ts
+│   │   │   ├── users.service.ts
+│   │   │   ├── users.repository.ts
+│   │   │   ├── users.validator.ts
+│   │   │   └── users.types.ts
+│   │   └── products/
+│   │       ├── products.routes.ts
+│   │       ├── products.controller.ts
+│   │       ├── products.service.ts
+│   │       ├── products.repository.ts
+│   │       ├── products.validator.ts
+│   │       └── products.types.ts
+│
+│   ├── routes/
+│   │   └── index.ts                      # mounts all module routes
+│   │
+│   └── types/
+│       └── express.d.ts                  # Request typing (req.user)
+│
+├── prisma/
+│   ├── schema.prisma
+│   ├── migrations/
+│   └── seed.ts
+│
+├── tests/
+│   ├── unit/
+│   └── integration/
+│
+├── Dockerfile
+├── docker-compose.yml
+├── package.json
+├── tsconfig.json
+├── eslint.config.js
+├── .env.example
+└── README.md
+```
+
 ---
 
 ## Generated with StackKit

package/templates/express/src/server.ts

@@ -1,9 +1,12 @@
+import { Server } from "http";
 import { app } from "./app";
 import { envVars } from "./config/env";
 
+let server: Server | null = null;
+
 const bootstrap = async () => {
   try {
-    app.listen(envVars.PORT, () => {
+    server = app.listen(envVars.PORT, () => {
       console.log(`Server is running on http://localhost:${envVars.PORT}`);
     });
   } catch (error) {
@@ -11,4 +14,50 @@ const bootstrap = async () => {
   }
 };
 
+process.on("SIGTERM", () => {
+  console.log("SIGTERM signal received: closing HTTP server");
+  if (server) {
+    server.close(() => {
+      console.log("HTTP server closed");
+    });
+  }
+
+  process.exit(0);
+});
+
+process.on("SIGINT", () => {
+  console.log("SIGINT signal received: closing HTTP server");
+  if (server) {
+    server.close(() => {
+      console.log("HTTP server closed");
+    });
+  }
+
+  process.exit(0);
+});
+
+process.on("uncaughtException", (err) => {
+  console.error("Uncaught Exception:", err);
+
+  if (server) {
+    server.close(() => {
+      console.log("HTTP server closed due to uncaught exception");
+    });
+  }
+
+  process.exit(1);
+});
+
+process.on("unhandledRejection", (reason, promise) => {
+  console.error("Unhandled Rejection at:", promise, "reason:", reason);
+
+  if (server) {
+    server.close(() => {
+      console.log("HTTP server closed due to unhandled rejection");
+    });
+  }
+
+  process.exit(1);
+});
+
 bootstrap();

package/templates/nextjs/README.md

@@ -50,6 +50,102 @@ lib/
 public/            # Static assets
 ```
 
+## Recommended Folder & File Structure
+
+```text
+next-app/
+├── src/
+│   ├── app/
+│   │   ├── (public)/
+│   │   │   ├── layout.tsx
+│   │   │   ├── page.tsx
+│   │   │   └── pricing/page.tsx
+│   │   ├── (dashboard)/
+│   │   │   ├── layout.tsx
+│   │   │   ├── dashboard/page.tsx
+│   │   │   ├── products/page.tsx
+│   │   │   └── orders/page.tsx
+│   │   ├── api/
+│   │   │   ├── health/route.ts
+│   │   │   └── auth/route.ts              # (optional) if you expose auth endpoints
+│   │   ├── layout.tsx
+│   │   ├── globals.css
+│   │   ├── error.tsx
+│   │   └── not-found.tsx
+│   │
+│   ├── features/
+│   │   ├── auth/
+│   │   │   ├── components/
+│   │   │   ├── actions/
+│   │   │   ├── schemas/
+│   │   │   ├── types/
+│   │   │   └── index.ts
+│   │   ├── products/
+│   │   │   ├── components/
+│   │   │   ├── actions/
+│   │   │   ├── queries/
+│   │   │   ├── schemas/
+│   │   │   ├── types/
+│   │   │   └── index.ts
+│   │   └── orders/
+│   │       ├── components/
+│   │       ├── actions/
+│   │       ├── queries/
+│   │       ├── schemas/
+│   │       ├── types/
+│   │       └── index.ts
+│   │
+│   ├── components/
+│   │   ├── ui/                            # shadcn/ui only
+│   │   └── shared/
+│   │       ├── Header.tsx
+│   │       ├── Footer.tsx
+│   │       └── Sidebar.tsx
+│   │
+│   ├── server/                            # server-only boundary
+│   │   ├── auth/
+│   │   │   ├── auth.ts                    # Auth (server config)
+│   │   │   └── guards.ts
+│   │   ├── db/
+│   │   │   └── prisma.ts                  # PrismaClient singleton
+│   │   ├── repositories/
+│   │   │   ├── product.repo.ts
+│   │   │   └── order.repo.ts
+│   │   └── services/
+│   │       ├── email.service.ts
+│   │       └── storage.service.ts
+│   │
+│   ├── lib/
+│   │   ├── env.ts
+│   │   ├── utils.ts
+│   │   ├── logger.ts
+│   │   └── auth/
+│   │       └── auth-client.ts             # Auth (client helper)
+│   │
+│   ├── hooks/
+│   │   └── useDebounce.ts
+│   │
+│   └── types/
+│       └── global.d.ts
+│
+├── prisma/
+│   ├── schema.prisma
+│   ├── migrations/
+│   └── seed.ts
+│
+├── public/
+├── tests/
+│   ├── unit/
+│   └── e2e/
+│
+├── middleware.ts
+├── next.config.js
+├── package.json
+├── tsconfig.json
+├── .env.example
+└── README.md
+```
+
 ## Environment Variables
 
 Create a `.env.local` (Next.js) file for local environment variables. Keep secrets out of the repository.

package/templates/nextjs/app/layout.tsx

@@ -1,5 +1,7 @@
+import { QueryProviders } from "@/components/providers/query-provider";
 import type { Metadata } from "next";
 import { Geist, Geist_Mono } from "next/font/google";
+import { Toaster } from "sonner";
 import "./globals.css";
 
 const geistSans = Geist({
@@ -13,8 +15,8 @@ const geistMono = Geist_Mono({
 });
 
 export const metadata: Metadata = {
-  title: "Create Next App",
-  description: "Generated by create next app",
+  title: "Create Next App - StackKit",
+  description: "Generated by create next app with StackKit template",
 };
 
 export default function RootLayout({
@@ -24,7 +26,11 @@ export default function RootLayout({
 }>) {
   return (
     <html lang="en">
-      <body className={`${geistSans.variable} ${geistMono.variable} antialiased`}>{children}</body>
+      <head />
+      <body className={`${geistSans.variable} ${geistMono.variable} antialiased`}>
+        <QueryProviders>{children}</QueryProviders>
+        <Toaster theme="system" position="top-right" richColors />
+      </body>
     </html>
   );
 }

package/templates/nextjs/components/providers/query-provider.tsx

@@ -0,0 +1,37 @@
+"use client";
+
+import { isServer, QueryClient, QueryClientProvider } from "@tanstack/react-query";
+import { ReactQueryStreamedHydration } from "@tanstack/react-query-next-experimental";
+
+function makeQueryClient() {
+  return new QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: 60 * 1000,
+      },
+    },
+  });
+}
+
+let browserQueryClient: QueryClient | undefined = undefined;
+
+function getQueryClient() {
+  if (isServer) {
+    return makeQueryClient();
+  } else {
+    if (!browserQueryClient) browserQueryClient = makeQueryClient();
+    return browserQueryClient;
+  }
+}
+
+function QueryProviders({ children }: { children: React.ReactNode }) {
+  const queryClient = getQueryClient();
+
+  return (
+    <QueryClientProvider client={queryClient}>
+      <ReactQueryStreamedHydration>{children}</ReactQueryStreamedHydration>
+    </QueryClientProvider>
+  );
+}
+
+export { getQueryClient, QueryProviders };

package/templates/nextjs/lib/api/http.ts

@@ -0,0 +1,48 @@
+import type { AxiosResponse } from "axios";
+import axios, { AxiosError } from "axios";
+import { toast } from "sonner";
+import { envVars } from "../env";
+
+const api = axios.create({
+  baseURL: envVars.API_URL || "http://localhost:5000/api",
+  timeout: 30000,
+  headers: {
+    "Content-Type": "application/json",
+  },
+});
+
+api.interceptors.request.use(
+  (config) => {
+    const token = localStorage.getItem("auth_token");
+    if (token) {
+      (config.headers as Record<string, string>).Authorization = `Bearer ${token}`;
+    }
+    return config;
+  },
+  (error: AxiosError) => {
+    return Promise.reject(error);
+  },
+);
+
+api.interceptors.response.use(
+  (response: AxiosResponse) => response,
+  (error: AxiosError) => {
+    if (error.response?.status === 401) {
+      localStorage.removeItem("auth_token");
+      toast.error("Session expired. Please login again.");
+    } else if (error.response?.status === 403) {
+      toast.error("You do not have permission to perform this action.");
+    } else if (error.response?.status === 404) {
+      toast.error("Resource not found.");
+    } else if (error.response?.status === 500) {
+      toast.error("Server error. Please try again later.");
+    } else if (error.code === "ECONNABORTED") {
+      toast.error("Request timeout. Please try again.");
+    } else if (!error.response) {
+      toast.error("Network error. Please check your connection.");
+    }
+    return Promise.reject(error);
+  },
+);
+
+export { api };

package/templates/nextjs/lib/env.ts

@@ -1,9 +1,10 @@
 interface EnvVars {
   APP_URL: string;
+  API_URL: string;
 }
 
 const loadEnvVars = (): EnvVars => {
-  const requiredEnvVars = [""];
+  const requiredEnvVars = ["NEXT_PUBLIC_API_URL"];
 
   requiredEnvVars.forEach((varName) => {
     if (!process.env[varName]) {
@@ -13,6 +14,7 @@ const loadEnvVars = (): EnvVars => {
 
   return {
     APP_URL: process.env.NEXT_PUBLIC_APP_URL || "http://localhost:3000",
+    API_URL: process.env.NEXT_PUBLIC_API_URL || "http://localhost:5000/api",
   };
 };
 

package/templates/nextjs/package.json

@@ -10,9 +10,13 @@
     "lint": "eslint"
   },
   "dependencies": {
+    "@tanstack/react-query": "^5.90.21",
+    "@tanstack/react-query-next-experimental": "^5.91.0",
+    "axios": "^1.13.5",
     "next": "16.1.1",
     "react": "19.2.3",
-    "react-dom": "19.2.3"
+    "react-dom": "19.2.3",
+    "sonner": "^2.0.7"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4.1.18",
@@ -24,4 +28,4 @@
     "tailwindcss": "^4.1.18",
     "typescript": "^5.9.3"
   }
-}
+}

package/templates/nextjs/template.json

@@ -9,6 +9,7 @@
   },
   "files": [
     "app/",
+    "components/",
     "lib/",
     "public/",
     ".env.example",

package/templates/react/README.md

@@ -61,6 +61,62 @@ src/
 └── utils/        # Helper functions
 ```
 
+## Recommended Folder & File Structure
+
+```text
+react-vite-app/
+├── src/
+│   ├── app/
+│   │   ├── router.tsx
+│   │   ├── providers.tsx
+│   │   └── layouts/
+│   │       ├── PublicLayout.tsx
+│   │       └── DashboardLayout.tsx
+│
+│   ├── features/
+│   │   ├── auth/
+│   │   │   ├── pages/
+│   │   │   │   ├── LoginPage.tsx
+│   │   │   │   └── SignupPage.tsx
+│   │   │   ├── components/
+│   │   │   ├── api/
+│   │   │   │   └── auth.api.ts
+│   │   │   ├── hooks/
+│   │   │   │   └── useAuth.ts
+│   │   │   ├── schemas/
+│   │   │   ├── types/
+│   │   │   └── index.ts
+│   │   ├── products/
+│   │   └── orders/
+│
+│   ├── shared/
+│   │   ├── ui/
+│   │   ├── components/
+│   │   │   ├── Header.tsx
+│   │   │   └── Sidebar.tsx
+│   │   ├── api/
+│   │   │   ├── http.ts                  # axios/fetch client
+│   │   │   └── endpoints.ts
+│   │   └── lib/
+│   │       ├── env.ts
+│   │       ├── utils.ts
+│   │       └── auth-client.ts           # Auth client helper
+│
+│   ├── assets/
+│   ├── main.tsx
+│   └── index.css
+│
+├── public/
+├── tests/
+│   ├── unit/
+│   └── e2e/
+├── vite.config.ts
+├── tsconfig.json
+├── package.json
+├── .env.example
+└── README.md
+```
+
 ## Deployment
 
 Build for production and serve or deploy the static output: