feat: implement dashboard layout, settings system, and documentation infrastructure

.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)
+# [email protected]
+
+# ── 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
+# [email protected]
+
+# ── 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/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!
 
 ---