next-ts-cli 1.0.3

package/template/base/package.json

@@ -0,0 +1,59 @@
+{
+	"name": "next-ts",
+	"version": "1.0.0",
+	"scripts": {
+		"dev": "next dev",
+		"build": "next build",
+		"start": "next start",
+		"lint": "biome check",
+		"format": "biome format --write",
+		"test": "jest",
+		"test:watch": "jest --watch",
+		"test:ci": "jest --ci --passWithNoTests",
+		"docker:build": "docker compose -f docker-compose.prod.yml build",
+		"docker:up": "docker compose -f docker-compose.prod.yml up -d",
+		"docker:down": "docker compose -f docker-compose.prod.yml down",
+		"docker:logs": "docker compose -f docker-compose.prod.yml logs -f",
+		"docker:exec": "docker compose -f docker-compose.prod.yml exec app sh",
+		"docker:exec:bash": "docker compose -f docker-compose.prod.yml exec app bash",
+		"docker:exec:sh": "docker compose -f docker-compose.prod.yml exec app sh",
+		"docker:exec:npm": "docker compose -f docker-compose.prod.yml exec app npm"
+	},
+	"lint-staged": {
+		"*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+			"biome check --write --no-errors-on-unmatched"
+		]
+	},
+	"dependencies": {
+		"@next/third-parties": "^16.1.1",
+		"clsx": "^2.1.1",
+		"framer-motion": "^12.23.6",
+		"husky": "^9.1.7",
+		"lint-staged": "^16.2.7",
+		"next": "^16.1.1",
+		"react": "^19.2.3",
+		"react-dom": "^19.2.3",
+		"schema-dts": "^1.1.5",
+		"sharp": "^0.34.5",
+		"tailwind-merge": "^3.4.0"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "2.3.10",
+		"@commitlint/cli": "^20.2.0",
+		"@commitlint/config-conventional": "^20.2.0",
+		"@tailwindcss/postcss": "^4.1.11",
+		"@testing-library/jest-dom": "^6.9.1",
+		"@testing-library/react": "^16.3.0",
+		"@testing-library/user-event": "^14.6.1",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^25.0.3",
+		"@types/react": "^19.2.7",
+		"@types/react-dom": "^19.2.3",
+		"autoprefixer": "^10.4.21",
+		"jest": "^30.2.0",
+		"jest-environment-jsdom": "^30.2.0",
+		"postcss": "^8.5.6",
+		"tailwindcss": "^4.1.11",
+		"typescript": "^5.9.3"
+	}
+}

package/template/base/postcss.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+	plugins: {
+		"@tailwindcss/postcss": {},
+	},
+};

package/template/base/providers/MicrodataScript.tsx

@@ -0,0 +1,18 @@
+import Script from "next/script";
+import type { WithContext } from "schema-dts";
+import type { SchemaType, SchemaTypeMap } from "@/lib/microdata";
+
+interface MicrodataScriptProps {
+	id: string;
+	microdata: WithContext<SchemaTypeMap[SchemaType]>;
+}
+
+export function MicrodataScript({ id, microdata }: MicrodataScriptProps) {
+	return (
+		<Script
+			id={id}
+			type="application/ld+json"
+			dangerouslySetInnerHTML={{ __html: JSON.stringify(microdata) }}
+		/>
+	);
+}

package/template/base/public/.gitkeep

@@ -0,0 +1,3 @@
+# This file keeps the public directory in git
+# Add your static assets here (images, fonts, etc.)
+

package/template/base/test/index.test.tsx

@@ -0,0 +1,9 @@
+import { render, screen } from "@testing-library/react";
+import Home from "@/app/page";
+
+describe("Home Page", () => {
+	it("renders home page", () => {
+		render(<Home />);
+		expect(screen.getByText("next-ts")).toBeDefined();
+	});
+});

package/template/base/tsconfig.json

