Introduction

This integration requires ArkType to be installed.

The @arkenv/nuxt integration provides end-to-end environment validation for both the server and the browser. It automatically injects your configuration into Nuxt's runtimeConfig, catching configuration bugs early and preventing sensitive server-side variables from ever reaching the client via a custom Vite plugin.

Quickstart

The fastest way to get started is with the ArkEnv CLI. It automatically configures @arkenv/nuxt for your existing Nuxt project.

npx @arkenv/cli@latest init

pnx @arkenv/cli@latest init

yarn dlx @arkenv/cli@latest init

bunx @arkenv/cli@latest init

Layout strategies

ArkEnv supports two layout structures to match your security and developer experience preferences:

Simple layout (recommended)

Define client and server schemas in a single file (env.ts) to prioritize developer experience (DX).

Strict layout

Separate client and server schemas into different files to prioritize strict compile-time security.

Next steps

Zod, Valibot, and other Standard Schema validators

Mix and match ArkType with Zod, Valibot, or other Standard Schema compatible libraries.

Nuxt configuration guide

Read the official Nuxt documentation on how environment variables and runtime configuration work.