feat: t3 env addon (#83)

t3 env addon

Author: FatahChan

packages/cta-engine/templates/react/add-on/t3env/README.md

@@ -0,0 +1,16 @@
+## T3Env
+
+- You can use T3Env to add type safety to your environment variables.
+- Add Environment variables to the `src/env.mjs` file.
+- Use the environment variables in your code.
+
+### Usage
+
+```ts
+import { env } from "@/env";
+
+console.log(env.VITE_APP_TITLE);
+```
+
+
+

packages/cta-engine/templates/react/add-on/t3env/assets/src/env.ts

@@ -0,0 +1,39 @@
+import { createEnv } from "@t3-oss/env-core";
+import { z } from "zod";
+ 
+export const env = createEnv({
+  server: {
+    SERVER_URL: z.string().url().optional(),
+  },
+ 
+  /**
+   * The prefix that client-side variables must have. This is enforced both at
+   * a type-level and at runtime.
+   */
+  clientPrefix: "VITE_",
+ 
+  client: {
+    VITE_APP_TITLE: z.string().min(1).optional(),
+  },
+ 
+  /**
+   * What object holds the environment variables at runtime. This is usually
+   * `process.env` or `import.meta.env`.
+   */
+  runtimeEnv: import.meta.env,
+ 
+  /**
+   * By default, this library will feed the environment variables directly to
+   * the Zod validator.
+   *
+   * This means that if you have an empty string for a value that is supposed
+   * to be a number (e.g. `PORT=` in a ".env" file), Zod will incorrectly flag
+   * it as a type mismatch violation. Additionally, if you have an empty string
+   * for a value that is supposed to be a string with a default value (e.g.
+   * `DOMAIN=` in an ".env" file), the default value will never be applied.
+   *
+   * In order to solve these issues, we recommend that all new projects
+   * explicitly specify this option as true.
+   */
+  emptyStringAsUndefined: true,
+});

packages/cta-engine/templates/react/add-on/t3env/info.json

@@ -0,0 +1,10 @@
+{
+  "name": "T3Env",
+  "description": "Add type safety to your environment variables",
+  "phase": "add-on",
+  "link": "https://github.com/t3-oss/t3-env",
+  "templates": [
+    "file-router",
+    "code-router"
+  ]
+}

packages/cta-engine/templates/react/add-on/t3env/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "zod": "^3.24.2",
+    "@t3-oss/env-core": "^0.12.0"
+  }
+}

packages/cta-engine/templates/solid/add-on/t3env/README.md

@@ -0,0 +1,16 @@
+## T3Env
+
+- You can use T3Env to add type safety to your environment variables.
+- Add Environment variables to the `src/env.mjs` file.
+- Use the environment variables in your code.
+
+### Usage
+
+```ts
+import { env } from "@/env";
+
+console.log(env.VITE_APP_TITLE);
+```
+
+
+

packages/cta-engine/templates/solid/add-on/t3env/assets/src/env.ts

@@ -0,0 +1,39 @@
+import { createEnv } from "@t3-oss/env-core";
+import { z } from "zod";
+ 
+export const env = createEnv({
+  server: {
+    SERVER_URL: z.string().url().optional(),
+  },
+ 
+  /**
+   * The prefix that client-side variables must have. This is enforced both at
+   * a type-level and at runtime.
+   */
+  clientPrefix: "VITE_",
+ 
+  client: {
+    VITE_APP_TITLE: z.string().min(1).optional(),
+  },
+ 
+  /**
+   * What object holds the environment variables at runtime. This is usually
+   * `process.env` or `import.meta.env`.
+   */
+  runtimeEnv: import.meta.env,
+ 
+  /**
+   * By default, this library will feed the environment variables directly to
+   * the Zod validator.
+   *
+   * This means that if you have an empty string for a value that is supposed
+   * to be a number (e.g. `PORT=` in a ".env" file), Zod will incorrectly flag
+   * it as a type mismatch violation. Additionally, if you have an empty string
+   * for a value that is supposed to be a string with a default value (e.g.
+   * `DOMAIN=` in an ".env" file), the default value will never be applied.
+   *
+   * In order to solve these issues, we recommend that all new projects
+   * explicitly specify this option as true.
+   */
+  emptyStringAsUndefined: true,
+});

packages/cta-engine/templates/solid/add-on/t3env/info.json

@@ -0,0 +1,10 @@
+{
+  "name": "T3Env",
+  "description": "Add type safety to your environment variables",
+  "phase": "add-on",
+  "link": "https://github.com/t3-oss/t3-env",
+  "templates": [
+    "file-router",
+    "code-router"
+  ]
+}

packages/cta-engine/templates/solid/add-on/t3env/package.json

@@ -0,0 +1,6 @@
+{
+  "dependencies": {
+    "zod": "^3.24.2",
+    "@t3-oss/env-core": "^0.12.0"
+  }
+}