@@ -0,0 +1,38 @@
+{
+	"compilerOptions": {
+		"lib": ["dom", "dom.iterable", "esnext"],
+		"allowJs": true,
+		"skipLibCheck": true,
+		"strict": true,
+		"noEmit": true,
+		"esModuleInterop": true,
+		"module": "esnext",
+		"moduleResolution": "bundler",
+		"resolveJsonModule": true,
+		"isolatedModules": true,
+		"jsx": "react-jsx",
+		"incremental": true,
+		"plugins": [
+			{
+				"name": "next"
+			}
+		],
+		"paths": {
+			"@/*": ["./*"],
+			"@/components/*": ["./components/*"],
+			"@/hooks/*": ["./hooks/*"],
+			"@/lib/*": ["./lib/*"],
+			"@/public/*": ["./public/*"],
+			"@/providers/*": ["./providers/*"]
+		},
+		"target": "ES2017"
+	},
+	"include": [
+		"next-env.d.ts",
+		"**/*.ts",
+		"**/*.tsx",
+		".next/types/**/*.ts",
+		".next/dev/types/**/*.ts"
+	],
+	"exclude": ["node_modules"]
+}

package/template/extras/better-auth/api/auth/[...all]/route.ts

@@ -0,0 +1,7 @@
+import { toNodeHandler } from "better-auth/node"
+import { auth } from "@/lib/auth"
+
+// Disallow body parsing, we will parse it manually
+export const config = { api: { bodyParser: false } }
+
+export default toNodeHandler(auth.handler)

package/template/extras/better-auth/base-auth.ts

@@ -0,0 +1,12 @@
+import { betterAuth } from "better-auth";
+import { nextCookies } from "better-auth/next-js";
+
+export const auth = betterAuth({
+  emailAndPassword: {
+    enabled: true,
+  },
+  // Make sure nextCookies() is the last plugin in the array
+  plugins: [nextCookies()],
+});
+
+export type Session = typeof auth.$Infer.Session;

package/template/extras/better-auth/with-drizzle-auth.ts

@@ -0,0 +1,31 @@
+import "dotenv/config";
+import { betterAuth } from "better-auth";
+import { drizzleAdapter } from "better-auth/adapters/drizzle";
+import { nextCookies } from "better-auth/next-js";
+
+/* Here imports have errors because they are related to the final directory structure */
+import { db } from "@/lib/db";
+
+if (!process.env.BETTER_AUTH_GITHUB_CLIENT_ID || !process.env.BETTER_AUTH_GITHUB_CLIENT_SECRET) {
+  throw new Error("BETTER_AUTH_GITHUB_CLIENT_ID and BETTER_AUTH_GITHUB_CLIENT_SECRET must be set");
+}
+
+export const auth = betterAuth({
+  database: drizzleAdapter(db, {
+    provider: "pg",
+  }),
+  emailAndPassword: {
+    enabled: true,
+  },
+  socialProviders: {
+    github: {
+      clientId: process.env.BETTER_AUTH_GITHUB_CLIENT_ID,
+      clientSecret: process.env.BETTER_AUTH_GITHUB_CLIENT_SECRET,
+      redirectURI: "http://localhost:3000/api/auth/callback/github",
+    },
+  },
+  // Make sure nextCookies() is the last plugin in the array
+  plugins: [nextCookies()],
+});
+
+export type Session = typeof auth.$Infer.Session;

package/template/extras/clerk/layout.tsx

