# =========================================
# Core Configuration
# =========================================

# Enable experimental CorePack feature (optional)
# See more here: https://nodejs.org/api/corepack.html
ENABLE_EXPERIMENTAL_COREPACK=1


# =========================================
# Feature Flags
# =========================================

# Set to true if you want to enable API Reference documentation pages (optional)
ENABLE_API_REFERENCE=false

# Set to true if you want to enable Move Reference documentation (optional)
ENABLE_MOVE_REFERENCE=false


# =========================================
# GitHub Configuration
# =========================================

# GitHub personal access token (optional)
# Set your GitHub Token to allow loading Move Reference from GitHub
# Required only if you need to build Move Reference documentation locally
# Permissions needed: repo, read:packages
# Generate at: https://github.com/settings/tokens
GITHUB_TOKEN=


# =========================================
# Auth Configuration
# =========================================

# Firebase credentials (required for authentication)
# Get these from your Firebase Console -> Project Settings -> General
PUBLIC_FIREBASE_APP_ID=
PUBLIC_FIREBASE_PROJECT_ID=
PUBLIC_FIREBASE_AUTH_DOMAIN=
PUBLIC_FIREBASE_API_KEY=


# =========================================
# Search Configuration
# =========================================

# Algolia search configuration (optional - defaults to Pagefind if not set)
# Get these from your Algolia dashboard at: https://dashboard.algolia.com
# Create a new application or use an existing one
# Under API Keys, you'll find your App ID and Search-Only API Key
ALGOLIA_APP_ID=
ALGOLIA_SEARCH_API_KEY=
# The index name is the unique identifier for your search index
# You can create a new one or use an existing one from your Algolia dashboard
ALGOLIA_INDEX_NAME=

# Which search provider to ship (optional - defaults to "auto")
# auto     - use Algolia only when a build can verify the index above serves
#            results, and Starlight's built-in Pagefind search otherwise
# algolia  - always use Algolia DocSearch, even if the health check fails
# pagefind - always use Starlight's built-in Pagefind search
# Run `pnpm check:search` to see what "auto" would pick and why.
SEARCH_PROVIDER=auto

# Skip the Algolia health check at build time (optional)
# Useful for offline or network-restricted builds. Set to "true" to trust the
# credentials above without probing the index.
SKIP_SEARCH_HEALTH_CHECK=


# =========================================
# Analytics & Tracking Configuration
# =========================================

# Google GTM tracking ID (optional)
# Format: G-XXXXXXXXXX
# Get this from your Google Analytics dashboard
# Used for tracking website traffic and user behavior
GTAG_ID=


# =========================================
# Dynamic OG Image Generation Configuration
# =========================================

# OG Image generation secret (optional)
# This is used for securing the Open Graph image generation
# Generate a secure random string using: 
# node -e "console.log(crypto.randomBytes(16).toString('hex'))"
# Must be at least 32 characters long
OG_IMAGES_SECRET=