@arkenv/standard

@arkenv/standard is the Standard Schema validation engine. It validates environment variables with any Standard Schema validator (Zod, Valibot, and others). The root import has no runtime dependencies or peers.

• If you use ArkType, use @arkenv/core. It also supports Zod and Valibot. You do not need to install both engines.
• If you don't use ArkType, use @arkenv/standard. This will keep your tree free of the arktype dependency.

TypeScript must use moduleResolution: "bundler" | "node16" | "nodenext".

Installation

npm install @arkenv/standard

pnpm add @arkenv/standard

yarn add @arkenv/standard

bun install @arkenv/standard

Usage

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

export const env = arkenv({
  PORT: z.int().min(0).max(65535).default(3000),
  DATABASE_URL: z.url(),
  NODE_ENV: z.enum(["development", "production", "test"]).default("development"),
});

Compared to @arkenv/core

Both engines share arkenv() options, errors, and framework plugins. They differ in schema style and peers.

Exports

These are the public names from @arkenv/standard.

Subpaths

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

const result = arkenv(
  { PORT: z.coerce.number() },
  { env: { PORT: "invalid" } },
);

if (!result.success) {
  console.error(result.issues);
}

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

export const env = arkenv({
  PORT: v.optional(v.number(), 3000),
});

Framework /standard subpaths

Next.js, Nuxt, Vite, and Bun ship /standard (and related) entries that pair with this package. See each package reference for import paths.

Next steps