Implement user authentication, email flows, and dashboard UI enhancements

.env.example

@@ -1,19 +1,70 @@
-### Variables generated for cloud via npx convex dev
+# ============================================================
+# Sendable - Environment Variables
+# ============================================================
+# Copy this file to .env.local and fill in the values.
+# Variables prefixed with NEXT_PUBLIC_ are exposed to the browser.
+# All other variables are server-side only.
+# ============================================================
+
+# ── Convex ──────────────────────────────────────────────────
+# Generated by `npx convex dev` — replace with your deployment values
 CONVEX_DEPLOYMENT=dev:adjective-animal-123
 NEXT_PUBLIC_CONVEX_URL=https://adjective-animal-123.convex.cloud
+NEXT_PUBLIC_CONVEX_SITE_URL=https://adjective-animal-123.convex.site
 
+# ── Site URL ────────────────────────────────────────────────
+# Must match your deployment URL (used for auth origins, email links, CORS)
+SITE_URL=http://localhost:3000
+NEXT_PUBLIC_SITE_URL=http://localhost:3000
 
-### Variables to be manually set for both cloud and self hosted
-NEXT_PUBLIC_SITE_URL=https://localhost:3000
-SITE_URL=https://localhost:3000
+# ── Auth (Better Auth) ─────────────────────────────────────
+# Generate a random secret: `openssl rand -base64 32`
+BETTER_AUTH_SECRET=your-random-secret-here
 
+# ── Email Provider ──────────────────────────────────────────
+# Which provider to use: "resend" (default) or "smtp"
+# Set to "smtp" for local development with Mailpit/Mailtrap
+EMAIL_PROVIDER=resend
 
-### Variables to be manually set for cloud only
-NEXT_PUBLIC_CONVEX_SITE_URL=https://adjective-animal-123.convex.site
+# ── Resend (production email) ──────────────────────────────
+# Get your API key at https://resend.com/api-keys
+RESEND_API_KEY=re_xxxxxxxxxxxx
+
+# Optional: restrict Resend to only send to this email (useful for free tier)
+# RESEND_VERIFIED_RECIPIENT=your-verified@email.com
+
+# ── SMTP (development / fallback email) ────────────────────
+# For local dev, use Mailpit (localhost:1025) or Mailtrap
+# SMTP_HOST=localhost
+# SMTP_PORT=1025
+# SMTP_USER=
+# SMTP_PASS=
+# SMTP_SECURE=false
+# SMTP_FROM_NAME=Sendable
+# SMTP_FROM_EMAIL=noreply@sendable.dev
+
+# ── OAuth Providers (optional) ─────────────────────────────
+# Uncomment and configure when ready to enable social auth
+
+# GitHub OAuth: https://github.com/settings/developers
+# GITHUB_CLIENT_ID=
+# GITHUB_CLIENT_SECRET=
+
+# Google OAuth: https://console.cloud.google.com/apis/credentials
+# GOOGLE_CLIENT_ID=
+# GOOGLE_CLIENT_SECRET=
+
+# Slack OAuth: https://api.slack.com/apps
+# SLACK_CLIENT_ID=
+# SLACK_CLIENT_SECRET=
 
+# ── Logging (BetterStack / Logtail) ────────────────────────
+# Get your source token at https://logs.betterstack.com/source-tokens
+# When set, production logs are forwarded to BetterStack.
+# When not set, logs only go to console (ideal for local dev).
+# LOGTAIL_SOURCE_TOKEN=
 
-### Variables to be manually set for self hosted only
-# CONVEX_SELF_HOSTED_URL='http://127.0.0.1:3210'
-# CONVEX_SELF_HOSTED_ADMIN_KEY='<replace-with-admin-key>'
-# NEXT_PUBLIC_CONVEX_URL='http://127.0.0.1:3210'
-# NEXT_PUBLIC_CONVEX_SITE_URL='http://127.0.0.1:3211'
+# ── Convex Self-Hosted (optional) ──────────────────────────
+# Only needed if running Convex locally instead of cloud
+# CONVEX_SELF_HOSTED_URL=http://127.0.0.1:3210
+# CONVEX_SELF_HOSTED_ADMIN_KEY=<replace-with-admin-key>

.github/workflows/ci.yml

@@ -10,78 +10,100 @@ jobs:
   lint-and-typecheck:
     name: Lint & Type Check
     runs-on: ubuntu-latest
-
+
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Node.js
+      # Setup pnpm (uses version from package.json automatically)
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      # Setup Node.js
+      - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          cache: 'npm'
+          node-version: 20
+          cache: pnpm
 
+      # Install dependencies
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run ESLint
-        run: npm run lint
+        run: pnpm lint
         continue-on-error: true
 
       - name: Type check frontend
-        run: npx tsc --noEmit
+        run: pnpm exec tsc --noEmit
 
       - name: Type check Convex backend
-        run: npx tsc -p convex --noEmit
+        run: pnpm exec tsc -p convex --noEmit
+
 
   build:
     name: Build Application
     runs-on: ubuntu-latest
     needs: lint-and-typecheck
-
+
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Node.js
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          cache: 'npm'
+          node-version: 20
+          cache: pnpm
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Set up Convex
         env:
           CONVEX_DEPLOY_KEY: ${{ secrets.CONVEX_DEPLOY_KEY }}
           CONVEX_DEPLOYMENT: ${{ secrets.CONVEX_DEPLOYMENT }}
-        run: |
-          npx convex dev --once --configure=new
+        run: pnpm exec convex dev --once --configure=new
 
       - name: Build Next.js
         env:
           CONVEX_DEPLOY_KEY: ${{ secrets.CONVEX_DEPLOY_KEY }}
           CONVEX_DEPLOYMENT: ${{ secrets.CONVEX_DEPLOYMENT }}
-        run: npm run build
+        run: pnpm build
+
 
   check-formatting:
     name: Check Formatting
     runs-on: ubuntu-latest
-
+
+    env:
+      GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Node.js
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          cache: 'npm'
+          node-version: 20
+          cache: pnpm
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Check Prettier formatting
-        run: npx prettier --check "src/**/*.{ts,tsx,js,jsx,json,css,md}" "convex/**/*.{ts,js}"
-        continue-on-error: true
+        run: pnpm exec prettier --check "src/**/*.{ts,tsx,js,jsx,json,css,md}" "convex/**/*.{ts,js}"
+        continue-on-error: true

.github/workflows/welcome.yml

@@ -22,7 +22,7 @@ jobs:
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           issue-message: |
-            **Welcome to Sendable.ai!**
+            **Welcome to Sendable!**
 
             Thank you for opening your first issue!
 
@@ -41,7 +41,7 @@ jobs:
         with:
           repo-token: ${{ secrets.GITHUB_TOKEN }}
           pr-message: |
-            **Welcome to Sendable.ai!**
+            **Welcome to Sendable!**
 
             Thank you for opening your first pull request!
 

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to Sendable.ai
+# Contributing to Sendable
 
-First off, thank you for considering contributing to Sendable.ai! 🎉
+First off, thank you for considering contributing to Sendable! 🎉
 
 The following is a set of guidelines for contributing to this project. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
 
@@ -548,7 +548,7 @@ If you have questions:
 
 ## Thank You!
 
-Your contributions make Sendable.ai better for everyone. We appreciate your time and effort!
+Your contributions make Sendable better for everyone. We appreciate your time and effort!
 
 ---