create-blitzpack 0.1.0

package/template/apps/api/.dockerignore

@@ -0,0 +1,51 @@
+# Dependencies
+node_modules
+.pnpm-store
+
+# Build outputs
+dist
+build
+.next
+*.tsbuildinfo
+
+# Development files
+.env
+.env.local
+.env.*.local
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Testing
+coverage
+test-results
+.vitest
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+.DS_Store
+
+# Git
+.git
+.gitignore
+.gitattributes
+
+# Documentation
+*.md
+!README.md
+
+# CI/CD
+.github
+.gitlab-ci.yml
+.travis.yml
+
+# Misc
+.cache
+.temp
+tmp
+temp

package/template/apps/api/.env.local.example

@@ -0,0 +1,62 @@
+NODE_ENV=development
+API_URL=http://localhost:8080
+FRONTEND_URL=http://localhost:3000
+PORT=8080
+
+# Database connection string for local Docker PostgreSQL
+# Match credentials from docker-compose.yml
+# Note: Test database will automatically use app_dev_test (suffix added by test runner)
+DATABASE_URL=postgresql://postgres:postgres_dev_password@localhost:5432/app_dev
+
+
+# Cookie secret for signing cookies
+COOKIE_SECRET=dev-secret-change-in-production-use-random-string
+
+# Logging verbosity level
+# - minimal: Only errors and critical warnings (recommended for production)
+# - normal: Standard HTTP requests, business events, errors (default)
+# - detailed: Include debug info, SQL queries, cache operations
+# - verbose: Everything including request/response bodies, timing breakdowns
+LOG_LEVEL=normal
+
+# Better Auth configuration
+BETTER_AUTH_SECRET=dev-secret-change-in-production-must-be-at-least-32-characters
+# Base URL of your API for Better Auth callbacks
+BETTER_AUTH_URL=http://localhost:8080
+
+
+
+# Email Service Configuration
+# You MUST verify your domain in Resend dashboard before sending emails
+RESEND_API_KEY=re_xxxxxxxxxxxx
+EMAIL_FROM=noreply@yourdomain.com
+
+# OAuth Provider Credentials (Optional but recommended)
+# Google and GitHub OAuth are enabled by default.
+# Google OAuth Setup:
+# 1. Go to: https://console.cloud.google.com/apis/credentials
+# 2. Create OAuth 2.0 Client ID (Web application)
+# 3. Add authorized redirect URI: http://localhost:8080/api/auth/callback/google
+# 4. For production, add: https://<domain>.com/api/auth/callback/google
+GOOGLE_CLIENT_ID=
+GOOGLE_CLIENT_SECRET=
+
+
+# GitHub OAuth Setup:
+# 1. Go to: https://github.com/settings/developers
+# 2. Create new OAuth App
+# 3. Set Authorization callback URL: http://localhost:8080/api/auth/callback/github
+# 4. For production, add: https://<domain>.com/api/auth/callback/github
+GITHUB_CLIENT_ID=
+GITHUB_CLIENT_SECRET=
+
+
+# File Storage Configuration (OPTIONAL)
+# Defaults to local file storage if not configured
+# For S3-compatible storage (AWS S3, Cloudflare R2, MinIO, etc.)
+# STORAGE_TYPE=local
+# S3_BUCKET=
+# S3_REGION=auto
+# S3_ACCESS_KEY_ID=
+# S3_SECRET_ACCESS_KEY=
+# S3_ENDPOINT=https://your-account-id.r2.cloudflarestorage.com

package/template/apps/api/emails/account-deleted-email.tsx

