env-typegen-typescript-types-from-env
Automatycznie generuj typy TypeScript z pliku .env – bezpieczne zmienne środowiskowe bez ręcznego pisania
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Env Typegen to narzędzie CLI, które czyta Twój plik .env i automatycznie generuje typy TypeScript. Inteligentnie rozpoznaje liczby, wartości logiczne i adresy URL, tworząc interfejs Env oraz funkcję getEnv() z prawidłową konwersją typów. Możesz też wygenerować schemat Zod do walidacji. Idealne dla projektów Node.js, gdzie chcesz uniknąć błędów typu przy dostępie do zmiennych środowiskowych – wszystko za darmo, bez konfiguracji.
Jak używać
Zainstaluj narzędzie globalnie lub użyj npx: npm install -g @lxgicstudios/env-typegen. Jeśli wolisz nie instalować, możesz uruchamiać polecenia bezpośrednio przez npx @lxgicstudios/env-typegen.
Przygotuj plik .env w katalogu projektu. Narzędzie domyślnie szuka pliku o nazwie .env, ale możesz wskazać inny plik (np. .env.local) jako argument: npx @lxgicstudios/env-typegen .env.local.
Uruchom generator: npx @lxgicstudios/env-typegen. Domyślnie tworzy plik env.d.ts w bieżącym katalogu. Jeśli chcesz zmienić ścieżkę wyjściową, użyj flagi -o, na przykład npx @lxgicstudios/env-typegen -o src/types/env.d.ts.
Wygenerowany plik zawiera interfejs Env z typami dla każdej zmiennej (string, number, boolean), funkcję getEnv() do bezpiecznego dostępu do zmiennych oraz deklarację globalną ProcessEnv. Możesz teraz importować i używać getEnv() w swoim kodzie z pełnym wsparcie typów.
Opcjonalnie: jeśli chcesz dodać walidację Zod, uruchom polecenie z flagą --zod: npx @lxgicstudios/env-typegen --zod. Wygeneruje również schemat Zod do runtime'owej walidacji zmiennych środowiskowych.
Dostosuj nazwę interfejsu, jeśli potrzebujesz, za pomocą flagi --name, na przykład npx @lxgicstudios/env-typegen --name AppConfig. Powtarzaj generator za każdym razem, gdy dodasz nowe zmienne do .env.