@envin/cli 1.1.12 → 1.1.14-canary.69df2fd

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @envin/cli
 
+## 1.1.13
+
+### Patch Changes
+
+- [`bfec503`](https://github.com/turbostarter/envin/commit/bfec503f71bbf1efee7c0dffc36bced6df2ee719) Thanks [@Debbl](https://github.com/Debbl)! - migrate to tsdown
+
+- Updated dependencies [[`bfec503`](https://github.com/turbostarter/envin/commit/bfec503f71bbf1efee7c0dffc36bced6df2ee719)]:
+  - envin@1.1.13
+
 ## 1.1.12
 
 ### Patch Changes

package/README.md

@@ -94,6 +94,30 @@ npx @envin/cli@latest dev
 
 This will start a live preview server that will automatically update your environment variables when you change them allowing you to find and fix errors before deploying your app.
 
+### CLI options
+
+```bash
+npx @envin/cli@latest dev [options]
+```
+
+Options:
+- `-c, --config <path>`: explicit path to `env.config.ts`
+- `-e, --env <path...>`: path(s) to `.env` file(s) or directories
+- `-p, --port <port>`: port to run the preview server (default: `3000`)
+- `-v, --verbose`: enable verbose logging
+- `--cascade`: enable workspace env/config cascading
+
+#### Env loading behavior
+
+When `--cascade` is enabled, the CLI:
+- detects the workspace root by walking up from current working directory
+- loads env files from the workspace root first, then the package directory, so package values override root values
+- uses the following precedence within each directory:
+  - `.env` → `.env.local` → `.env.development` → `.env.development.local`
+  - `.env` → `.env.local` → `.env.production` → `.env.production.local`
+
+If `-e` points to a single file, only that file is used. If `-e` points to a directory, only that directory is used. If multiple paths are provided, they must all be files or all be directories. Without `-e` or `--cascade`, the CLI uses the current working directory.
+
 
 ## Contributing