create-stackkit-app 0.3.1 → 0.4.1

package/modules/auth/clerk-react/module.json

@@ -0,0 +1,18 @@
+{
+  "name": "clerk-react",
+  "description": "Clerk Authentication for React",
+  "category": "auth",
+  "framework": "react-vite",
+  "dependencies": {
+    "@clerk/clerk-react": "^5.19.2"
+  },
+  "env": {
+    "VITE_CLERK_PUBLISHABLE_KEY": "pk_test_your_key_here"
+  },
+  "files": [
+    {
+      "source": "files/lib/auth-provider.tsx",
+      "destination": "lib/auth-provider.tsx"
+    }
+  ]
+}

package/modules/database/drizzle-postgresql/files/drizzle.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'drizzle-kit';
+
+export default defineConfig({
+  schema: './lib/schema.ts',
+  out: './drizzle',
+  dialect: 'postgresql',
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+});

package/modules/database/drizzle-postgresql/files/lib/db.ts

@@ -0,0 +1,7 @@
+import { drizzle } from 'drizzle-orm/postgres-js';
+import postgres from 'postgres';
+
+const connectionString = process.env.DATABASE_URL!;
+
+export const client = postgres(connectionString, { prepare: false });
+export const db = drizzle(client);

package/modules/database/drizzle-postgresql/files/lib/schema.ts

@@ -0,0 +1,8 @@
+import { pgTable, serial, text, timestamp } from 'drizzle-orm/pg-core';
+
+export const users = pgTable('users', {
+  id: serial('id').primaryKey(),
+  name: text('name').notNull(),
+  email: text('email').notNull().unique(),
+  createdAt: timestamp('created_at').defaultNow(),
+});

package/modules/database/drizzle-postgresql/module.json

