v1 Roadmap
Up next2
Core1
- Release v1Open
Docs1
- Document v1 announcementOpen
Done114
Core18
- Coercion (string→number, string→boolean, etc.)#228Completed
- Array parsing#574Completed
- Object parsing#575Completed
- Next.js integration#655Completed
- Standard JSON Schema-based coercion#706Completed
- Unify error normalization and formatting#709Completed
- Tighten type inference and remove v1 escape hatches#717Completed
- Distribution integration testing & artifact verification#735Completed
- Rename underlying core function to arkenv and expose as default export#1200Completed
- Move log helpers to @repo/utils and finish console.* migration#1237Completed
- Confirm flat implementation for nuxt#1260Completed
- Injectable logger API across ArkEnv packages#1300Completed
- Make all integrations not require ArkType#1436Completed
- Retry Standard JSON Schema targets and surface converter failures#1665Completed
- Reduce package install sizes monorepo-wide by omitting maps and externalizing core types#1726Completed
- Migrate all packages to pure ESM-only#1751Completed
- RC drop candidates (post-#1906 scan)#1920Completed
- Final v0 parity auditCompleted
Standard5
- Make ArkType optional and support Standard Schema directly (core)#705Completed
- Scope cleanup / refactor extracted from Standard Schema PR#713Completed
- Validator mode (make ArkType optional, support Standard Schema directly)#722Completed
- Simplify coercion: unify ArkType and Standard Schema paths with pre-coercion model#1178Completed
- Revisit Valibot DX so "No boilerplate" stays honest#1586Completed
Integrations39
- Support Bun frontend `process.env` prefixing (e.g. `BUN_PUBLIC_*`)#181Completed
- Vite support#366Completed
- Make plugins work with `standard` validator mode#748Completed
- Adopt the env object as the canonical surface for Vite/Bun (transform design)#1105Completed
- Introduce @arkenv/nuxt package with Nuxt module and codegen#1182Completed
- @arkenv/nextjs: validate environment variables during next build#1229Completed
- @arkenv/nextjs: add codegen: false option to keep validation without file generation#1230Completed
- Nuxt Integration Parity#1241Completed
- Add flat-layout overload and createEnv export to @arkenv/nextjs/standard#1245Completed
- Remove framework /shared exports; keep /client and /server for strict layout#1296Completed
- Auto-extend client env in Nuxt strict layout via virtual module alias#1307Completed
- Virtual codegen modules for Next.js strict layout (env/ stays user-authored only)#1402Completed
- Auto-extend client env in Next.js strict layout via virtual module alias#1403Completed
- Auto-extend shared env in Nuxt strict-layout client entry#1414Completed
- Boot-time coercion into runtime payload + validator-free client env#1424Completed
- Stop re-exporting `type` / `Infer` from framework integrations#1437Completed
- Examples & playgrounds for Standard Mode per integration#1438Completed
- Guard that integration /standard entries never pull arktype#1439Completed
- Optional shared.ts for Nuxt strict auto-extend#1449Completed
- Remove legacy schema/define API surface#1461Completed
- Deepen boot-gate / capture / flat thin-accessor locality#1463Completed
- Inconsistent error message prefixes: validation vs client/server boundary#1558Completed
- Brand boundary access errors as ArkEnvError (#1558 → simplify-docs)#1568Completed
- Rename @arkenv/vite-plugin export from arkenv to arkenvPlugin#1595Completed
- Rename @arkenv/bun-plugin export from arkenv to arkenvPlugin#1596Completed
- Replace dedicated strict layout with a two-module recipe#1634Completed
- Remove dedicated strict layout engine (ADR 0020 / #1634)#1690Completed
- Support Vite 6 Environment API in ssr transform guard#1749Completed
- Remove Next/Nuxt nested bag API and expose/shared aliases#1910Completed
- Remove ArkEnvScript / __arkenv_env__; document Next + Docker#1911Completed
- Remove Next/Nuxt nested bag API and expose/shared aliases#1915Completed
- Document or remove ArkEnvScript / __arkenv_env__#1916Completed
- Remove extractSharedKeys and extractSharedBlock before GA#2006Completed
- Drop public withArkEnv standard flag#2007Completed
- Narrow bundler plugin options to build-time fields#2009Completed
- Collapse bundler plugin exports to arkenvPlugin#2010Completed
- Remove extractClientKeys and extractServerKeys before GA#2021Completed
- Remove unused @arkenv/nuxt/standard/config subpath#2023Completed
- Add react-server conditional export to @arkenv/nextjs/standard#2025Completed
CLI29
- Presets for popular hosting providers#610Completed
- arkenv init: interactive scaffold CLI for onboarding#896Completed
- Refactor CLI scaffolding using Strategy pattern for Validators and Frameworks#1289Completed
- Add clientPrefix to all FrameworkStrategy implementations#1320Completed
- Forward-port hosting presets from #1288#1322Completed
- Generalize CLI --host-preset to --preset#1447Completed
- Hosting presets Phase 4#1452Completed
- CLI managed preset blocks (`preset apply` / `remove`, markers, `--preset`)#1478Completed
- Harden CLI runtime import guard for native ESM and CJS (arkenv)#1589Completed
- Universal --json diagnostics and nextActions envelopes for AI coding agents#1614Completed
- Harden schema capture: fail closed, distinct inspect errors, document env.ts contract#1636Completed
- Remove CLI ambient .d.ts append for Vite/Bun (ImportMetaEnvAugmented / ProcessEnvAugmented)#1699Completed
- Remove programmatic AST schema mutation in favor of init presets and doc snippets#1716Completed
- Narrow arkenv check and drop custom dotenv AST formatting parser#1717Completed
- Ensure safe execution without @latest and omit @latest from marketing#1720Completed
- Drop arkenv example command and add --verify-example check flag#1727Completed
- Centralized release channel config for CLI onboarding commands#1729Completed
- Remove CLI package.json "arkenv" schema pointer#1906Completed
- Stop probing env/server.ts in CLI schema discovery#1913Completed
- Collapse init --host-preset/-H into --preset/-P only#1914Completed
- Stop probing env/server.ts in CLI schema discovery#1918Completed
- Collapse init --host-preset/-H into --preset/-P only#1919Completed
- Remove dead .env.example mutators from CLI workspace port#1931Completed
- Remove phantom CheckInput.file / --file alias from CLI check#1932Completed
- Document or remove skill install during arkenv init#1933Completed
- Drop or finish JS/MJS convention schema discovery#1934Completed
- Remove legacy Refusal.retryWith; keep nextActions only#1935Completed
- Add CLI import guard for v0 upgradesCompleted
- Deprecate @arkenv/cli on npmCompleted
Docs23
- Add root README.md for v1 branch GitHub landing page#1305Completed
- Populate Validating environment variables step-by-step guides#1520Completed
- Populate API reference pages (configuration, commands, packages)#1521Completed
- Populate Core concepts pages#1522Completed
- Populate Framework guides and AI recipes#1523Completed
- Audit internal links after navigation restructure#1524Completed
- Turbo-style page header tagline and overview titles#1525Completed
- Fix mobile docs navigation (header + sidebars)#1529Completed
- Fix bad search UX on mobile for simplify-docs#1546Completed
- Full human editorial sweep of Simplify Docs content#1559Completed
- Populate Getting started pages#1560Completed
- Options.toJsonSchema: Valibot-friendly coercion escape hatch + Validators guides#1564Completed
- Pnpm www exits with "Another next dev server is already running"#1578Completed
- Document DCE trade-offs, SSR execution models, and engine vs adapter boundaries#1597Completed
- Meet the 0-dep getEnv user (snippet + graduation)#1616Completed
- Add TanStack Start recipe and example#1748Completed
- Remove reserved safe?: false from ArkEnvConfig#1912Completed
- Remove reserved safe?: false from ArkEnvConfig#1917Completed
- Move @arkenv/standard issue helpers to /issues#2008Completed
- v0 site Alpha bannerCompleted
- Update README links from alpha to productionCompleted
- Prepend changelog epoch warningsCompleted
- Park v0 on arkenv-v0.vercel.app and point Production at v1Completed