HagenKit/.env.example at main · Codehagen/HagenKit · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# -----------------------------------------------------------------------------
# Core app URLs & Better Auth configuration
# -----------------------------------------------------------------------------
NEXT_PUBLIC_APP_URL="http://localhost:3000"
BETTER_AUTH_URL="http://localhost:3000/api/auth"
# Generate a secure random string: `openssl rand -hex 32`
BETTER_AUTH_SECRET="replace-with-generated-secret"

# -----------------------------------------------------------------------------
# Database (PostgreSQL / Prisma)
# -----------------------------------------------------------------------------
# Example local connection string – update credentials/host/db as needed.
DATABASE_URL="postgresql://postgres:postgres@localhost:5432/hagenkit"

# -----------------------------------------------------------------------------
# OAuth providers
# -----------------------------------------------------------------------------
GOOGLE_CLIENT_ID="your-google-oauth-client-id"
GOOGLE_CLIENT_SECRET="your-google-oauth-client-secret"

# -----------------------------------------------------------------------------
# Email & notifications (Resend + branding overrides)
# -----------------------------------------------------------------------------
RESEND_API_KEY="re_your_resend_api_key"
EMAIL_FROM="noreply@hagenkit.dev"
EMAIL_FROM_NAME="HagenKit"
SUPPORT_EMAIL="support@hagenkit.dev"

# -----------------------------------------------------------------------------
# Billing Configuration (Optional)
# -----------------------------------------------------------------------------
# QUICK START: Leave billing disabled to run the app immediately
# The app works perfectly without billing configured!
#
# To enable billing:
# 1. Set ENABLE_BILLING=true (both server and client)
# 2. Choose BILLING_PROVIDER (polar or stripe)
# 3. Add provider credentials below
# 4. Run: pnpm test:polar (to verify setup)
# 5. See docs/billing-setup.md for full guide

# Enable/disable billing features (default: false for easy first-time setup)
ENABLE_BILLING=false
NEXT_PUBLIC_ENABLE_BILLING=false

# Billing provider: polar | stripe | none
BILLING_PROVIDER=polar

# -----------------------------------------------------------------------------
# Polar Billing Integration (Only required if ENABLE_BILLING=true)
# -----------------------------------------------------------------------------
# Quick Setup Guide:
# 1. Create account at https://sandbox.polar.sh (for testing)
# 2. Go to Settings > API > Access Tokens
# 3. Create new token → Copy below
# 4. Create products in Products section
# 5. Copy product IDs below
# 6. Run: pnpm test:polar

# Organization access token (starts with "polar_oat_")
POLAR_ACCESS_TOKEN=

# Environment: "sandbox" for testing, "production" for live
POLAR_SERVER=sandbox

# Webhook secret (from Settings > Webhooks) - Optional for local dev
POLAR_WEBHOOK_SECRET=

# Your organization ID (visible in dashboard URL) - Optional
POLAR_ORG_ID=

# Product IDs from your Polar products
# Note: Each billing interval (monthly/yearly) is a separate product in Polar
NEXT_PUBLIC_POLAR_PRO_PRODUCT_ID=
NEXT_PUBLIC_POLAR_STARTER_PRODUCT_ID=

# -----------------------------------------------------------------------------
# Stripe Billing Integration (Future - Only required if BILLING_PROVIDER=stripe)
# -----------------------------------------------------------------------------
# STRIPE_SECRET_KEY=
# NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
# STRIPE_WEBHOOK_SECRET=