fix(standalone): selectively enable vercel speed insights, add annotations for envvars

[waleedlatif1]

Description

• add annotations for environment variables
• selectively enable vercel speed insights

Type of change

• Bug fix (non-breaking change which fixes an issue)

How Has This Been Tested?

N/A

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my own code
• I have commented my code, particularly in hard-to-understand areas
• I have added tests that prove my fix is effective or that my feature works
• All tests pass locally and in CI (bun run test)
• My changes generate no new warnings
• Any dependent changes have been merged and published in downstream modules
• I have updated version numbers as needed (if needed)
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Security Considerations:

• My changes do not introduce any new security vulnerabilities
• I have considered the security implications of my changes

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
sim	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 28, 2025 6:17pm

1 Skipped Deployment

Name	Status	Preview	Comments	Updated (UTC)
docs	⬜️ Skipped (Inspect)			Jul 28, 2025 6:17pm

[greptile-apps]

Greptile Summary

This PR makes the SimStudio application more suitable for standalone deployments by addressing two key issues. First, it adds comprehensive inline documentation to all environment variables in apps/sim/lib/env.ts, transforming an undocumented configuration file into a well-organized reference. The variables are now grouped logically (Core Database & Authentication, Payment & Billing, AI/LLM Provider API Keys, etc.) with clear descriptions of their purpose and usage. This significantly improves the developer experience when setting up the application in different environments.

Second, the PR fixes issues with Vercel-specific analytics components by making them conditional in apps/sim/app/layout.tsx. A new shouldEnableAnalytics() function checks whether the application is running in a Docker build or outside of Vercel's infrastructure (VERCEL_ENV not set) and disables the SpeedInsights and Analytics components accordingly. This prevents errors and unnecessary network requests when deploying the application in non-Vercel environments.

The changes also include a minor refactoring of the getEnv function, removing its explicit return type annotation while maintaining the same functionality, and adding a biome-ignore comment to preserve the aligned formatting structure in the environment configuration.

Confidence score: 5/5

• This PR is very safe to merge and addresses legitimate deployment issues without breaking existing functionality.
• The changes are well-structured documentation improvements and defensive programming practices that prevent runtime errors in different deployment environments.
• All modified files (apps/sim/lib/env.ts and apps/sim/app/layout.tsx) contain straightforward, low-risk changes that improve maintainability and deployment flexibility.

_{2 files reviewed, no comments}

_{Edit Code Review Bot Settings | Greptile}