create-stackr 0.2.0

package/templates/shared/README.md.ejs

@@ -0,0 +1,134 @@
+# <%= projectName %>
+
+Generated with [create-fullstack-app](https://github.com/yourusername/create-fullstack-app)
+
+## Features
+
+<% if (features.onboarding.enabled) { %>- ✅ Onboarding Flow (<%= features.onboarding.pages %> pages)
+<% } %><% if (features.authentication) { %>- ✅ JWT Authentication
+<% } %><% if (features.paywall) { %>- ✅ Subscription Paywall
+<% } %><% if (integrations.revenueCat.enabled) { %>- ✅ RevenueCat Integration
+<% } %><% if (integrations.adjust.enabled) { %>- ✅ Adjust Attribution & Analytics
+<% } %><% if (integrations.scate.enabled) { %>- ✅ Scate User Engagement
+<% } %>
+## Getting Started
+
+### 1. Configure API Keys
+
+```bash
+cp mobile/.env.example mobile/.env
+cp backend/.env.example backend/.env
+# Edit .env files with your API keys
+```
+
+### 2. Start Docker Services
+
+```bash
+./scripts/setup.sh
+```
+
+<% if (platforms.includes('mobile')) { %>
+### 3. Start Mobile App
+
+```bash
+cd mobile
+<%= packageManager %> install
+<%= packageManager %> start
+```
+<% } %>
+<% if (platforms.includes('web')) { %>
+### <%= platforms.includes('mobile') ? '4' : '3' %>. Start Web App
+
+```bash
+cd web
+<%= packageManager %> install
+<%= packageManager %> run dev
+```
+
+The web app will be available at `http://localhost:3000`.
+<% } %>
+
+### <%= platforms.includes('mobile') && platforms.includes('web') ? '5' : platforms.includes('mobile') || platforms.includes('web') ? '4' : '3' %>. Start Backend
+
+```bash
+cd backend
+<%= packageManager %> install
+<%= packageManager %> run dev:rest-api
+```
+
+## Building for Production
+
+This project uses Expo Application Services (EAS) for native builds:
+
+### One-time Setup
+
+1. Install EAS CLI globally:
+   ```bash
+   npm install -g eas-cli
+   ```
+
+2. Create an Expo account and log in:
+   ```bash
+   eas login
+   ```
+
+3. Configure your project:
+   ```bash
+   cd mobile
+   eas build:configure
+   ```
+
+### Building
+
+Build for both iOS and Android:
+```bash
+eas build --platform all
+```
+
+Build for specific platform:
+```bash
+eas build --platform ios
+eas build --platform android
+```
+
+For more information, see the [EAS Build documentation](https://docs.expo.dev/build/introduction/).
+<% if (platforms.includes('web')) { %>
+
+## Web App
+
+The web application is built with:
+- **Next.js 15** - React framework with App Router
+- **TypeScript** - Type safety
+- **Tailwind CSS** - Utility-first styling
+- **shadcn/ui** - UI component library
+
+### Development
+
+```bash
+cd web
+<%= packageManager %> run dev
+```
+
+The web app will be available at `http://localhost:3000`.
+<% } %>
+
+## Project Structure
+
+```
+<%= projectName %>/
+<% if (platforms.includes('mobile')) { %>├── mobile/          # React Native (Expo) mobile app
+<% } %><% if (platforms.includes('web')) { %>├── web/             # Next.js web app
+<% } %>├── backend/         # Node.js backend API
+├── scripts/         # Setup and utility scripts
+└── docker-compose.yml
+```
+
+## Documentation
+
+<% if (platforms.includes('mobile')) { %>- [Mobile App Documentation](./mobile/README.md)
+<% } %><% if (platforms.includes('web')) { %>- [Web App Documentation](./web/README.md)
+<% } %>- [Backend API Documentation](./backend/README.md)
+
+## License
+
+MIT

package/templates/shared/docker-compose.prod.yml.ejs

@@ -0,0 +1,120 @@
+# Simplified Docker Compose for Production Deployment
+# Essential services with basic security practices
+
+version: '3.8'
+
+services:
+<% if (backend.eventQueue) { %>
+  # =============================================================================
+  # Redis Cache & Job Queue (Production)
+  # =============================================================================
+  redis:
+    image: redis:7-alpine
+    container_name: auth_boilerplate_redis_prod
+    restart: always
+    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD}
+    environment:
+      REDIS_PASSWORD: ${REDIS_PASSWORD}
+    ports:
+      - "127.0.0.1:6379:6379"  # Bind to localhost only
+    volumes:
+      - redis_prod_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+        reservations:
+          memory: 256M
+
+<% } %>
+  # =============================================================================
+  # PostgreSQL Database (Production)
+  # =============================================================================
+  database:
+    image: postgres:16-alpine
+    container_name: auth_boilerplate_db_prod
+    restart: always
+    environment:
+      POSTGRES_USER: ${DB_USER:-postgres}
+      POSTGRES_PASSWORD: ${DB_PASSWORD}
+      POSTGRES_DB: ${DB_NAME:-auth_boilerplate}
+    ports:
+      - "127.0.0.1:5432:5432"  # Bind to localhost only
+    volumes:
+      - postgres_prod_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${DB_USER:-postgres} -d ${DB_NAME:-auth_boilerplate}"]
+      interval: 30s
+      timeout: 5s
+      retries: 5
+
+  # =============================================================================
+  # REST API Service (Production)
+  # =============================================================================
+  rest-api:
+    build:
+      context: ./backend
+      target: rest-api-prod
+      dockerfile: Dockerfile
+    container_name: auth_boilerplate_rest_api_prod
+    restart: always
+    environment:
+      NODE_ENV: production
+      DATABASE_URL: postgresql://${DB_USER:-postgres}:${DB_PASSWORD}@database:5432/${DB_NAME:-auth_boilerplate}?schema=public
+      JWT_SECRET: ${JWT_SECRET}
+      API_HOST: 0.0.0.0
+      API_PORT: 8080
+      LOG_LEVEL: ${LOG_LEVEL:-info}
+    ports:
+      - "127.0.0.1:8080:8080"  # Bind to localhost only (use reverse proxy if needed)
+    depends_on:
+      database:
+        condition: service_healthy
+    healthcheck:
+      test: ["CMD", "bun", "-e", "const res = await fetch('http://localhost:8080/'); process.exit(res.ok ? 0 : 1)"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 30s
+
+<% if (backend.eventQueue) { %>
+  # =============================================================================
+  # Event Queue Service (Production)
+  # =============================================================================
+  event-queue:
+    build:
+      context: ./backend
+      target: event-queue-prod
+      dockerfile: Dockerfile
+    container_name: auth_boilerplate_event_queue_prod
+    restart: always
+    environment:
+      NODE_ENV: production
+      DATABASE_URL: postgresql://${DB_USER:-postgres}:${DB_PASSWORD}@database:5432/${DB_NAME:-auth_boilerplate}?schema=public
+      JWT_SECRET: ${JWT_SECRET}
+      LOG_LEVEL: ${LOG_LEVEL:-info}
+      REDIS_HOST: redis
+      REDIS_PORT: 6379
+      REDIS_PASSWORD: ${REDIS_PASSWORD}
+    depends_on:
+      database:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+
+<% } %>
+# =============================================================================
+# Production Volumes
+# =============================================================================
+volumes:
+  postgres_prod_data:
+    driver: local
+<% if (backend.eventQueue) { %>
+  redis_prod_data:
+    driver: local
+<% } %>

package/templates/shared/docker-compose.yml.ejs

@@ -0,0 +1,129 @@
+# Simplified Docker Compose for Backend Development
+# Clean setup with database and microservices
+
+version: '3.8'
+
+services:
+<% if (backend.eventQueue) { %>
+  # =============================================================================
+  # Redis Cache & Job Queue
+  # =============================================================================
+  redis:
+    image: redis:7-alpine
+    container_name: auth_boilerplate_redis
+    restart: unless-stopped
+    command: redis-server --appendonly yes --requirepass ${REDIS_PASSWORD:-redis-password}
+    environment:
+      REDIS_PASSWORD: ${REDIS_PASSWORD:-redis-password}
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    healthcheck:
+      test: ["CMD", "redis-cli", "--raw", "incr", "ping"]
+      interval: 10s
+      timeout: 3s
+      retries: 3
+
+<% } %>
+  # =============================================================================
+  # PostgreSQL Database
+  # =============================================================================
+  database:
+    image: postgres:16-alpine
+    container_name: auth_boilerplate_db
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: ${DB_USER}
+      POSTGRES_PASSWORD: ${DB_PASSWORD}
+      POSTGRES_DB: ${DB_NAME}
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U ${DB_USER} -d ${DB_NAME}"]
+      interval: 10s
+      timeout: 5s
+      retries: 3
+
+  # =============================================================================
+  # REST API Service (Development)
+  # =============================================================================
+  rest-api:
+    build:
+      context: ./backend
+      target: rest-api-dev
+      dockerfile: Dockerfile
+    container_name: auth_boilerplate_rest_api
+    restart: unless-stopped
+    environment:
+      NODE_ENV: development
+      DATABASE_URL: postgresql://${DB_USER}:${DB_PASSWORD}@database:5432/${DB_NAME}?schema=public
+      JWT_SECRET: ${JWT_SECRET}
+      API_HOST: 0.0.0.0
+      API_PORT: 8080
+      LOG_LEVEL: debug
+      # Note: BetterAuth and OAuth config loaded from env_file: ./backend/.env
+    ports:
+      - "8080:8080"
+    volumes:
+      # Hot reload for development
+      - ./backend:/app:cached
+      - /app/node_modules
+<% if (backend.orm === 'prisma') { %>
+      - /app/prisma/generated
+<% } %>
+    depends_on:
+      database:
+        condition: service_healthy
+    # Optional environment file
+    env_file:
+      - ./backend/.env
+
+<% if (backend.eventQueue) { %>
+  # =============================================================================
+  # Event Queue Service (Development)
+  # =============================================================================
+  event-queue:
+    build:
+      context: ./backend
+      target: event-queue-dev
+      dockerfile: Dockerfile
+    container_name: auth_boilerplate_event_queue
+    restart: unless-stopped
+    environment:
+      NODE_ENV: development
+      DATABASE_URL: postgresql://${DB_USER}:${DB_PASSWORD}@database:5432/${DB_NAME}?schema=public
+      JWT_SECRET: ${JWT_SECRET}
+      LOG_LEVEL: debug
+      REDIS_HOST: redis
+      REDIS_PORT: 6379
+      REDIS_PASSWORD: ${REDIS_PASSWORD:-redis-password}
+    volumes:
+      # Hot reload for development
+      - ./backend:/app:cached
+      - /app/node_modules
+<% if (backend.orm === 'prisma') { %>
+      - /app/prisma/generated
+<% } %>
+    depends_on:
+      database:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    # Optional environment file
+    env_file:
+      - ./backend/.env
+
+<% } %>
+# =============================================================================
+# Volumes for data persistence
+# =============================================================================
+volumes:
+  postgres_data:
+    driver: local
+<% if (backend.eventQueue) { %>
+  redis_data:
+    driver: local
+<% } %>