SuperAPI AI 工具集

environment-variables

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:为 inbox-zero 项目添加环境变量,覆盖仅服务端使用和客户端(浏览器)使用两类变量。

主要能力与用法:

  1. 在 .env.example 添加变量及示例值,如 NEW_VARIABLE=value_example。
  2. 在 apps/web/env.ts 注册变量校验:服务端变量写入 server 段,如 API_KEY: z.string();客户端变量写入 client 段,并在 experimental__runtimeEnv 同步映射,如 NEXT_PUBLIC_NEW_VARIABLE: process.env.NEXT_PUBLIC_NEW_VARIABLE。
  3. 客户端变量必须以 NEXT_PUBLIC_ 为前缀,且需同时加入 client 与 experimental__runtimeEnv 两处。
  4. 在 turbo.json 的 globalDependencies 相关任务中声明变量,如 "build": { "env": ["NEW_VARIABLE"] }。

示例要点:服务端 API 密钥在 .env.example 写 API_KEY=your_api_key_here,env.ts 的 server 段写 API_KEY: z.string(),turbo.json 的 build.env 加入 API_KEY;客户端功能开关写 NEXT_PUBLIC_FEATURE_ENABLED=false,client 段用 z.coerce.boolean().default(false),experimental__runtimeEnv 与 turbo.json 同步声明。

限制与未提供信息:资料未说明依赖版本、失败处理及验证命令;客户端变量若缺少 NEXT_PUBLIC_ 前缀或遗漏 experimental__runtimeEnv 映射,将无法在浏览器端读取。