@@ -0,0 +1,69 @@
+import { Link, Text } from '@react-email/components';
+import * as React from 'react';
+
+import { EmailLayout } from './components/email-layout';
+import { emailConfig } from './config';
+
+interface AccountDeletedEmailProps {
+  userEmail: string;
+  deletedAt: string;
+}
+
+export default function AccountDeletedEmail({
+  userEmail = 'user@example.com',
+  deletedAt = new Date().toLocaleString('en-US', {
+    dateStyle: 'medium',
+    timeStyle: 'short',
+  }),
+}: AccountDeletedEmailProps) {
+  const { appName, supportEmail } = emailConfig;
+
+  return (
+    <EmailLayout
+      preview={`Your ${appName} account has been deleted`}
+      heading="Account deleted"
+    >
+      <Text style={paragraph}>
+        Your account (<strong>{userEmail}</strong>) has been permanently deleted
+        on {deletedAt}.
+      </Text>
+
+      <Text style={paragraph}>
+        All your data has been removed from our systems. This action cannot be
+        undone.
+      </Text>
+
+      <Text style={paragraph}>
+        If you didn't request this deletion or believe this was done in error,
+        please contact us immediately at{' '}
+        <Link href={`mailto:${supportEmail}`} style={link}>
+          {supportEmail}
+        </Link>
+        .
+      </Text>
+
+      <Text style={paragraphSmall}>
+        Thank you for being part of {appName}. We're sorry to see you go.
+      </Text>
+    </EmailLayout>
+  );
+}
+
+const paragraph: React.CSSProperties = {
+  color: '#334155',
+  fontSize: '15px',
+  lineHeight: '24px',
+  margin: '0 0 24px',
+};
+
+const paragraphSmall: React.CSSProperties = {
+  color: '#94a3b8',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 0',
+};
+
+const link: React.CSSProperties = {
+  color: '#2563eb',
+  textDecoration: 'underline',
+};

package/template/apps/api/emails/components/email-layout.tsx

@@ -0,0 +1,154 @@
+import {
+  Body,
+  Container,
+  Head,
+  Heading,
+  Hr,
+  Html,
+  Img,
+  Link,
+  Preview,
+  Section,
+  Text,
+} from '@react-email/components';
+import * as React from 'react';
+
+import { emailConfig } from '../config';
+
+interface EmailLayoutProps {
+  preview: string;
+  heading: string;
+  children: React.ReactNode;
+  showFooterLinks?: boolean;
+}
+
+export function EmailLayout({
+  preview,
+  heading,
+  children,
+  showFooterLinks = true,
+}: EmailLayoutProps) {
+  const { appName, logoUrl, primaryColor, supportEmail } = emailConfig;
+
+  return (
+    <Html>
+      <Head />
+      <Preview>{preview}</Preview>
+      <Body style={main}>
+        <Container style={container}>
+          <Section style={logoSection}>
+            {logoUrl ? (
+              <Img src={logoUrl} width="48" height="48" alt={appName} />
+            ) : (
+              <Text style={{ ...logoText, color: primaryColor }}>
+                {appName}
+              </Text>
+            )}
+          </Section>
+
+          <Section style={contentSection}>
+            <Heading style={h1}>{heading}</Heading>
+            {children}
+          </Section>
+
+          <Hr style={hr} />
+
+          <Section style={footer}>
+            {showFooterLinks && (
+              <Text style={footerLinks}>
+                <Link href={`mailto:${supportEmail}`} style={footerLink}>
+                  Contact Support
+                </Link>
+              </Text>
+            )}
+            <Text style={footerText}>
+              © {new Date().getFullYear()} {appName}. All rights reserved.
+            </Text>
+            <Text style={footerMuted}>
+              If you didn't expect this email, you can safely ignore it.
+            </Text>
+          </Section>
+        </Container>
+      </Body>
+    </Html>
+  );
+}
+
+const main: React.CSSProperties = {
+  backgroundColor: '#f8fafc',
+  fontFamily:
+    '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Ubuntu, sans-serif',
+  padding: '40px 0',
+};
+
+const container: React.CSSProperties = {
+  backgroundColor: '#ffffff',
+  margin: '0 auto',
+  maxWidth: '560px',
+  borderRadius: '12px',
+  border: '1px solid #e2e8f0',
+  overflow: 'hidden',
+};
+
+const logoSection: React.CSSProperties = {
+  padding: '32px 40px 24px',
+  textAlign: 'center',
+};
+
+const logoText: React.CSSProperties = {
+  fontSize: '24px',
+  fontWeight: '700',
+  margin: '0',
+  letterSpacing: '-0.5px',
+};
+
+const contentSection: React.CSSProperties = {
+  padding: '0 40px 32px',
+};
+
+const h1: React.CSSProperties = {
+  color: '#0f172a',
+  fontSize: '24px',
+  fontWeight: '600',
+  lineHeight: '32px',
+  margin: '0 0 24px',
+  letterSpacing: '-0.25px',
+};
+
+const hr: React.CSSProperties = {
+  borderColor: '#e2e8f0',
+  borderTop: 'none',
+  margin: '0',
+};
+
+const footer: React.CSSProperties = {
+  padding: '24px 40px',
+  backgroundColor: '#f8fafc',
+};
+
+const footerLinks: React.CSSProperties = {
+  textAlign: 'center',
+  margin: '0 0 16px',
+};
+
+const footerLink: React.CSSProperties = {
+  color: '#64748b',
+  fontSize: '13px',
+  textDecoration: 'underline',
+};
+
+const footerText: React.CSSProperties = {
+  color: '#64748b',
+  fontSize: '13px',
+  lineHeight: '20px',
+  textAlign: 'center',
+  margin: '0 0 8px',
+};
+
+const footerMuted: React.CSSProperties = {
+  color: '#94a3b8',
+  fontSize: '12px',
+  lineHeight: '18px',
+  textAlign: 'center',
+  margin: '0',
+};

