gem-hunter

Typesafe environment variables with ArkType, Zod, or Valibot.

ArkEnv v1 is in RC. Read the release notes and migration guide.

Define your environment variables with a schema. ArkEnv gives you a strongly typed, validated env object you can use everywhere.

import arkenv from "@arkenv/core";

export const env = arkenv({
  DATABASE_URL: "string.url",
  PORT: "0 <= number.integer <= 65535 = 3000",
  CI: "boolean = false",
});

import arkenv from "@arkenv/standard";
import * as z from "zod";

export const env = arkenv({
  DATABASE_URL: z.url(),
  PORT: z.int().min(0).max(65535).default(3000),
  CI: z.boolean().default(false),
});

import arkenv from "@arkenv/standard/valibot";
import * as v from "valibot";

export const env = arkenv({
  DATABASE_URL: v.pipe(v.string(), v.url()),
  PORT: v.optional(
    v.pipe(v.number(), v.integer(), v.minValue(0), v.maxValue(65535)),
    3000,
  ),
  CI: v.optional(v.boolean(), false),
});

• Zero runtime dependencies
• Works in Node.js and all modern browsers
• Tiny: under 3 kB core bundle (gzipped)
• Use your existing TypeScript validator
• No boilerplate
• Automatic coercion
• Fail-fast startup errors with redacted values
• One env object: Next.js, Nuxt, Vite, TanStack Start, SolidStart, and Bun

npx arkenv init

The CLI walks you through setup for an existing project, or starts a new one from an example.

If you love ArkEnv, you can support the project by starring it on GitHub!

You are also welcome to contribute to the project and join the wonderful people who have contributed:

Yam C Borodetsky 💻 💬 🤔 🎨 📖 🐛 💡 🚇 🔌 🔧 ⚠️

Aruay Berdikulova 💻 🤔

David Blass 🤔 🧑‍🏫 💬

Andrei Danciu 🔌 💻

Joakim Carlstein 💻 🔌 📖

RoomWithOutRoof 📖 🔧

Abhimanyu Tiwari 💻 📖 💡 ⚠️ 🔧

We acknowledge the various projects and people that inspired ArkEnv.