.env.example

# rename this file to .env and supply the values listed below
# also make sure they are available to the build tool (e.g., Netlify)
# warning: variables prefixed with NEXT_PUBLIC_ will be made available to client-side code
# be careful not to expose sensitive data (e.g., your Algolia admin key)

# ─── Algolia Search ─────────────────────────────────────────────────────────────
# App ID, search key and base search index name required for search
# You can use the following test keys provided by DocSearch for local development/testing:
# NEXT_PUBLIC_ALGOLIA_APP_ID=R2IYF7ETH7
# NEXT_PUBLIC_ALGOLIA_SEARCH_KEY=599cec31baffa4868cae4e79f180729b
# NEXT_PUBLIC_ALGOLIA_BASE_SEARCH_INDEX_NAME=docsearch
# Replace insertValue with your actual keys for production builds.
# NEXT_PUBLIC_ALGOLIA_APP_ID=insertValue
# NEXT_PUBLIC_ALGOLIA_SEARCH_KEY=insertValue
# NEXT_PUBLIC_ALGOLIA_BASE_SEARCH_INDEX_NAME=insertValue

# ─── API Keys (Main App) ────────────────────────────────────────────────────────

# Github token for read-only use with api functions
# Also used by data-layer - see src/data-layer/.env.example
# GITHUB_TOKEN_READ_ONLY=insertValue

# Etherscan API key (required for gas price table)
# ETHERSCAN_API_KEY=insertValue

# ─── Matomo Analytics ───────────────────────────────────────────────────────────
# URL and site ID required for analytics and A/B testing
NEXT_PUBLIC_MATOMO_URL=
NEXT_PUBLIC_MATOMO_SITE_ID=

# API token for A/B testing experiments
# MATOMO_API_TOKEN=your-matomo-api-token

# Used to avoid loading Matomo in our preview deploys
NEXT_PUBLIC_IS_PREVIEW_DEPLOY=false

# ─── Build Configuration ────────────────────────────────────────────────────────

# Build pages only for the specified langs. Leave it empty to build all the langs
# e.g., `en,fr` will only build English and French pages
# Note: always include `en` as it is the default lang of the site
NEXT_PUBLIC_BUILD_LOCALES=

# If resource constraints are being hit during builds, change LIMIT_CPUS to a
# fixed number of CPUs (e.g., 2) to limit the demand during build time
LIMIT_CPUS=

# Enables the bundle analyzer
ANALYZE=false

# ─── Development ────────────────────────────────────────────────────────────────

# Use mock data for development. Set to "false" to use live data but you must have the
# environment variables set to make api requests
USE_MOCK_DATA=true

# ─── AWS SES (Enterprise Contact Form) ──────────────────────────────────────────
# SES_ACCESS_KEY_ID=your_iam_access_key_id
# SES_SECRET_ACCESS_KEY=your_iam_secret_access_key
# SES_REGION=us-east-2

# ─── Sentry (Error Tracking) ────────────────────────────────────────────────────
# Used by Next.js app for error monitoring
# Also used by data-layer/Trigger.dev - see src/data-layer/.env.example
# NEXT_PUBLIC_SENTRY_DSN=your-sentry-dsn
# NEXT_PUBLIC_CONTEXT=development