.envrc

# ============================================================================
# Mantle Development Environment Setup (.envrc)
# ============================================================================
# This file automatically sets up the development environment when you enter
# the project directory. It ensures Node.js, pnpm, and dependencies are ready.
#
# Prerequisites: direnv must be installed and allowed (`direnv allow`)
# ============================================================================

echo "Starting environment loading…"
START_TIME_MS=$(perl -MTime::HiRes=time -e 'printf "%.0f\n", time * 1000')

# ============================================================================
# DIRENV CONFIGURATION
# ============================================================================
# Disable direnv timeout warnings that can appear during long setup operations
# References:
# - https://github.com/direnv/direnv/issues/419#issuecomment-442005962
# - https://direnv.net/man/direnv.toml.1.html#codewarntimeoutcode
export DIRENV_WARN_TIMEOUT=876000h # 100 years in hours (effectively disabled)

# ============================================================================
# NODE VERSION MANAGER (FNM) SETUP
# ============================================================================
# Fast Node Manager (fnm) handles Node.js version switching based on .nvmrc

# Detect operating system for cross-platform fnm path resolution
OS="$(uname -s)"
case "${OS}" in
   MINGW* | Win*) OS="Windows" ;;
esac

# Set FNM_PATH based on OS conventions and user preferences
if [ -d "$HOME/.fnm" ]; then
  export FNM_PATH="$HOME/.fnm"
elif [ -n "$XDG_DATA_HOME" ]; then
  export FNM_PATH="$XDG_DATA_HOME/fnm"
elif [ "$OS" = "Darwin" ]; then
  export FNM_PATH="$HOME/Library/Application Support/fnm"
else
  export FNM_PATH="$HOME/.local/share/fnm"
fi

# Auto-install fnm if it's not already installed
if ! command -v fnm &> /dev/null || [ -d "$FNM_PATH" ]; then
	echo "fnm is not installed. Installing fnm…"
  curl -fsSL https://fnm.vercel.app/install | bash -s -- --skip-shell
else
	echo "fnm is already installed."
fi

# Add fnm to PATH so we can use it
export PATH="$FNM_PATH:$PATH"

# Initialize fnm environment (sets up shell integration)
eval "$(fnm env)"

# Install the Node.js version specified in .nvmrc
# This ensures everyone uses the same Node.js version
fnm use --install-if-missing

# =============================================================================
# PACKAGE MANAGER SETUP
# =============================================================================

# Enable pnpm support via corepack (ships with Node.js).
#
# NOTE: We intentionally do NOT run `npm update --global npm` here.
# npm updating itself in-place is inherently unsafe — if the process is
# interrupted (Ctrl+C, broken pipe, direnv timeout), it can leave the fnm
# Node installation in a corrupted state with missing modules like
# `add-rm-pkg-deps.js`. The npm version that ships with the Node version
# specified in .nvmrc is sufficient.
#
# If you need a newer corepack, update it explicitly with:
#   npm install -g corepack@latest
# outside of direnv, when you can supervise the process.

yes | corepack enable pnpm

# Install the specific pnpm version defined in package.json#packageManager
# This ensures everyone uses the exact same package manager version
yes | corepack install

# ============================================================================
# TELEMETRY AND PRIVACY SETTINGS
# ============================================================================
# Disable telemetry collection for various tools to improve privacy and performance
export DO_NOT_TRACK=1                    # Universal opt-out signal
export TURBO_TELEMETRY_DISABLED=1        # Turborepo telemetry
export VERCEL_TELEMETRY_DISABLED=1       # Vercel CLI telemetry
export TURBO_TEAM="ngrok-frontend"       # Set Turborepo team for remote caching

[[ -f .envrc.local ]] && source_env .envrc.local

# =============================================================================
# DEPENDENCY INSTALLATION
# =============================================================================

# Install all workspace dependencies
# This includes all apps and packages in the monorepo
pnpm install

# ============================================================================
# ENVIRONMENT READY CONFIRMATION
# ============================================================================
# Display setup completion status and timing information
pnpm_version=$(pnpm --version)
echo -e "\nEnvironment is ready.\nUsing pnpm version: $pnpm_version\n"

END_TIME_MS=$(perl -MTime::HiRes=time -e 'printf "%.0f\n", time * 1000')
ELAPSED_TIME=$(bc <<< "scale=3; ($END_TIME_MS - $START_TIME_MS) / 1000")
echo -e "direnv environment setup took $ELAPSED_TIME s.\n"

# =============================================================================
# WHAT HAPPENS NEXT
# =============================================================================
# After this completes, you can:
# - `pnpm -w run start` - Start the doc site development server
# - `pnpm -w run build` - Build all packages and apps
# - `pnpm -w run test` - Run all tests
# - See AGENT.md for more commands and workflows
# =============================================================================

# ============================================================================
# FIRST-TIME SETUP GUIDANCE
# ============================================================================
# Show helpful next steps only on the first run
FIRST_RUN_MARKER=".direnv-initialized"

if [ ! -f "$FIRST_RUN_MARKER" ]; then
  echo "============================================================================"
  echo "🎉 Welcome to Mantle! Here's what you can do next:"
  echo "============================================================================"
  echo ""
  echo "📖 Start the documentation site:"
  echo "   pnpm -w run start"
  echo ""
  echo "🔨 Build everything:"
  echo "   pnpm -w run build"
  echo ""
  echo "🧪 Run tests:"
  echo "   pnpm -w run test"
  echo ""
  echo "📋 Check types:"
  echo "   pnpm -w run typecheck"
  echo ""
  echo "✨ Format & lint:"
  echo "   pnpm -w run fmt"
  echo ""
  echo "📚 Full documentation: https://mantle.ngrok.com"
  echo "📄 See README.md and AGENT.md for more details"
  echo ""
  echo "============================================================================"
  
  # Create marker file to indicate setup has been completed
  touch "$FIRST_RUN_MARKER"
fi