env-sync

Narzędzie do automatycznego tworzenia pliku .env.example na podstawie twoich .env. Czyta wszystkie zmienne z plików konfiguracyjnych, usuwa wrażliwe wartości, a następnie dodaje pomocne komentarze wyjaśniające każdą zmienną. Idealne do onboardingu nowych członków zespołu — jedna komenda, zero konfiguracji. Działa z Node.js 18+ i wymaga klucza OpenAI API.

1. Upewnij się, że masz zainstalowany Node.js 18 lub nowszy oraz ustawioną zmienną środowiskową OPENAI_API_KEY z twoim kluczem API OpenAI.

2. Przejdź do katalogu projektu, w którym znajduje się twój plik .env, który chcesz skonwertować.

3. Uruchom komendę npx ai-env-sync bez żadnych parametrów — narzędzie automatycznie przeskanuje wszystkie pliki .env, .env.local i .env.development w bieżącym katalogu.

4. Jeśli chcesz wskazać inny katalog projektu, dodaj ścieżkę jako argument: npx ai-env-sync ./moj-projekt — narzędzie wygeneruje plik .env.example w tym katalogu.

5. Sprawdź wygenerowany plik .env.example — zawiera wszystkie klucze zmiennych z twoich plików, ale bez wrażliwych wartości, zastąpionych placeholderami takimi jak "your_api_key_here", oraz z automatycznie dodanymi komentarzami opisującymi każdą zmienną.

6. Dodaj plik .env.example do kontroli wersji (git) i udostępnij go zespołowi — nowi członkowie mogą skopiować go jako punkt wyjścia do konfiguracji swoich lokalnych zmiennych środowiskowych.