#Переменные окружения

Addfox поддерживает управление переменными окружения через файлы .env, которые можно безопасно использовать в клиентском коде.

#Базовое использование

Создайте файл .env в корне проекта:

# .env
ADDFOX_PUBLIC_API_URL=https://api.example.com
ADDFOX_PUBLIC_APP_NAME=My Extension
ADDFOX_PRIVATE_API_KEY=secret_key_here

#Префикс по умолчанию

Addfox по умолчанию экспонирует только переменные окружения, начинающиеся с ADDFOX_PUBLIC_:

// app/popup/index.tsx
console.log(process.env.ADDFOX_PUBLIC_API_URL);   // ✅ "https://api.example.com"
console.log(process.env.ADDFOX_PUBLIC_APP_NAME);  // ✅ "My Extension"
console.log(process.env.ADDFOX_PRIVATE_API_KEY);  // ❌ undefined
console.log(process.env.PRIVATE_API_KEY);         // ❌ undefined

#Область действия

Переменные окружения внедряются во все клиентские entry:

• background — Service Worker / Background script
• content — Content Script
• popup — Всплывающее окно
• options — Страница настроек
• sidepanel — Боковая панель
• devtools — Инструменты разработчика

#Встроенные переменные

Addfox автоматически внедряет следующие встроенные переменные, без необходимости определения в .env:

#Разные окружения

#Окружение разработки

Создайте .env.development:

# .env.development
ADDFOX_PUBLIC_API_URL=http://localhost:3000
ADDFOX_PUBLIC_DEBUG=true

#Продакшн окружение

Создайте .env.production:

# .env.production
ADDFOX_PUBLIC_API_URL=https://api.example.com
ADDFOX_PUBLIC_DEBUG=false

#Приоритет файлов окружения

1. .env.{mode}.local — локальный специфический режим (наивысший приоритет, не коммитится в Git)
2. .env.{mode} — специфический режим
3. .env.local — локальное окружение (не коммитится в Git)
4. .env — по умолчанию (низший приоритет)

#Полный пример

# .env
ADDFOX_PUBLIC_API_URL=https://api.example.com
ADDFOX_PUBLIC_FEATURE_FLAG=true
ADDFOX_PRIVATE_DATABASE_URL=secret

// addfox.config.ts
export default defineConfig({
  manifest: {
    name: process.env.ADDFOX_PUBLIC_APP_NAME || "My Extension",
  },
});

// app/popup/index.tsx
const apiUrl = process.env.ADDFOX_PUBLIC_API_URL;
const showFeature = process.env.ADDFOX_PUBLIC_FEATURE_FLAG === "true";

#Примечания

• Значения переменных окружения всегда строки
• Булевы значения требуют ручного преобразования: process.env.ADDFOX_PUBLIC_DEBUG === "true"
• После изменения файла .env необходимо перезапустить сервер разработки
• Не используйте переменные без префикса ADDFOX_PUBLIC_ в клиентском коде, они будут undefined