Environment Inspector

UniversalWorks with Expo & React Native CLI

This tool works with both Expo and React Native CLI projects. Just install and go.

The Environment Inspector tool lets you view and validate environment variables in your React Native app. It automatically discovers EXPO_PUBLIC_ prefixed variables and provides validation, type detection, and health monitoring.

Environment Overview

See all env vars at a glance with health score. Quickly spot missing, invalid, and misconfigured variables.

Installation

npm install @buoy-gg/env

After installation, the Environment Inspector will be auto-detected and appear in your FloatingDevTools menu.

Custom Configuration

For more control, use createEnvTool with the envVar builder to define required variables and validation rules:

tsx

import { createEnvTool, envVar } from "@buoy-gg/env";

const envTool = createEnvTool({
  requiredEnvVars: [
    envVar("EXPO_PUBLIC_API_URL").exists(),
    envVar("EXPO_PUBLIC_DEBUG_MODE").withType("boolean").build(),
    envVar("EXPO_PUBLIC_ENVIRONMENT").withValue("development").build(),
    envVar("EXPO_PUBLIC_MAX_RETRIES")
      .withType("number")
      .withDescription("Maximum API retry attempts")
      .build(),
  ],
});

import { createEnvTool, envVar } from "@buoy-gg/env";

const envTool = createEnvTool({
  requiredEnvVars: [
    envVar("EXPO_PUBLIC_API_URL").exists(),
    envVar("EXPO_PUBLIC_DEBUG_MODE").withType("boolean").build(),
    envVar("EXPO_PUBLIC_ENVIRONMENT").withValue("development").build(),
    envVar("EXPO_PUBLIC_MAX_RETRIES")
      .withType("number")
      .withDescription("Maximum API retry attempts")
      .build(),
  ],
});

The envVar Builder

The fluent builder API makes it easy to define environment variable requirements:

tsx

envVar("API_KEY")
  .withType("string")           // Set expected type
  .withValue("sk_test_123")     // Or set expected value
  .withDescription("API Key")   // Add documentation
  .build()                      // Finalize config

// Shorthand for just checking existence
envVar("API_KEY").exists()

envVar("API_KEY")
  .withType("string")           // Set expected type
  .withValue("sk_test_123")     // Or set expected value
  .withDescription("API Key")   // Add documentation
  .build()                      // Finalize config

// Shorthand for just checking existence
envVar("API_KEY").exists()

Supported Types

typescript

type EnvVarType = "string" | "number" | "boolean" | "array" | "object" | "url";

type EnvVarType = "string" | "number" | "boolean" | "array" | "object" | "url";

createEnvTool Options

typescript

createEnvTool({
  name?: string;                    // default: "ENV"
  description?: string;
  colorPreset?: "orange" | "cyan" | "purple" | "pink" | "yellow" | "green"; // default: "green"
  id?: string;                      // default: "env"
  requiredEnvVars?: RequiredEnvVar[];
  enableSharedModalDimensions?: boolean;
});

createEnvTool({
  name?: string;                    // default: "ENV"
  description?: string;
  colorPreset?: "orange" | "cyan" | "purple" | "pink" | "yellow" | "green"; // default: "green"
  id?: string;                      // default: "env"
  requiredEnvVars?: RequiredEnvVar[];
  enableSharedModalDimensions?: boolean;
});

Features

Automatic Discovery - Auto-collects all EXPO_PUBLIC_ prefixed variables
Required Variable Validation - Define which vars must exist with expected values/types
Type Detection - Auto-detects: string, number, boolean, array, object, url, json
Search & Filtering - Real-time search + filters for "All", "Missing", "Issues"
Health Status - Health percentage (0-100%) with HEALTHY/WARNING/ERROR/CRITICAL states
Statistics - Total count, required count, missing count, wrong value/type counts
Copy to Clipboard - Copy any value with one tap

Variable Status Types

Status	Description
required_present	Required var is set and correct
required_missing	Required var is not set
required_wrong_value	Set but doesn't match expected value
required_wrong_type	Set but wrong type
optional_present	Optional var that is set

Validation Visual Indicators

Green - Variable exists and matches expected value/type
Yellow - Variable exists but value/type differs from expected
Red - Required variable is missing

Try It Out

Use the interactive builder below to create your environment validation config. Add variables, configure checks (type, value, description), and export the code directly.

Env Config Builder

Your environment (paste .env or edit)

Required variables (click to toggle)

Click variables above to mark them as required