Validate required env variables on dev server startup #2495
+104
−18
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add validation for INDEXER_URL and INDEXER_V2_URL environment variables in the webpack dev and extension configs. The build will now fail fast with a clear error message if these variables are not defined. Also added documentation to the main README about configuring these environment variables before starting the dev server. Fixes stellar#2489 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
aristidesstaffieri
approved these changes
Jan 6, 2026
CI handles env vars via secrets, so skip the local validation when CI=true is set (standard GitHub Actions environment variable). 🤖 Generated with [Claude Code](https://claude.ai/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
INDEXER_URLandINDEXER_V2_URLenvironment variables in webpack dev and extension configsProblem
When running
yarn startfor local development, the dev server starts successfully even when required environment variables are missing. This leads to confusing runtime errors like "Failed to fetch your account balances" that are difficult to diagnose.Solution
The webpack configs now validate that required environment variables are set before the build starts. If missing, developers see a clear error:
Test plan
extension/.envand runyarn start- should see clear error message.envin place,yarn startshould work as beforeFixes #2489
🤖 Generated with Claude Code