Environment Variables Manager

یہ کیا ہے؟

Environment Variables Manager .env files کے لیے ایک visual editor ہے۔ یہ files configuration values محفوظ کرتی ہیں جن کی آپ کی app کو runtime میں ضرورت ہوتی ہے — جیسے API keys، database connection strings، اور feature flags۔ چونکہ ان میں اکثر secrets ہوتے ہیں، .env files کو Git سے باہر اور source code سے دور رکھا جاتا ہے۔

.env files کو plain text editor میں edit کرنا کام کرتا ہے، لیکن غلطیاں کرنا آسان ہے: کوئی missing quote، ایک stray space، یا غلطی سے فائل کو Git میں Commit کرنا۔ Env Manager ایک صاف table interface دیتا ہے تاکہ آپ variables safely edit، شامل، اور reveal کر سکیں۔

---

Env Manager کھولیں

اسے کھولنے کے دو طریقے ہیں:

• Settings → Environment Variables پر جائیں
• یا project toolbar میں env آئیکن کلک کریں (project پینل کے اوپر کے قریب چھوٹا key آئیکن)

Manager currently active project کے لیے خودکار طریقے سے کھلتا ہے۔

---

Variables دیکھیں اور Edit کریں

Manager آپ کی .env فائل کے تمام key-value pairs ایک table میں display کرتا ہے۔ ہر row بائیں طرف variable نام اور دائیں طرف اس کی value دکھاتی ہے۔

Default میں، values چھپی ہوتی ہیں (dots کے طور پر دکھائی جاتی ہیں، جیسے password field) تاکہ آپ کی screen پر secrets محفوظ رہیں۔ وہ value reveal کرنے کے لیے کسی بھی row پر eye آئیکن کلک کریں، یا ایک ساتھ تمام values reveal کرنے کے لیے column header میں eye آئیکن کلک کریں۔

کوئی value edit کرنے کے لیے، table میں اس پر directly کلک کریں۔ cell editable ہو جاتی ہے — اپنی نئی value ٹائپ کریں اور save کرنے کے لیے Enter دبائیں۔ .env فائل فوری طور پر update ہو جاتی ہے۔

نئی variable شامل کرنے کے لیے، table کے نیچے + بٹن کلک کریں، key نام ٹائپ کریں، Tab دبائیں، value ٹائپ کریں، اور Enter دبائیں۔

---

Per-Project Files

زیادہ تر projects میں ایک سے زیادہ .env فائل ہوتی ہے۔ ایک عام setup یہ ہے:

• .env — shared defaults
• .env.local — آپ کے local overrides (commit نہیں ہوتی)
• .env.production — production values

ان files کے درمیان switch کرنے کے لیے Env Manager کے اوپر file selector dropdown استعمال کریں۔ ہر فائل الگ display اور edit کی جاتی ہے۔

---

Auto-reload

جب آپ Env Manager میں تبدیلی save کرتے ہیں، updated value فوری طور پر فائل میں لکھی جاتی ہے۔ اگر آپ کا dev سرور hot-reload سپورٹ کرتا ہے (مثال کے طور پر، Next.js اور Vite دونوں کرتے ہیں)، تو نئی value سرور restart کیے بغیر pick up ہوگی۔ ایسے servers کے لیے جو environment variables کو hot-reload نہیں کرتے، Terminal میں restart بٹن استعمال کریں۔

---

Security

آپ کی .env files آپ کی local مشین پر رہتی ہیں۔ 1DevTool کبھی بھی environment variable values کو کسی سرور پر upload نہیں کرتا۔

جب آپ کوئی project شامل کرتے ہیں، 1DevTool چیک کرتا ہے کہ آیا .env آپ کے .gitignore میں listed ہے۔ اگر نہیں ہے، تو app اسے خودکار طریقے سے شامل کر دیتا ہے تاکہ آپ غلطی سے secrets Commit کرنے سے بچ سکیں۔

ٹپ: آپ کا AI agent environment variable نام پڑھ سکتا ہے (لیکن values نہیں) تاکہ آپ کے project config کو سمجھ سکے — اس لیے یہ DATABASE_URL استعمال کرنا جانتا ہے بغیر آپ کے اسے explain کیے۔