package/template/apps/api/emails/config.ts

@@ -0,0 +1,22 @@
+/**
+ * Email template configuration.
+ *
+ * IMPORTANT: Update these values before deploying to production.
+ * The logo must be hosted at a publicly accessible URL.
+ */
+
+export interface EmailConfig {
+  appName: string;
+  websiteUrl: string;
+  supportEmail: string;
+  primaryColor: string;
+  logoUrl: string | undefined;
+}
+
+export const emailConfig: EmailConfig = {
+  appName: 'Your App',
+  websiteUrl: 'https://yourapp.com',
+  supportEmail: 'support@yourapp.com',
+  primaryColor: '#2563eb',
+  logoUrl: undefined,
+};

package/template/apps/api/emails/password-changed-email.tsx

@@ -0,0 +1,88 @@
+import { Button, Text } from '@react-email/components';
+import * as React from 'react';
+
+import { EmailLayout } from './components/email-layout';
+import { emailConfig } from './config';
+
+interface PasswordChangedEmailProps {
+  userEmail: string;
+  changedAt: string;
+  resetPasswordUrl: string;
+}
+
+export default function PasswordChangedEmail({
+  userEmail = 'user@example.com',
+  changedAt = new Date().toLocaleString('en-US', {
+    dateStyle: 'medium',
+    timeStyle: 'short',
+  }),
+  resetPasswordUrl = 'https://yourapp.com/forgot-password',
+}: PasswordChangedEmailProps) {
+  const { appName } = emailConfig;
+
+  return (
+    <EmailLayout
+      preview={`Your ${appName} password was changed`}
+      heading="Your password was changed"
+    >
+      <Text style={paragraph}>
+        The password for your account (<strong>{userEmail}</strong>) was
+        successfully changed on {changedAt}.
+      </Text>
+
+      <Text style={paragraph}>
+        If you made this change, no further action is required.
+      </Text>
+
+      <Text style={warningText}>
+        If you didn't change your password, your account may be compromised.
+        Reset your password immediately:
+      </Text>
+
+      <Button style={dangerButton} href={resetPasswordUrl}>
+        Reset Password
+      </Button>
+
+      <Text style={paragraphSmall}>
+        For security, this email was sent to notify you of account changes.
+      </Text>
+    </EmailLayout>
+  );
+}
+
+const paragraph: React.CSSProperties = {
+  color: '#334155',
+  fontSize: '15px',
+  lineHeight: '24px',
+  margin: '0 0 24px',
+};
+
+const warningText: React.CSSProperties = {
+  color: '#b45309',
+  fontSize: '15px',
+  lineHeight: '24px',
+  margin: '0 0 24px',
+  padding: '16px',
+  backgroundColor: '#fef3c7',
+  borderRadius: '8px',
+  border: '1px solid #fcd34d',
+};
+
+const paragraphSmall: React.CSSProperties = {
+  color: '#94a3b8',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 0',
+};
+
+const dangerButton: React.CSSProperties = {
+  borderRadius: '8px',
+  backgroundColor: '#dc2626',
+  color: '#ffffff',
+  fontSize: '15px',
+  fontWeight: '600',
+  textDecoration: 'none',
+  textAlign: 'center',
+  display: 'inline-block',
+  padding: '12px 32px',
+};

