# Env Setup

> Scaffolds or audits Zod-validated environment variables for a Next.js service, including src/lib/env.ts, .env.example, scripts/check-env.ts, and pnpm check:env. Use when adding env vars, auditing process.env usage, or aligning with deployment secrets.

- Skill: `joshuashepherd/env-setup` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joshuashepherd/env-setup`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joshuashepherd/env-setup/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra, Web & Frontend, Deployment & Release
- Tags: Env, Environment Variables, Nextjs, Pnpm, Typescript, Zod
- Author: JoshuaShepherd (https://skillmd.com/u/joshuashepherd)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/joshuashepherd/env-setup

---


# Environment setup (Cursor)

## Canonical source

The full workflow (audit grep commands, Next.js 15 `createEnv` patterns, check script) is in **`.claude/skills/env-setup/SKILL.md`**.

## This repo

- Schema: `src/lib/env.ts` (`@t3-oss/env-nextjs` + Zod).
- Example: `.env.example`; local secrets: `.env.local` (gitignored).
- Verify: `pnpm check:env`.

After changes, grep for stray `process.env.` in `src/` and migrate to `env` / `publicEnv`.

**Multi-tenant:** This service requires **`TENANT_ORG_ID`** (UUID). See **`env.TENANT_ORG_ID`** in `src/lib/env.ts` and **`.cursor/rules/multi-tenancy.mdc`**.