Initial commit

templates/env-examples/.dev.vars.example

@@ -0,0 +1,63 @@
+# Clerk Environment Variables for Cloudflare Workers
+#
+# Copy this file to .dev.vars for local development
+# Get your keys from https://dashboard.clerk.com
+
+# ==========================================
+# LOCAL DEVELOPMENT (.dev.vars)
+# ==========================================
+
+# Secret Key (server-side verification)
+CLERK_SECRET_KEY=sk_test_...
+
+# Publishable Key (can be in wrangler.jsonc or here)
+CLERK_PUBLISHABLE_KEY=pk_test_...
+
+# ==========================================
+# PRODUCTION DEPLOYMENT
+# ==========================================
+
+# For production, use wrangler secrets:
+#
+# 1. Set secret key (encrypted, not in wrangler.jsonc):
+#    wrangler secret put CLERK_SECRET_KEY
+#
+# 2. Set publishable key in wrangler.jsonc:
+#    {
+#      "vars": {
+#        "CLERK_PUBLISHABLE_KEY": "pk_live_..."
+#      }
+#    }
+
+# ==========================================
+# SECURITY NOTES
+# ==========================================
+
+# 1. NEVER commit .dev.vars to version control
+#    .dev.vars is in .gitignore by default
+#
+# 2. Use different keys for development and production
+#    - Development: pk_test_... / sk_test_...
+#    - Production: pk_live_... / sk_live_...
+#
+# 3. Production secrets via wrangler secret put
+#    This encrypts secrets, they won't appear in wrangler.jsonc
+#
+# 4. Rotate CLERK_SECRET_KEY if compromised
+#    Generate new keys in Clerk Dashboard
+
+# ==========================================
+# OPTIONAL - Additional Bindings
+# ==========================================
+
+# If your Worker uses other services, add them here:
+# DATABASE_URL=...
+# API_KEY=...
+
+# ==========================================
+# REFERENCE
+# ==========================================
+
+# Official Docs:
+# https://clerk.com/docs/reference/backend/verify-token
+# https://developers.cloudflare.com/workers/wrangler/configuration/

templates/env-examples/.env.local.example

@@ -0,0 +1,89 @@
+# Clerk Environment Variables for Next.js
+#
+# Copy this file to .env.local and fill in your actual values
+# Get your keys from https://dashboard.clerk.com
+
+# ==========================================
+# REQUIRED
+# ==========================================
+
+# Publishable Key (safe to expose to client)
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_...
+
+# Secret Key (NEVER expose to client, server-side only)
+CLERK_SECRET_KEY=sk_test_...
+
+# ==========================================
+# OPTIONAL - Custom Pages
+# ==========================================
+
+# Uncomment to use custom sign-in/sign-up pages
+# NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
+# NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
+
+# ==========================================
+# OPTIONAL - Redirect URLs
+# ==========================================
+
+# Where to redirect after sign-in (forced - always goes here)
+# NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard
+
+# Where to redirect after sign-up (forced - always goes here)
+# NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/onboarding
+
+# Fallback redirect if no forced redirect is set (default: /)
+# NEXT_PUBLIC_CLERK_SIGN_IN_FALLBACK_REDIRECT_URL=/
+# NEXT_PUBLIC_CLERK_SIGN_UP_FALLBACK_REDIRECT_URL=/
+
+# ==========================================
+# OPTIONAL - Webhooks
+# ==========================================
+
+# Webhook signing secret for verifying Clerk webhooks
+# Get this from Clerk Dashboard > Webhooks > Add Endpoint
+# CLERK_WEBHOOK_SIGNING_SECRET=whsec_...
+
+# ==========================================
+# OPTIONAL - Multi-Domain (Satellite Domains)
+# ==========================================
+
+# For multi-domain authentication
+# NEXT_PUBLIC_CLERK_DOMAIN=accounts.yourdomain.com
+# NEXT_PUBLIC_CLERK_IS_SATELLITE=true
+
+# ==========================================
+# OPTIONAL - Advanced Configuration
+# ==========================================
+
+# Custom Clerk JS URL (usually not needed)
+# NEXT_PUBLIC_CLERK_JS_URL=https://...
+
+# Proxy URL for requests (enterprise feature)
+# NEXT_PUBLIC_CLERK_PROXY_URL=https://...
+
+# Disable telemetry
+# CLERK_TELEMETRY_DISABLED=1
+
+# ==========================================
+# SECURITY NOTES
+# ==========================================
+
+# 1. NEVER commit .env.local to version control
+#    Add .env.local to .gitignore
+#
+# 2. Use different keys for development and production
+#    - Development: pk_test_... / sk_test_...
+#    - Production: pk_live_... / sk_live_...
+#
+# 3. NEVER use NEXT_PUBLIC_ prefix for secrets
+#    NEXT_PUBLIC_ variables are exposed to the browser
+#
+# 4. Rotate CLERK_SECRET_KEY if compromised
+#    Generate new keys in Clerk Dashboard
+
+# ==========================================
+# REFERENCE
+# ==========================================
+
+# Official Docs:
+# https://clerk.com/docs/guides/development/clerk-environment-variables

templates/env-examples/.env.local.vite.example

@@ -0,0 +1,46 @@
+# Clerk Environment Variables for React + Vite
+#
+# Copy this file to .env.local and fill in your actual values
+# Get your keys from https://dashboard.clerk.com
+
+# ==========================================
+# REQUIRED
+# ==========================================
+
+# Publishable Key (safe to expose to client)
+# CRITICAL: Must use VITE_ prefix for Vite to expose to client
+VITE_CLERK_PUBLISHABLE_KEY=pk_test_...
+
+# ==========================================
+# SECURITY NOTES
+# ==========================================
+
+# 1. NEVER commit .env.local to version control
+#    Add .env.local to .gitignore
+#
+# 2. Must use VITE_ prefix for client-side variables
+#    Without VITE_ prefix, variable won't be available
+#
+# 3. Only VITE_ prefixed vars are exposed to browser
+#    Never use VITE_ prefix for secrets
+#
+# 4. Restart dev server after changing .env.local
+#    Vite only reads env vars on startup
+#
+# 5. Use different keys for development and production
+#    - Development: pk_test_...
+#    - Production: pk_live_...
+
+# ==========================================
+# ACCESS IN CODE
+# ==========================================
+
+# Use import.meta.env to access:
+# const PUBLISHABLE_KEY = import.meta.env.VITE_CLERK_PUBLISHABLE_KEY
+
+# ==========================================
+# REFERENCE
+# ==========================================
+
+# Vite Env Vars: https://vitejs.dev/guide/env-and-mode.html
+# Clerk Docs: https://clerk.com/docs/references/react/clerk-provider