@@ -0,0 +1,89 @@
+import type { Metadata } from "next";
+import { GoogleAnalytics } from "@next/third-parties/google";
+import { barrio, dmSans } from "@/lib/fonts";
+import { allowIndexing } from "@/lib/indexing";
+import { microdata } from "@/lib/microdata";
+import { cn } from "@/lib/utils";
+import { MicrodataScript } from "@/providers/MicrodataScript";
+import {
+	ClerkProvider,
+	SignInButton,
+	SignUpButton,
+	SignedIn,
+	SignedOut,
+	UserButton,
+} from '@clerk/nextjs'
+import "./globals.css";
+
+const homePageMicrodata = microdata("WebSite", {
+	name: "next-ts",
+	url: process.env.NEXT_PUBLIC_BASE_URL,
+	description:
+		"next-ts is a Production-Ready and Scalable Next.js Template Starter. Stop wasting time setting up your _next_ big project, with next-ts it's all ready to go!",
+	author: "next-ts",
+	publisher: "next-ts",
+	inLanguage: "en_US",
+	isAccessibleForFree: true,
+	image: `${process.env.NEXT_PUBLIC_BASE_URL}/public/myimage.png`,
+	mainEntityOfPage: {
+		"@type": "WebSite",
+		"@id": process.env.NEXT_PUBLIC_BASE_URL,
+	},
+});
+
+export const metaData: Metadata = {
+	metadataBase: new URL(process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000"),
+	title: {
+		default: "next-ts",
+		template: "next-ts - %s",
+	},
+	description:
+		"next-ts is a Production-Ready and Scalable Next.js Template Starter. Stop wasting time setting up your _next_ big project, with next-ts it's all ready to go!",
+	keywords: ["next-ts"],
+	authors: [{ name: "next-ts" }],
+	creator: "next-ts",
+	publisher: "next-ts",
+	formatDetection: {
+		email: false,
+		address: false,
+		telephone: false,
+	},
+	alternates: {
+		canonical: process.env.NEXT_PUBLIC_BASE_URL,
+	},
+	...allowIndexing(),
+};
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+	return (
+		<ClerkProvider>
+			<html lang="en">
+				<body className={cn("bg-background", barrio.variable, dmSans.variable)}>
+					<header className="flex fixed top-0 left-0 right-0 justify-between items-center py-8 max-w-4xl mx-auto gap-4 h-16">
+						<div className="flex items-center gap-4">
+							My SaaS App
+						</div>
+						<div className="flex items-center gap-4">
+							<SignedOut>
+								<SignInButton />
+								<SignUpButton>
+									<button className="bg-[#6c47ff] text-white rounded-full font-medium text-sm px-4 py-2 cursor-pointer">
+										Sign Up
+									</button>
+								</SignUpButton>
+							</SignedOut>
+							<SignedIn>
+								<UserButton />
+							</SignedIn>
+						</div>
+					</header>
+					{children}
+					<MicrodataScript id="home-microdata" microdata={homePageMicrodata} />
+					{process.env.GOOGLE_ANALYTICS_TAG && (
+						<GoogleAnalytics gaId={process.env.GOOGLE_ANALYTICS_TAG} />
+					)}
+				</body>
+			</html>
+		</ClerkProvider>
+	);
+}

package/template/extras/clerk/proxy.ts

@@ -0,0 +1,21 @@
+import { clerkMiddleware, createRouteMatcher } from '@clerk/nextjs/server'
+
+
+const protectedRoutes = createRouteMatcher([
+  // Add your protected routes here, example: /dashboard
+])
+
+export default clerkMiddleware(async (auth,req) =>{
+  if(protectedRoutes(req)){
+    await auth.protect()
+  }
+})
+
+export const config = {
+  matcher: [
+    // Skip Next.js internals and all static files, unless found in search params
+    '/((?!_next|[^?]*\\.(?:html?|css|js(?!on)|jpe?g|webp|png|gif|svg|ttf|woff2?|ico|csv|docx?|xlsx?|zip|webmanifest)).*)',
+    // Always run for API routes
+    '/(api|trpc)(.*)',
+  ],
+}

package/template/extras/docker/.dockerignore

@@ -0,0 +1,60 @@
+# ============================================
+# Docker Ignore File
+# ============================================
+# Excludes files from the Docker build context
+# for faster builds and smaller images
+# ============================================
+
+# Dependencies
+node_modules
+.pnp
+.pnp.js
+
+# Build outputs
+.next
+out
+build
+dist
+
+# Testing
+coverage
+.nyc_output
+
+# Debug logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# Environment files (add to context only what you need)
+.env
+.env.*
+!.env.example
+
+# IDE & Editor
+.idea
+.vscode
+*.swp
+*.swo
+.DS_Store
+
+# Git
+.git
+.gitignore
+
+# Docker
+Dockerfile*
+docker-compose*
+.dockerignore
+
+# Documentation
+README.md
+LICENSE
+CHANGELOG.md
+docs/
+
+# Misc
+*.md
+.husky
+.github
+

package/template/extras/docker/Dockerfile

