Fail-fast environment variable loader and validator for .NET applications.
✔️ Strongly typed
✔️ Blazing fast
✔️ Easy to integrate
✔️ Developer-friendly

Managing environment variables in .NET applications can get messy:

• Manual Environment.GetEnvironmentVariable("XYZ") calls scattered everywhere
• Repetitive null checks and conversions
• Silent runtime errors due to missing configuration

❌ It's easy to miss a critical environment variable.
❌ It's easy to introduce bugs when refactoring or extending the app.

Taviloglu.EnvGuard makes environment variables first-class citizens in your app:

• Strongly typed
• Loaded once at startup
• Fail-fast if missing or invalid
• Easy to find, manage, and document all your configuration

✅ Focus on your application logic, not on plumbing.

• Fail Fast: Application crashes early if required environment variables are missing or invalid.
• Static Strong Typing: Access environment variables like normal properties.
• Supports Common Types: string, int, long, bool, decimal, TimeSpan, Guid.
• Super Fast Access: Hundreds of times faster than repeated Environment.GetEnvironmentVariable calls.
• Developer Friendly: One place to see and manage all your env vars.

Your support helps more people discover the project and keeps it evolving!

dotnet add package Taviloglu.EnvGuard

using Taviloglu.EnvGuard.Base;
using Taviloglu.EnvGuard.Attributes;

public class MyEnvironmentVariables : EnvGuardBase
{
    [EnvGuard("DB_CONNECTION_STRING")]
    public static string DbConnectionString { get; private set; }

    [EnvGuard("ENABLE_FEATURE_X", description:"Enable or disable feature x")]
    public static bool EnableFeatureX { get; private set; }

    [EnvGuard("CACHE_EXPIRATION_SECONDS", isRequired: false)]
    public static int? CacheExpirationSeconds { get; private set; }
}

MyEnvironmentVariables.Load();

var connectionString = MyEnvironmentVariables.DbConnectionString;
if (MyEnvironmentVariables.EnableFeatureX)
{
    // Do something cool
}

We measured access speeds using BenchmarkDotNet:

✅ Static property access is ~202x faster than calling Environment.GetEnvironmentVariable() at runtime!

Benchmark Results Screenshot:

"Finally, a simple and professional way to manage environment variables in .NET! Taviloglu.EnvGuard just makes sense."
— Probably you, after trying it. 😄

If you find Taviloglu.EnvGuard useful, consider supporting it with a one-time sponsorship.
Your support will help to maintain the project, add new features, and keep it free and open source for everyone.

👉 Sponsor with a one-time payment →

Even small contributions make a huge difference!

This project is licensed under the MIT License.

Developed and maintained with ❤️ by Sinan Taviloğlu.