@@ -0,0 +1,34 @@
+{
+  "name": "drizzle-postgresql",
+  "description": "Drizzle ORM with PostgreSQL",
+  "category": "database",
+  "dependencies": {
+    "drizzle-orm": "^0.36.4",
+    "postgres": "^3.4.5"
+  },
+  "devDependencies": {
+    "drizzle-kit": "^0.28.1"
+  },
+  "scripts": {
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "env": {
+    "DATABASE_URL": "postgresql://postgres:password@localhost:5432/myapp"
+  },
+  "files": [
+    {
+      "source": "files/lib/db.ts",
+      "destination": "lib/db.ts"
+    },
+    {
+      "source": "files/lib/schema.ts",
+      "destination": "lib/schema.ts"
+    },
+    {
+      "source": "files/drizzle.config.ts",
+      "destination": "drizzle.config.ts"
+    }
+  ]
+}

package/modules/database/mongoose-mongodb/files/lib/db.ts

@@ -0,0 +1,40 @@
+import mongoose from 'mongoose';
+
+const MONGODB_URI = process.env.MONGODB_URI || 'mongodb://localhost:27017/myapp';
+
+if (!MONGODB_URI) {
+  throw new Error('Please define the MONGODB_URI environment variable');
+}
+
+let cached = global.mongoose;
+
+if (!cached) {
+  cached = global.mongoose = { conn: null, promise: null };
+}
+
+async function connectDB() {
+  if (cached.conn) {
+    return cached.conn;
+  }
+
+  if (!cached.promise) {
+    const opts = {
+      bufferCommands: false,
+    };
+
+    cached.promise = mongoose.connect(MONGODB_URI, opts).then((mongoose) => {
+      return mongoose;
+    });
+  }
+
+  try {
+    cached.conn = await cached.promise;
+  } catch (e) {
+    cached.promise = null;
+    throw e;
+  }
+
+  return cached.conn;
+}
+
+export default connectDB;

package/modules/database/mongoose-mongodb/module.json

@@ -0,0 +1,17 @@
+{
+  "name": "mongoose-mongodb",
+  "description": "Mongoose ODM for MongoDB",
+  "category": "database",
+  "dependencies": {
+    "mongoose": "^8.8.4"
+  },
+  "env": {
+    "MONGODB_URI": "mongodb://localhost:27017/myapp"
+  },
+  "files": [
+    {
+      "source": "files/lib/db.ts",
+      "destination": "lib/db.ts"
+    }
+  ]
+}

package/{templates/databases/prisma-postgresql → modules/database/prisma-mongodb/files}/lib/db.ts

@@ -4,10 +4,6 @@ const globalForPrisma = globalThis as unknown as {
   prisma: PrismaClient | undefined;
 };
 
-export const prisma =
-  globalForPrisma.prisma ??
-  new PrismaClient({
-    log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
-  });
+export const db = globalForPrisma.prisma ?? new PrismaClient();
 
-if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db;

package/{templates/databases/prisma-mongodb → modules/database/prisma-mongodb/files}/prisma/schema.prisma

@@ -7,6 +7,7 @@ datasource db {
     url      = env("DATABASE_URL")
 }
 
+// Example model - customize as needed
 model User {
     id        String   @id @default(auto()) @map("_id") @db.ObjectId
     email     String   @unique

package/modules/database/prisma-mongodb/module.json

@@ -0,0 +1,36 @@
+{
+  "name": "database",
+  "displayName": "Prisma + MongoDB",
+  "description": "Add Prisma ORM with MongoDB database",
+  "category": "database",
+  "supportedFrameworks": ["nextjs", "express"],
+  "dependencies": {
+    "@prisma/client": "^6.1.0"
+  },
+  "devDependencies": {
+    "prisma": "^6.1.0"
+  },
+  "envVars": [
+    {
+      "key": "DATABASE_URL",
+      "value": "mongodb://localhost:27017/mydb",
+      "description": "MongoDB connection URL",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Prisma schema for MongoDB",
+      "source": "prisma/schema.prisma",
+      "destination": "prisma/schema.prisma"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Prisma client singleton",
+      "source": "lib/db.ts",
+      "destination": "{{lib}}/db.ts"
+    }
+  ],
+  "postInstall": ["npx prisma generate"]
+}

package/{templates/databases/prisma-mongodb → modules/database/prisma-postgresql/files}/lib/db.ts

@@ -4,10 +4,6 @@ const globalForPrisma = globalThis as unknown as {
   prisma: PrismaClient | undefined;
 };
 
-export const prisma =
-  globalForPrisma.prisma ??
-  new PrismaClient({
-    log: process.env.NODE_ENV === 'development' ? ['query', 'error', 'warn'] : ['error'],
-  });
+export const db = globalForPrisma.prisma ?? new PrismaClient();
 
-if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;
+if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = db;

package/{templates/databases/prisma-postgresql → modules/database/prisma-postgresql/files}/prisma/schema.prisma

@@ -7,6 +7,7 @@ datasource db {
     url      = env("DATABASE_URL")
 }
 
+// Example model - customize as needed
 model User {
     id        String   @id @default(cuid())
     email     String   @unique

package/modules/database/prisma-postgresql/module.json

@@ -0,0 +1,36 @@
+{
+  "name": "database",
+  "displayName": "Prisma + PostgreSQL",
+  "description": "Add Prisma ORM with PostgreSQL database",
+  "category": "database",
+  "supportedFrameworks": ["nextjs", "express"],
+  "dependencies": {
+    "@prisma/client": "^6.1.0"
+  },
+  "devDependencies": {
+    "prisma": "^6.1.0"
+  },
+  "envVars": [
+    {
+      "key": "DATABASE_URL",
+      "value": "postgresql://user:password@localhost:5432/mydb?schema=public",
+      "description": "PostgreSQL database connection URL",
+      "required": true
+    }
+  ],
+  "patches": [
+    {
+      "type": "create-file",
+      "description": "Create Prisma schema",
+      "source": "prisma/schema.prisma",
+      "destination": "prisma/schema.prisma"
+    },
+    {
+      "type": "create-file",
+      "description": "Create Prisma client singleton",
+      "source": "lib/db.ts",
+      "destination": "{{lib}}/db.ts"
+    }
+  ],
+  "postInstall": ["npx prisma generate"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-stackkit-app",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Create a new StackKit project with modular composition",
   "main": "dist/index.js",
   "bin": {
@@ -10,7 +10,8 @@
   "files": [
     "dist",
     "bin",
-    "templates"
+    "templates",
+    "modules"
   ],
   "repository": {
     "type": "git",
@@ -23,10 +24,11 @@
   },
   "scripts": {
     "dev": "tsc --watch",
-    "build": "tsc",
-    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc && npm run copy-assets",
+    "copy-assets": "cp -r ../../templates . && cp -r ../../modules .",
+    "clean": "rm -rf dist templates modules",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build && cp -r ../../templates ."
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "create",
@@ -35,7 +37,7 @@
     "nextjs",
     "template"
   ],
-  "author": "Your Name",
+  "author": "Tariqul Islam",
   "license": "MIT",
   "dependencies": {
     "chalk": "^4.1.2",

package/templates/bases/express-base/package.json

@@ -3,9 +3,9 @@
   "version": "1.0.0",
   "private": true,
   "scripts": {
-    "dev": "tsx watch src/index.ts",
+    "dev": "tsx watch src/server.ts",
     "build": "tsc",
-    "start": "node dist/index.js",
+    "start": "node dist/server.js",
     "lint": "eslint src"
   },
   "dependencies": {
@@ -20,4 +20,4 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2"
   }
-}
+}

package/templates/bases/express-base/src/app.ts

@@ -0,0 +1,34 @@
+import cors from 'cors';
+import express, { Application, NextFunction, Request, Response } from 'express';
+import { env } from './config/env';
+import { errorHandler } from './middlewares/error.middleware';
+
+// app initialization
+const app: Application = express();
+app.use(express.json());
+
+// cors configuration
+app.use(
+  cors({
+    origin: [env.app.site_url],
+    credentials: true,
+  })
+);
+
+// Home page route
+app.get('/', (req: Request, res: Response) => {
+  res.send('Hello World!');
+});
+
+// unhandled routes
+app.use((req: Request, res: Response, next: NextFunction) => {
+  const error: any = new Error(`Can't find ${req.originalUrl} on this server!`);
+  error.status = 404;
+
+  next(error);
+});
+
+// Global error handler
+app.use(errorHandler);
+
+export default app;

package/templates/bases/express-base/src/config/env.ts

@@ -0,0 +1,14 @@
+import dotenv from 'dotenv';
+import path from 'path';
+
+dotenv.config({ path: path.join(process.cwd(), '.env') });
+
+const env = {
+  app: {
+    port: Number(process.env.PORT) || 3000,
+    url: process.env.APP_URL || 'http://localhost:3000',
+    site_url: process.env.SITE_URL || 'http://localhost:5173',
+  },
+};
+
+export { env };

package/templates/bases/express-base/src/middlewares/error.middleware.ts

@@ -0,0 +1,12 @@
+import { NextFunction, Request, Response } from 'express';
+
+export const errorHandler = (err: any, req: Request, res: Response, next: NextFunction) => {
+  const statusCode = err.status || 500;
+  const errorMessage = err?.message || 'Internal server error!';
+
+  res.status(statusCode).json({
+    success: false,
+    message: errorMessage,
+    errors: errorMessage,
+  });
+};

package/templates/bases/express-base/src/server.ts

@@ -0,0 +1,8 @@
+import app from './app';
+import { env } from './config/env';
+
+const port = env.app.port;
+
+app.listen(port, () => {
+  console.log(`Server is running on http://localhost:${port}`);
+});

package/templates/bases/express-base/template.json

@@ -3,5 +3,5 @@
   "displayName": "Express.js",
   "framework": "express",
   "description": "Express.js REST API with TypeScript",
-  "files": ["src/", "tsconfig.json", "package.json"]
+  "files": ["src/", ".env.example", ".gitignore", "package.json", "tsconfig.json"]
 }

package/templates/bases/express-base/tsconfig.json

@@ -1,16 +1,13 @@
 {
   "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["ES2020"],
-    "outDir": "./dist",
     "rootDir": "./src",
+    "outDir": "./dist",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "target": "ES2023",
     "strict": true,
     "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "moduleResolution": "node"
+    "ignoreDeprecations": "5.0"
   },
   "include": ["src/**/*"],
   "exclude": ["node_modules", "dist"]

package/templates/bases/nextjs-base/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/templates/bases/nextjs-base/app/globals.css

@@ -1,3 +1,26 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
+@import "tailwindcss";
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

package/templates/bases/nextjs-base/app/layout.tsx

@@ -1,19 +1,34 @@
-import type { Metadata } from 'next';
-import './globals.css';
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import "./globals.css";
+
+const geistSans = Geist({
+  variable: "--font-geist-sans",
+  subsets: ["latin"],
+});
+
+const geistMono = Geist_Mono({
+  variable: "--font-geist-mono",
+  subsets: ["latin"],
+});
 
 export const metadata: Metadata = {
-  title: 'StackKit App',
-  description: 'Generated by create-stackkit-app',
+  title: "Create Next App",
+  description: "Generated by create next app",
 };
 
 export default function RootLayout({
   children,
 }: Readonly<{
-  children: React.Node;
+  children: React.ReactNode;
 }>) {
   return (
     <html lang="en">
-      <body>{children}</body>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
     </html>
   );
 }

package/templates/bases/nextjs-base/app/page.tsx

@@ -1,8 +1,65 @@
+import Image from "next/image";
+
 export default function Home() {
   return (
-    <main className="flex min-h-screen flex-col items-center justify-center p-24">
-      <h1 className="text-4xl font-bold">Welcome to StackKit</h1>
-      <p className="mt-4 text-xl">Your project is ready to go!</p>
-    </main>
+    <div className="flex min-h-screen items-center justify-center bg-zinc-50 font-sans dark:bg-black">
+      <main className="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between py-32 px-16 bg-white dark:bg-black sm:items-start">
+        <Image
+          className="dark:invert"
+          src="/next.svg"
+          alt="Next.js logo"
+          width={100}
+          height={20}
+          priority
+        />
+        <div className="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
+          <h1 className="max-w-xs text-3xl font-semibold leading-10 tracking-tight text-black dark:text-zinc-50">
+            To get started, edit the page.tsx file.
+          </h1>
+          <p className="max-w-md text-lg leading-8 text-zinc-600 dark:text-zinc-400">
+            Looking for a starting point or more instructions? Head over to{" "}
+            <a
+              href="https://vercel.com/templates?framework=next.js&utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              className="font-medium text-zinc-950 dark:text-zinc-50"
+            >
+              Templates
+            </a>{" "}
+            or the{" "}
+            <a
+              href="https://nextjs.org/learn?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+              className="font-medium text-zinc-950 dark:text-zinc-50"
+            >
+              Learning
+            </a>{" "}
+            center.
+          </p>
+        </div>
+        <div className="flex flex-col gap-4 text-base font-medium sm:flex-row">
+          <a
+            className="flex h-12 w-full items-center justify-center gap-2 rounded-full bg-foreground px-5 text-background transition-colors hover:bg-[#383838] dark:hover:bg-[#ccc] md:w-[158px]"
+            href="https://vercel.com/new?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            <Image
+              className="dark:invert"
+              src="/vercel.svg"
+              alt="Vercel logomark"
+              width={16}
+              height={16}
+            />
+            Deploy Now
+          </a>
+          <a
+            className="flex h-12 w-full items-center justify-center rounded-full border border-solid border-black/[.08] px-5 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-[158px]"
+            href="https://nextjs.org/docs?utm_source=create-next-app&utm_medium=appdir-template-tw&utm_campaign=create-next-app"
+            target="_blank"
+            rel="noopener noreferrer"
+          >
+            Documentation
+          </a>
+        </div>
+      </main>
+    </div>
   );
 }

package/templates/bases/nextjs-base/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,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/templates/bases/nextjs-base/next.config.ts

@@ -1,5 +1,7 @@
-import type { NextConfig } from 'next';
+import type { NextConfig } from "next";
 
-const nextConfig: NextConfig = {};
+const nextConfig: NextConfig = {
+  /* config options here */
+};
 
 export default nextConfig;