create-stackforge 0.0.1

package/templates/auth/clerk.README.md

@@ -0,0 +1,8 @@
+# Clerk
+
+Files:
+- `middleware.*` Clerk middleware
+- `auth/protected.*` example server component
+
+Next steps:
+- Set `CLERK_SECRET_KEY` and `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` in `.env`

package/templates/auth/nextauth-options.js

@@ -0,0 +1,3 @@
+export const authOptions = {
+  providers: []
+};

package/templates/auth/nextauth-options.ts

@@ -0,0 +1,5 @@
+import type { NextAuthOptions } from 'next-auth';
+
+export const authOptions: NextAuthOptions = {
+  providers: []
+};

package/templates/auth/nextauth-protected-page.jsx

@@ -0,0 +1,12 @@
+import { getServerSession } from 'next-auth';
+import { authOptions } from '../../../auth/auth-options';
+
+export default async function ProtectedPage() {
+  const session = await getServerSession(authOptions);
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(session, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/nextauth-protected-page.tsx

@@ -0,0 +1,12 @@
+import { getServerSession } from 'next-auth';
+import { authOptions } from '../../../auth/auth-options';
+
+export default async function ProtectedPage() {
+  const session = await getServerSession(authOptions);
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(session, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/nextauth-protected.jsx

@@ -0,0 +1,12 @@
+import { getServerSession } from 'next-auth';
+import { authOptions } from './auth-options';
+
+export default async function ProtectedPage() {
+  const session = await getServerSession(authOptions);
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(session, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/nextauth-protected.tsx

@@ -0,0 +1,12 @@
+import { getServerSession } from 'next-auth';
+import { authOptions } from './auth-options';
+
+export default async function ProtectedPage() {
+  const session = await getServerSession(authOptions);
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(session, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/nextauth-route.ts

@@ -0,0 +1,6 @@
+import NextAuth from 'next-auth';
+import { authOptions } from '../../../../auth/auth-options';
+
+const handler = NextAuth(authOptions);
+
+export { handler as GET, handler as POST };

package/templates/auth/nextauth-signin.jsx

@@ -0,0 +1,15 @@
+export default function SignInPage() {
+  return (
+    <main>
+      <h1>Sign in</h1>
+      <p>
+        Use the default NextAuth sign-in:
+        <a href="/api/auth/signin"> /api/auth/signin</a>
+      </p>
+      <p>
+        Sign out:
+        <a href="/api/auth/signout"> /api/auth/signout</a>
+      </p>
+    </main>
+  );
+}

package/templates/auth/nextauth-signin.tsx

@@ -0,0 +1,15 @@
+export default function SignInPage() {
+  return (
+    <main>
+      <h1>Sign in</h1>
+      <p>
+        Use the default NextAuth sign-in:
+        <a href="/api/auth/signin"> /api/auth/signin</a>
+      </p>
+      <p>
+        Sign out:
+        <a href="/api/auth/signout"> /api/auth/signout</a>
+      </p>
+    </main>
+  );
+}

package/templates/auth/nextauth.README.md

@@ -0,0 +1,10 @@
+# NextAuth
+
+Files:
+- `auth/auth-options.*` base config
+- `app/api/auth/[...nextauth]/route.*` API route
+- `auth/protected.*` example server component
+
+Next steps:
+- Add providers to `auth/auth-options.*`
+- Set `NEXTAUTH_SECRET` and `NEXTAUTH_URL` in `.env`

package/templates/auth/supabase-protected-page.jsx

@@ -0,0 +1,13 @@
+import { createSupabaseServerClient } from '../../../src/lib/supabase-server';
+
+export default async function ProtectedPage() {
+  const supabase = createSupabaseServerClient();
+  const { data } = await supabase.auth.getUser();
+
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(data, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/supabase-protected-page.tsx

@@ -0,0 +1,13 @@
+import { createSupabaseServerClient } from '../../../src/lib/supabase-server';
+
+export default async function ProtectedPage() {
+  const supabase = createSupabaseServerClient();
+  const { data } = await supabase.auth.getUser();
+
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(data, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/supabase-protected.jsx

@@ -0,0 +1,13 @@
+import { createSupabaseServerClient } from '../src/lib/supabase-server';
+
+export default async function ProtectedPage() {
+  const supabase = createSupabaseServerClient();
+  const { data } = await supabase.auth.getUser();
+
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(data, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/supabase-protected.tsx

@@ -0,0 +1,13 @@
+import { createSupabaseServerClient } from '../src/lib/supabase-server';
+
+export default async function ProtectedPage() {
+  const supabase = createSupabaseServerClient();
+  const { data } = await supabase.auth.getUser();
+
+  return (
+    <div>
+      <h1>Protected</h1>
+      <pre>{JSON.stringify(data, null, 2)}</pre>
+    </div>
+  );
+}

package/templates/auth/supabase-signin.jsx

@@ -0,0 +1,25 @@
+"use client";
+
+import { useState } from 'react';
+import { supabase } from '../../../src/lib/supabase';
+
+export default function SignInPage() {
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+
+  async function handleSubmit(e) {
+    e.preventDefault();
+    await supabase.auth.signInWithPassword({ email, password });
+  }
+
+  return (
+    <main>
+      <h1>Sign in</h1>
+      <form onSubmit={handleSubmit}>
+        <input value={email} onChange={(e) => setEmail(e.target.value)} placeholder="email" />
+        <input value={password} onChange={(e) => setPassword(e.target.value)} type="password" placeholder="password" />
+        <button type="submit">Sign in</button>
+      </form>
+    </main>
+  );
+}

package/templates/auth/supabase-signin.tsx

@@ -0,0 +1,25 @@
+"use client";
+
+import { useState } from 'react';
+import { supabase } from '../../../src/lib/supabase';
+
+export default function SignInPage() {
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    await supabase.auth.signInWithPassword({ email, password });
+  }
+
+  return (
+    <main>
+      <h1>Sign in</h1>
+      <form onSubmit={handleSubmit}>
+        <input value={email} onChange={(e) => setEmail(e.target.value)} placeholder="email" />
+        <input value={password} onChange={(e) => setPassword(e.target.value)} type="password" placeholder="password" />
+        <button type="submit">Sign in</button>
+      </form>
+    </main>
+  );
+}

package/templates/auth/supabase-vite-signin.jsx

@@ -0,0 +1,20 @@
+import { useState } from 'react';
+import { supabase } from '../lib/supabase';
+
+export function SupabaseSignIn() {
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+
+  async function handleSubmit(e) {
+    e.preventDefault();
+    await supabase.auth.signInWithPassword({ email, password });
+  }
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input value={email} onChange={(e) => setEmail(e.target.value)} placeholder="email" />
+      <input value={password} onChange={(e) => setPassword(e.target.value)} type="password" placeholder="password" />
+      <button type="submit">Sign in</button>
+    </form>
+  );
+}

package/templates/auth/supabase-vite-signin.tsx

@@ -0,0 +1,20 @@
+import { useState } from 'react';
+import { supabase } from '../lib/supabase';
+
+export function SupabaseSignIn() {
+  const [email, setEmail] = useState('');
+  const [password, setPassword] = useState('');
+
+  async function handleSubmit(e: React.FormEvent) {
+    e.preventDefault();
+    await supabase.auth.signInWithPassword({ email, password });
+  }
+
+  return (
+    <form onSubmit={handleSubmit}>
+      <input value={email} onChange={(e) => setEmail(e.target.value)} placeholder="email" />
+      <input value={password} onChange={(e) => setPassword(e.target.value)} type="password" placeholder="password" />
+      <button type="submit">Sign in</button>
+    </form>
+  );
+}

package/templates/auth/supabase.README.md

@@ -0,0 +1,9 @@
+# Supabase Auth
+
+Files:
+- `src/lib/supabase.*` client
+- `src/lib/supabase-server.*` server client
+- `auth/protected.*` example server component
+
+Next steps:
+- Set `NEXT_PUBLIC_SUPABASE_URL` and `NEXT_PUBLIC_SUPABASE_ANON_KEY` in `.env`

package/templates/database/drizzle/client.js

@@ -0,0 +1,8 @@
+import { drizzle } from 'drizzle-orm/node-postgres';
+import { Pool } from 'pg';
+
+const pool = new Pool({
+  connectionString: process.env.DATABASE_URL
+});
+
+export const db = drizzle(pool);

package/templates/database/drizzle/client.ts

@@ -0,0 +1,8 @@
+import { drizzle } from 'drizzle-orm/node-postgres';
+import { Pool } from 'pg';
+
+const pool = new Pool({
+  connectionString: process.env.DATABASE_URL
+});
+
+export const db = drizzle(pool);

package/templates/database/drizzle/drizzle.config.ts

@@ -0,0 +1,6 @@
+import type { Config } from 'drizzle-kit';
+
+export default {
+  schema: './drizzle/schema.ts',
+  out: './drizzle/migrations'
+} satisfies Config;

package/templates/database/drizzle/example.js

@@ -0,0 +1,6 @@
+import { db } from './client';
+import { users } from './schema';
+
+export async function listUsers() {
+  return db.select().from(users);
+}

package/templates/database/drizzle/example.ts

@@ -0,0 +1,6 @@
+import { db } from './client';
+import { users } from './schema';
+
+export async function listUsers() {
+  return db.select().from(users);
+}

package/templates/database/drizzle/schema.ts

@@ -0,0 +1,6 @@
+import { pgTable, serial, varchar } from 'drizzle-orm/pg-core';
+
+export const users = pgTable('users', {
+  id: serial('id').primaryKey(),
+  name: varchar('name', { length: 255 }).notNull()
+});

package/templates/database/mongoose/connection.js

@@ -0,0 +1,13 @@
+import mongoose from 'mongoose';
+
+const MONGOOSE_URI = process.env.DATABASE_URL || '';
+
+export async function connectMongoose() {
+  if (!MONGOOSE_URI) {
+    throw new Error('DATABASE_URL is not set');
+  }
+
+  if (mongoose.connection.readyState === 1) return;
+
+  await mongoose.connect(MONGOOSE_URI);
+}

package/templates/database/mongoose/connection.ts

@@ -0,0 +1,13 @@
+import mongoose from 'mongoose';
+
+const MONGOOSE_URI = process.env.DATABASE_URL || '';
+
+export async function connectMongoose(): Promise<void> {
+  if (!MONGOOSE_URI) {
+    throw new Error('DATABASE_URL is not set');
+  }
+
+  if (mongoose.connection.readyState === 1) return;
+
+  await mongoose.connect(MONGOOSE_URI);
+}

package/templates/database/mongoose/model.js

@@ -0,0 +1,7 @@
+import { Schema, model } from 'mongoose';
+
+const userSchema = new Schema({
+  name: { type: String, required: true }
+});
+
+export const User = model('User', userSchema);

package/templates/database/mongoose/model.ts

@@ -0,0 +1,7 @@
+import { Schema, model } from 'mongoose';
+
+const userSchema = new Schema({
+  name: { type: String, required: true }
+});
+
+export const User = model('User', userSchema);

package/templates/database/prisma/client.js

@@ -0,0 +1,3 @@
+import { PrismaClient } from '@prisma/client';
+
+export const prisma = new PrismaClient();

package/templates/database/prisma/client.ts

@@ -0,0 +1,3 @@
+import { PrismaClient } from '@prisma/client';
+
+export const prisma = new PrismaClient();

package/templates/database/prisma/example.js

@@ -0,0 +1,5 @@
+import { prisma } from './client';
+
+export async function listUsers() {
+  return prisma.user.findMany();
+}

package/templates/database/prisma/example.ts

@@ -0,0 +1,7 @@
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+
+export async function listUsers() {
+  return prisma.user.findMany();
+}

package/templates/database/prisma/schema.prisma

@@ -0,0 +1,13 @@
+generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "postgresql"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id   Int    @id @default(autoincrement())
+  name String
+}

package/templates/database/providers/neon.README.md

@@ -0,0 +1,9 @@
+# Neon (Serverless Postgres)
+
+Configure:
+- DATABASE_URL
+- NEON_API_KEY
+- NEON_PROJECT_ID
+
+Notes:
+- Uses @neondatabase/serverless + pg client.

package/templates/database/providers/supabase.README.md

@@ -0,0 +1,9 @@
+# Supabase (Postgres)
+
+Configure:
+- DATABASE_URL
+- SUPABASE_URL
+- SUPABASE_ANON_KEY
+
+Notes:
+- Uses @supabase/supabase-js for client access.

package/templates/database/typeorm/data-source.js

@@ -0,0 +1,15 @@
+import 'reflect-metadata';
+import { DataSource } from 'typeorm';
+import { User } from './entities/User';
+
+const DATABASE_URL = process.env.DATABASE_URL || '';
+
+export const AppDataSource = new DataSource({
+  type: '{{typeormType}}',
+  url: DATABASE_URL,
+  synchronize: false,
+  logging: false,
+  entities: [User],
+  migrations: ['{{migrationsPath}}'],
+  subscribers: []
+});

package/templates/database/typeorm/data-source.ts

@@ -0,0 +1,15 @@
+import 'reflect-metadata';
+import { DataSource } from 'typeorm';
+import { User } from './entities/User';
+
+const DATABASE_URL = process.env.DATABASE_URL || '';
+
+export const AppDataSource = new DataSource({
+  type: '{{typeormType}}',
+  url: DATABASE_URL,
+  synchronize: false,
+  logging: false,
+  entities: [User],
+  migrations: ['{{migrationsPath}}'],
+  subscribers: []
+});

package/templates/database/typeorm/entity.js

@@ -0,0 +1,10 @@
+import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
+
+@Entity()
+export class User {
+  @PrimaryGeneratedColumn()
+  id;
+
+  @Column()
+  name;
+}

package/templates/database/typeorm/entity.ts

@@ -0,0 +1,10 @@
+import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
+
+@Entity()
+export class User {
+  @PrimaryGeneratedColumn()
+  id!: number;
+
+  @Column()
+  name!: string;
+}

package/templates/database/typeorm/migrations/README.md

@@ -0,0 +1,5 @@
+TypeORM migration files will be generated here.
+
+Example:
+- Generate: npx typeorm migration:generate src/db/migrations/Init -d src/db/data-source.ts
+- Run: npx typeorm migration:run -d src/db/data-source.ts

package/templates/database/usage/drizzle-users.js

@@ -0,0 +1,6 @@
+import { db } from '../../drizzle/client';
+import { users } from '../../drizzle/schema';
+
+export async function listUsers() {
+  return db.select().from(users);
+}

package/templates/database/usage/drizzle-users.ts

@@ -0,0 +1,6 @@
+import { db } from '../../drizzle/client';
+import { users } from '../../drizzle/schema';
+
+export async function listUsers() {
+  return db.select().from(users);
+}

package/templates/database/usage/mongoose-users.js

@@ -0,0 +1,5 @@
+import { User } from '../mongoose-model';
+
+export async function listUsers() {
+  return User.find().lean();
+}

package/templates/database/usage/mongoose-users.ts

@@ -0,0 +1,5 @@
+import { User } from '../mongoose-model';
+
+export async function listUsers() {
+  return User.find().lean();
+}

package/templates/database/usage/prisma-users.js

@@ -0,0 +1,5 @@
+import { prisma } from '../prisma';
+
+export async function listUsers() {
+  return prisma.user.findMany();
+}

package/templates/database/usage/prisma-users.ts

@@ -0,0 +1,5 @@
+import { prisma } from '../prisma';
+
+export async function listUsers() {
+  return prisma.user.findMany();
+}

package/templates/database/usage/typeorm-users.js

@@ -0,0 +1,9 @@
+import { AppDataSource } from '../data-source';
+import { User } from '../entities/User';
+
+export async function listUsers() {
+  if (!AppDataSource.isInitialized) {
+    await AppDataSource.initialize();
+  }
+  return AppDataSource.getRepository(User).find();
+}

package/templates/database/usage/typeorm-users.ts

@@ -0,0 +1,9 @@
+import { AppDataSource } from '../data-source';
+import { User } from '../entities/User';
+
+export async function listUsers() {
+  if (!AppDataSource.isInitialized) {
+    await AppDataSource.initialize();
+  }
+  return AppDataSource.getRepository(User).find();
+}

package/templates/features/analytics/README.md

@@ -0,0 +1,9 @@
+# Analytics
+
+This project includes PostHog for analytics.
+
+Configure:
+- Add `NEXT_PUBLIC_POSTHOG_KEY` and `NEXT_PUBLIC_POSTHOG_HOST`
+
+Usage:
+- Import the client from `src/lib/posthog.ts`.

package/templates/features/analytics/posthog.js

@@ -0,0 +1,7 @@
+import posthog from 'posthog-js';
+
+posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY || '', {
+  api_host: process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://app.posthog.com'
+});
+
+export { posthog };

package/templates/features/analytics/posthog.ts

@@ -0,0 +1,9 @@
+import posthog from 'posthog-js';
+
+export function initPosthog() {
+  if (typeof window === 'undefined') return;
+  const key = process.env.NEXT_PUBLIC_POSTHOG_KEY || '';
+  const host = process.env.NEXT_PUBLIC_POSTHOG_HOST || 'https://app.posthog.com';
+  if (!key) return;
+  posthog.init(key, { api_host: host });
+}

package/templates/features/email/README.md

@@ -0,0 +1,17 @@
+# Email (Resend)
+
+## Setup
+1. Add RESEND_API_KEY to .env.
+2. Client lives at src/lib/resend.ts.
+
+## Example
+```ts
+import { resend } from '@/lib/resend';
+
+await resend.emails.send({
+  from: 'you@example.com',
+  to: 'user@example.com',
+  subject: 'Welcome',
+  html: '<strong>Hello</strong>'
+});
+```

package/templates/features/email/resend.js

@@ -0,0 +1,3 @@
+import { Resend } from 'resend';
+
+export const resend = new Resend(process.env.RESEND_API_KEY || '');

package/templates/features/email/resend.ts

@@ -0,0 +1,3 @@
+import { Resend } from 'resend';
+
+export const resend = new Resend(process.env.RESEND_API_KEY || '');