@@ -0,0 +1,51 @@
+# 1. Base Image
+FROM node:22-alpine AS base
+
+# 2. Dependencies Stage
+FROM base AS deps
+RUN apk add --no-cache libc6-compat
+WORKDIR /app
+
+COPY package.json package-lock.json* ./
+RUN npm ci
+
+# 3. Builder Stage
+FROM base AS builder
+WORKDIR /app
+COPY --from=deps /app/node_modules ./node_modules
+COPY . .
+
+ARG NEXT_PUBLIC_BASE_URL 
+ENV NEXT_PUBLIC_BASE_URL=$NEXT_PUBLIC_BASE_URL
+
+# Disabilita la telemetria durante la build
+ENV NEXT_TELEMETRY_DISABLED 1
+
+RUN npm run build
+
+# 4. Runner Stage (Production)
+FROM base AS runner
+WORKDIR /app
+
+ENV NODE_ENV production
+ENV NEXT_TELEMETRY_DISABLED 1
+
+RUN addgroup --system --gid 1001 nodejs
+RUN adduser --system --uid 1001 nextjs
+
+COPY --from=builder /app/public ./public
+
+RUN mkdir .next
+RUN chown nextjs:nodejs .next
+
+COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
+COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
+
+USER nextjs
+
+EXPOSE 3000
+
+ENV PORT 3000
+ENV HOSTNAME "0.0.0.0"
+
+CMD ["node", "server.js"]

package/template/extras/docker/docker-compose.prod.yml

@@ -0,0 +1,34 @@
+# ============================================
+# Next.js SEO Starter - Docker Compose (Production)
+# ============================================
+#
+# Usage:
+#   Build & Start: docker compose -f docker-compose.prod.yml up --build -d
+#   Stop:          docker compose -f docker-compose.prod.yml down
+#
+# ============================================
+
+services:
+  app:
+    build:
+      context: .
+      target: runner
+      args:
+        NEXT_PUBLIC_BASE_URL: ${NEXT_PUBLIC_BASE_URL}
+    container_name: nextjs-seo-web
+    volumes: [] # No volume mounts in production
+    environment:
+      - NODE_ENV=production
+      - NEXT_TELEMETRY_DISABLED=1
+    env_file:
+      - path: .env
+    restart: always
+    # Resource limits (adjust based on your needs)
+    deploy:
+      resources:
+        limits:
+          cpus: "1"
+          memory: 512M
+        reservations:
+          cpus: "0.25"
+          memory: 256M

package/template/extras/drizzle/db/index.ts

@@ -0,0 +1,9 @@
+import { drizzle } from 'drizzle-orm/postgres-js'
+
+if (!process.env.DATABASE_URL) {
+	throw new Error("DATABASE_URL is not set");
+}
+
+const db = drizzle(process.env.DATABASE_URL!);
+
+export { db };

package/template/extras/drizzle/db/schema.ts

@@ -0,0 +1,7 @@
+import { integer, pgTable, varchar } from "drizzle-orm/pg-core";
+export const usersTable = pgTable("users", {
+  id: integer().primaryKey().generatedAlwaysAsIdentity(),
+  name: varchar({ length: 255 }).notNull(),
+  age: integer().notNull(),
+  email: varchar({ length: 255 }).notNull().unique(),
+});

package/template/extras/drizzle/drizzle.config.ts

@@ -0,0 +1,15 @@
+import "dotenv/config";
+import { defineConfig } from "drizzle-kit";
+
+if (!process.env.DATABASE_URL) {
+	throw new Error("DATABASE_URL is not set");
+}
+
+export default defineConfig({
+	out: "./drizzle",
+	schema: "./lib/db/schema.ts",
+	dialect: "postgresql",
+	dbCredentials: {
+		url: process.env.DATABASE_URL,
+	},
+});

package/template/extras/neon/index.ts

@@ -0,0 +1,10 @@
+/* Drizzle configuration for Neon */
+import { drizzle } from "drizzle-orm/neon-http";
+import { neon } from "@neondatabase/serverless";
+
+if (!process.env.DATABASE_URL) {
+	throw new Error("DATABASE_URL is not set");
+}
+
+const sql = neon(process.env.DATABASE_URL);
+export const db = drizzle({ client: sql });

package/template/extras/shadcnui/components.json

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

package/template/extras/shadcnui/globals.css