package/template/apps/api/emails/password-reset-email.tsx

@@ -0,0 +1,86 @@
+import { Button, Link, Text } from '@react-email/components';
+import * as React from 'react';
+
+import { EmailLayout } from './components/email-layout';
+import { emailConfig } from './config';
+
+interface PasswordResetEmailProps {
+  resetUrl: string;
+  userEmail: string;
+}
+
+export default function PasswordResetEmail({
+  resetUrl = 'https://example.com/reset-password?token=abc123',
+  userEmail = 'user@example.com',
+}: PasswordResetEmailProps) {
+  const { primaryColor } = emailConfig;
+
+  return (
+    <EmailLayout preview="Reset your password" heading="Reset your password">
+      <Text style={paragraph}>
+        We received a request to reset the password for{' '}
+        <strong>{userEmail}</strong>.
+      </Text>
+
+      <Text style={paragraph}>
+        Click the button below to choose a new password:
+      </Text>
+
+      <Button
+        style={{ ...button, backgroundColor: primaryColor }}
+        href={resetUrl}
+      >
+        Reset Password
+      </Button>
+
+      <Text style={paragraphMuted}>Or copy this link into your browser:</Text>
+      <Link href={resetUrl} style={link}>
+        {resetUrl}
+      </Link>
+
+      <Text style={paragraphSmall}>
+        This link expires in 1 hour. If you didn't request this, you can safely
+        ignore this email — your password won't be changed.
+      </Text>
+    </EmailLayout>
+  );
+}
+
+const paragraph: React.CSSProperties = {
+  color: '#334155',
+  fontSize: '15px',
+  lineHeight: '24px',
+  margin: '0 0 24px',
+};
+
+const paragraphMuted: React.CSSProperties = {
+  color: '#64748b',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 8px',
+};
+
+const paragraphSmall: React.CSSProperties = {
+  color: '#94a3b8',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 0',
+};
+
+const button: React.CSSProperties = {
+  borderRadius: '8px',
+  color: '#ffffff',
+  fontSize: '15px',
+  fontWeight: '600',
+  textDecoration: 'none',
+  textAlign: 'center',
+  display: 'inline-block',
+  padding: '12px 32px',
+};
+
+const link: React.CSSProperties = {
+  color: '#2563eb',
+  fontSize: '13px',
+  textDecoration: 'underline',
+  wordBreak: 'break-all',
+};

package/template/apps/api/emails/verification-email.tsx

