@amirulabu/create-recurring-rabbit-app 0.0.0-alpha

package/templates/default/src/server/db/seed.ts

@@ -0,0 +1,130 @@
+/**
+ * Database Seeding Module
+ *
+ * This module provides functionality to populate the database with initial
+ * sample data for development and testing purposes. It is designed to be
+ * idempotent - running multiple times will not create duplicate records.
+ *
+ * Database Design Decisions:
+ * - Seeds are designed for development environments, not production
+ * - Sample users have verified email addresses for immediate testing
+ * - Uses INSERT with RETURNING to confirm successful inserts
+ * - Handles UNIQUE constraint violations gracefully (idempotent)
+ *
+ * Migration Strategy:
+ * - Run seeding after migrations to ensure schema is ready
+ * - Seed data should be versioned alongside schema changes
+ * - For production, consider using a separate data migration system
+ *
+ * Development vs Production:
+ * - Development:
+ *   - Seeds run automatically on application startup (if configured)
+ *   - Provides realistic test data without manual data entry
+ * - Production:
+ *   - Never run automatic seeds in production
+ *   - Use controlled data migration scripts for production data
+ *   - Seed data should never contain real user credentials
+ *
+ * Seeding Best Practices:
+ * - Keep seeds simple and focused on essential test data
+ * - Make seeds idempotent to allow safe re-running
+ * - Use meaningful sample data that reflects real usage patterns
+ * - Document what data is being seeded for team reference
+ */
+
+import { db } from './index'
+import { users } from './schema'
+
+/**
+ * Seeds the database with sample data for development and testing
+ *
+ * This function creates sample user records in the database. It is designed to be
+ * idempotent - if sample data already exists (same email addresses), it will
+ * gracefully skip insertion without errors.
+ *
+ * Purpose:
+ * - Provide initial data for development and testing environments
+ * - Enable immediate testing without manual data entry
+ * - Ensure consistent test data across different development setups
+ *
+ * Parameters:
+ * - None (uses predefined sample data)
+ *
+ * Return Value:
+ * - Promise<void>: Resolves when seeding completes or is skipped
+ *
+ * Side Effects:
+ * - Inserts sample user records into the users table
+ * - May throw errors for unexpected database failures
+ *
+ * Error Handling:
+ * - UNIQUE constraint violations: Gracefully skipped (seed data exists)
+ * - Other errors: Re-thrown with logging for debugging
+ * - Script exit(1) on unrecoverable errors
+ *
+ * Example Usage:
+ * ```typescript
+ * import { seedDatabase } from './db/seed'
+ *
+ * async function initializeDevEnvironment() {
+ *   await seedDatabase()
+ *   console.log('Development environment ready')
+ * }
+ *
+ * initializeDevEnvironment()
+ * ```
+ *
+ * CLI Usage:
+ * ```bash
+ * # Run seed via npm script
+ * pnpm db:seed
+ *
+ * # Or run directly with Node
+ * node -r dotenv/config dist/db/seed.js
+ * ```
+ *
+ * Notes:
+ * - Seed data is automatically executed when this module is loaded
+ * - Sample users have emailVerified set to true for immediate testing
+ * - Email addresses use example.com domain (reserved for testing)
+ *
+ * @throws {Error} If database connection fails
+ * @throws {Error} If database insert fails for reasons other than UNIQUE constraint
+ */
+export async function seedDatabase() {
+  console.log('Seeding database with sample data...')
+
+  const sampleUsers = [
+    {
+      email: 'demo@example.com',
+      name: 'Demo User',
+      emailVerified: true,
+    },
+    {
+      email: 'test@example.com',
+      name: 'Test User',
+      emailVerified: true,
+    },
+  ]
+
+  try {
+    const result = await (db
+      .insert(users)
+      .values(sampleUsers)
+      .returning() as any)
+    console.log(`✓ Inserted ${result.length} users`)
+    console.log('✓ Database seeded successfully')
+  } catch (error: any) {
+    if (error?.message && error.message.includes('UNIQUE constraint failed')) {
+      console.log('✓ Seed data already exists, skipping...')
+    } else {
+      console.error('Error seeding database:', error)
+      throw error
+    }
+  }
+}
+
+seedDatabase().catch((error) => {
+  console.error('Seed script failed:', error)
+  process.exit(1)
+})

package/templates/default/src/types/global.d.ts

@@ -0,0 +1,25 @@
+declare global {
+  namespace NodeJS {
+    interface ProcessEnv {
+      DATABASE_URL?: string
+      BETTER_AUTH_SECRET: string
+      BETTER_AUTH_URL?: string
+      BETTER_AUTH_EMAIL_PASSWORD?: string
+      RESEND_API_KEY: string
+      PUBLIC_APP_URL?: string
+      NODE_ENV: 'development' | 'test' | 'production'
+    }
+  }
+
+  interface ImportMetaEnv {
+    readonly DEV: boolean
+    readonly MODE: string
+    readonly BASE_URL: string
+  }
+
+  interface ImportMeta {
+    readonly env: ImportMetaEnv
+  }
+}
+
+export {}

package/templates/default/tailwind.config.js

@@ -0,0 +1,46 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: ['class'],
+  content: ['./src/**/*.{ts,tsx}'],
+  theme: {
+    extend: {
+      colors: {
+        border: 'hsl(var(--border))',
+        input: 'hsl(var(--input))',
+        ring: 'hsl(var(--ring))',
+        background: 'hsl(var(--background))',
+        foreground: 'hsl(var(--foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--primary))',
+          foreground: 'hsl(var(--primary-foreground))',
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--secondary))',
+          foreground: 'hsl(var(--secondary-foreground))',
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--destructive))',
+          foreground: 'hsl(var(--destructive-foreground))',
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--muted))',
+          foreground: 'hsl(var(--muted-foreground))',
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--accent))',
+          foreground: 'hsl(var(--accent-foreground))',
+        },
+        card: {
+          DEFAULT: 'hsl(var(--card))',
+          foreground: 'hsl(var(--card-foreground))',
+        },
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)',
+      },
+    },
+  },
+  plugins: [require('tailwindcss-animate')],
+}

package/templates/default/tsconfig.json

@@ -0,0 +1,36 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "allowJs": true,
+    "checkJs": false,
+    "outDir": "./.vinxi/out",
+    "rootDir": "./src",
+    "removeComments": true,
+    "noEmit": true,
+    "importHelpers": true,
+    "downlevelIteration": true,
+    "isolatedModules": true,
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUncheckedIndexedAccess": false,
+    "exactOptionalPropertyTypes": false,
+    "noImplicitOverride": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", ".vinxi"]
+}