@@ -0,0 +1,71 @@
+@import "tailwindcss";
+@custom-variant dark (&:is(.dark *));
+
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.577 0.245 27.325);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+  --chart-1: oklch(0.646 0.222 41.116);
+  --chart-2: oklch(0.6 0.118 184.704);
+  --chart-3: oklch(0.398 0.07 227.392);
+  --chart-4: oklch(0.828 0.189 84.429);
+  --chart-5: oklch(0.769 0.188 70.08);
+  --sidebar: oklch(0.985 0 0);
+  --sidebar-foreground: oklch(0.145 0 0);
+  --sidebar-primary: oklch(0.205 0 0);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.97 0 0);
+  --sidebar-accent-foreground: oklch(0.205 0 0);
+  --sidebar-border: oklch(0.922 0 0);
+  --sidebar-ring: oklch(0.708 0 0);
+}
+ 
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.922 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.704 0.191 22.216);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+  --chart-1: oklch(0.488 0.243 264.376);
+  --chart-2: oklch(0.696 0.17 162.48);
+  --chart-3: oklch(0.769 0.188 70.08);
+  --chart-4: oklch(0.627 0.265 303.9);
+  --chart-5: oklch(0.645 0.246 16.439);
+  --sidebar: oklch(0.205 0 0);
+  --sidebar-foreground: oklch(0.985 0 0);
+  --sidebar-primary: oklch(0.488 0.243 264.376);
+  --sidebar-primary-foreground: oklch(0.985 0 0);
+  --sidebar-accent: oklch(0.269 0 0);
+  --sidebar-accent-foreground: oklch(0.985 0 0);
+  --sidebar-border: oklch(1 0 0 / 10%);
+  --sidebar-ring: oklch(0.556 0 0);
+}

package/template/extras/stripe/checkout_session/route.ts

@@ -0,0 +1,60 @@
+import { NextResponse } from "next/server";
+/* Here imports are set up for the final project structure, so it's fine  */
+import { stripe } from "@/lib/stripe";
+
+
+const TRIAL_PERIOD_DAYS = 3;
+
+
+export async function GET(req: Request) {
+	try {
+		
+        // Usually you would check for authentication first
+        const fakeUser = {
+            id: "123",
+            email: "test@test.com",
+        }
+
+		const url = new URL(req.url);
+		const priceId = url.searchParams.get("priceId");
+
+		if (!priceId) {
+			return new NextResponse("Price ID is required", { status: 400 });
+		}
+
+        // Set subscription data with trial period, remove if not wanted
+		const subscriptionData: {
+			trial_period_days?: number;
+		} = {
+			trial_period_days: TRIAL_PERIOD_DAYS,
+		};
+
+		// Create Stripe checkout session
+		const checkoutSession = await stripe().checkout.sessions.create({
+			mode: "subscription",
+			payment_method_types: ["card", "paypal"],
+			line_items: [
+				{
+					price: priceId,
+					quantity: 1,
+				},
+			],
+            subscription_data: subscriptionData,
+            // Metadata will be used to identify the user in the webhook
+			metadata: {
+				userId: fakeUser.id,
+			},
+			customer_email: fakeUser.email,
+			success_url: `${process.env.NEXT_PUBLIC_BASE_URL}/success?session_id={CHECKOUT_SESSION_ID}`,
+			cancel_url: `${process.env.NEXT_PUBLIC_BASE_URL}/`,
+		});
+
+		if (!checkoutSession.url) {
+			return new NextResponse("Checkout session URL is missing", { status: 500 });
+		}
+
+		return NextResponse.json({ url: checkoutSession.url });
+	} catch (_) {
+		return new NextResponse("Internal Error", { status: 500 });
+	}
+}

package/template/extras/stripe/stripe.ts

@@ -0,0 +1,17 @@
+import Stripe from "stripe";
+
+let stripeInstance: Stripe | null = null;
+
+const getStripe = () => {
+	if (!stripeInstance) {
+		if (!process.env.STRIPE_SECRET_KEY) {
+			throw new Error("STRIPE_SECRET_KEY is not set");
+		}
+		stripeInstance = new Stripe(process.env.STRIPE_SECRET_KEY, {
+			typescript: true,
+		});
+	}
+	return stripeInstance;
+};
+
+export const stripe = getStripe;