@@ -0,0 +1,85 @@
+import { Button, Link, Text } from '@react-email/components';
+import * as React from 'react';
+
+import { EmailLayout } from './components/email-layout';
+import { emailConfig } from './config';
+
+interface VerificationEmailProps {
+  verificationUrl: string;
+  userEmail: string;
+}
+
+export default function VerificationEmail({
+  verificationUrl = 'https://example.com/verify?token=abc123',
+  userEmail = 'user@example.com',
+}: VerificationEmailProps) {
+  const { appName, primaryColor } = emailConfig;
+
+  return (
+    <EmailLayout
+      preview={`Verify your email to get started with ${appName}`}
+      heading="Verify your email"
+    >
+      <Text style={paragraph}>
+        Thanks for signing up! Please verify your email address (
+        <strong>{userEmail}</strong>) to complete your registration.
+      </Text>
+
+      <Button
+        style={{ ...button, backgroundColor: primaryColor }}
+        href={verificationUrl}
+      >
+        Verify Email Address
+      </Button>
+
+      <Text style={paragraphMuted}>Or copy this link into your browser:</Text>
+      <Link href={verificationUrl} style={link}>
+        {verificationUrl}
+      </Link>
+
+      <Text style={paragraphSmall}>
+        This link expires in 24 hours. If you didn't create an account, ignore
+        this email.
+      </Text>
+    </EmailLayout>
+  );
+}
+
+const paragraph: React.CSSProperties = {
+  color: '#334155',
+  fontSize: '15px',
+  lineHeight: '24px',
+  margin: '0 0 24px',
+};
+
+const paragraphMuted: React.CSSProperties = {
+  color: '#64748b',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 8px',
+};
+
+const paragraphSmall: React.CSSProperties = {
+  color: '#94a3b8',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 0',
+};
+
+const button: React.CSSProperties = {
+  borderRadius: '8px',
+  color: '#ffffff',
+  fontSize: '15px',
+  fontWeight: '600',
+  textDecoration: 'none',
+  textAlign: 'center',
+  display: 'inline-block',
+  padding: '12px 32px',
+};
+
+const link: React.CSSProperties = {
+  color: '#2563eb',
+  fontSize: '13px',
+  textDecoration: 'underline',
+  wordBreak: 'break-all',
+};

package/template/apps/api/emails/welcome-email.tsx

@@ -0,0 +1,70 @@
+import { Button, Text } from '@react-email/components';
+import * as React from 'react';
+
+import { EmailLayout } from './components/email-layout';
+import { emailConfig } from './config';
+
+interface WelcomeEmailProps {
+  userName: string;
+  dashboardUrl: string;
+}
+
+export default function WelcomeEmail({
+  userName = 'there',
+  dashboardUrl = 'https://yourapp.com/dashboard',
+}: WelcomeEmailProps) {
+  const { appName, primaryColor } = emailConfig;
+
+  return (
+    <EmailLayout
+      preview={`Welcome to ${appName}! Your account is ready.`}
+      heading={`Welcome to ${appName}!`}
+    >
+      <Text style={paragraph}>Hi {userName},</Text>
+
+      <Text style={paragraph}>
+        Your email has been verified and your account is all set up. We're
+        excited to have you on board.
+      </Text>
+
+      <Text style={paragraph}>Get started by exploring your dashboard:</Text>
+
+      <Button
+        style={{ ...button, backgroundColor: primaryColor }}
+        href={dashboardUrl}
+      >
+        Go to Dashboard
+      </Button>
+
+      <Text style={paragraphSmall}>
+        If you have any questions, just reply to this email — we're here to
+        help.
+      </Text>
+    </EmailLayout>
+  );
+}
+
+const paragraph: React.CSSProperties = {
+  color: '#334155',
+  fontSize: '15px',
+  lineHeight: '24px',
+  margin: '0 0 24px',
+};
+
+const paragraphSmall: React.CSSProperties = {
+  color: '#94a3b8',
+  fontSize: '13px',
+  lineHeight: '20px',
+  margin: '24px 0 0',
+};
+
+const button: React.CSSProperties = {
+  borderRadius: '8px',
+  color: '#ffffff',
+  fontSize: '15px',
+  fontWeight: '600',
+  textDecoration: 'none',
+  textAlign: 'center',
+  display: 'inline-block',
+  padding: '12px 32px',
+};