@dotenvx/dotenvx 0.45.0 → 1.0.1

package/README.md

@@ -1,4 +1,4 @@
-![dotenvx](https://dotenvx.com/better-banner.png)
+[![dotenvx](https://dotenvx.com/better-banner.png)](https://dotenvx.com)
 
 *a better dotenv*–from the creator of [`dotenv`](https://github.com/motdotla/dotenv).
 
@@ -9,7 +9,7 @@
  
 
 
-### Quickstart [![NPM version](https://img.shields.io/npm/v/@dotenvx/dotenvx.svg?style=flat-square)](https://www.npmjs.com/package/@dotenvx/dotenvx)
+### Quickstart [![npm version](https://img.shields.io/npm/v/@dotenvx/dotenvx.svg)](https://www.npmjs.com/package/@dotenvx/dotenvx) [![npm installs](https://img.shields.io/npm/dm/@dotenvx/dotenvx)](https://www.npmjs.com/package/@dotenvx/dotenvx)
 
 Install and use it in code just like `dotenv`.
 
@@ -25,16 +25,63 @@ console.log(`Hello ${process.env.HELLO}`)
 
  
 
-Or install globally
+or install globally - *unlocks dotenv for any language, framework, or platform!*
+
+<details><summary>with brew 🍺</summary><br>
 
 ```sh
 brew install dotenvx/brew/dotenvx
+dotenvx help
+```
+
+[![brew installs](https://img.shields.io/github/downloads/dotenvx/dotenvx/total?label=brew%20installs)](https://github.com/dotenvx/homebrew-brew/blob/main/Formula/dotenvx.rb)
+<sup>*homebrew installs sourced from github releases - <a href="https://github.com/dotenvx/homebrew-brew/blob/main/Formula/dotenvx.rb">formula</a></sup>
+
+&nbsp;
+
+</details>
+
+<details><summary>with curl 🌐 </summary><br>
+
+```sh
+curl -sfS https://dotenvx.sh | sh
+dotenvx help
+```
+
+[![mac](https://img.shields.io/endpoint?url=https://dotenvx.sh/stats/curl/darwin&label=mac)](https://github.com/dotenvx/dotenvx.sh/blob/main/install.sh)
+[![linux](https://img.shields.io/endpoint?url=https://dotenvx.sh/stats/curl/linux&label=linux)](https://github.com/dotenvx/dotenvx.sh/blob/main/install.sh)
+[![windows](https://img.shields.io/endpoint?url=https://dotenvx.sh/stats/curl/windows&label=windows)](https://github.com/dotenvx/dotenvx.sh/blob/main/install.sh)
+<sup>*curl installs sourced from npm binary packages - <a href="https://www.npmjs.com/package/@dotenvx/dotenvx-linux-x86_64">example</a></sup>
+
+&nbsp;
+
+</details>
+
+<details><summary>with docker 🐳</summary><br>
+
+```sh
+docker run -it --rm -v $(pwd):/app dotenv/dotenvx help
+```
+
+[![docker pulls](https://img.shields.io/docker/pulls/dotenv/dotenvx)](https://hub.docker.com/r/dotenv/dotenvx)
+
+&nbsp;
+
+</details>
+
+<details><summary>or with github releases 🐙</summary><br>
+
+```sh
+curl -L -o dotenvx.tar.gz "https://github.com/dotenvx/dotenvx/releases/latest/download/dotenvx-$(uname -s)-$(uname -m).tar.gz"
+tar -xzf dotenvx.tar.gz
+./dotenvx help
 ```
-> * [other global ways to install](https://dotenvx.com/docs/install)
->
-> Install globally as a cli to unlock dotenv for ANY language, framework, or platform. 💥
->
-> I am using (and recommending) this approach going forward. – [motdotla](https://github.com/motdotla)
+
+[![github releases](https://img.shields.io/github/downloads/dotenvx/dotenvx/total)](https://github.com/dotenvx/dotenvx/releases)
+<sup>*includes homebrew installs</sup>
+
+</details>
+
 
 &nbsp;
 
@@ -83,7 +130,6 @@ More examples
   ```
 
   </details>
-
 * <details><summary>Deno 🦕</summary><br>
 
   ```sh
@@ -97,6 +143,7 @@ More examples
   Hello World
   ```
 
+  </details>
 * <details><summary>Bun 🥟</summary><br>
 
   ```sh
@@ -110,6 +157,7 @@ More examples
   Hello Test
   ```
 
+  </details>
 * <details><summary>Python 🐍</summary><br>
 
   ```sh
@@ -247,7 +295,6 @@ More examples
   see [docker guide](https://dotenvx.com/docs/platforms/docker)
 
   </details>
-
 * <details><summary>CI/CDs 🐙</summary><br>
 
   ```yaml
@@ -298,7 +345,6 @@ More examples
   see [process manager guides](https://dotenvx.com/docs#process-managers)
 
   </details>
-
 * <details><summary>npx</summary><br>
 
   ```sh
@@ -337,7 +383,6 @@ More examples
   ```
 
   </details>
-
 * <details><summary>Git</summary><br>
 
   ```sh
@@ -512,14 +557,14 @@ More examples
 
 ## Encryption
 
-> Add encryption to your `.env` files with a single command. Pass the `--encrypt` flag.
+> Add encryption to your `.env` files with a single command. Use `dotenvx encrypt`.
 
 ```sh
-$ dotenvx set HELLO World --encrypt
-set HELLO with encryption (.env)
+$ dotenvx encrypt
+✔ encrypted (.env)
 ```
 
-![](https://github.com/dotenvx/dotenvx/assets/3848/21f7a529-7a40-44e4-87d4-a72e1637b702)
+![encrypted .env](https://github.com/dotenvx/dotenvx/assets/3848/2a8c3dc5-cd8e-4a08-8a59-c24d0535c81a)
 
 > A `DOTENV_PUBLIC_KEY` (encryption key) and a `DOTENV_PRIVATE_KEY` (decryption key) are generated using the same public-key cryptography as [Bitcoin](https://en.bitcoin.it/wiki/Secp256k1).
 
@@ -528,7 +573,8 @@ More examples
 * <details><summary>`.env`</summary><br>
 
   ```sh
-  $ dotenvx set HELLO World --encrypt
+  $ echo "HELLO=World" > .env
+  $ dotenvx encrypt
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   $ dotenvx run -- node index.js
@@ -536,10 +582,12 @@ More examples
   Hello World
   ```
 
+  </details>
 * <details><summary>`.env.production`</summary><br>
 
   ```sh
-  $ dotenvx set HELLO Production --encrypt -f .env.production
+  $ echo "HELLO=Production" > .env.production
+  $ dotenvx encrypt -f .env.production
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   $ DOTENV_PRIVATE_KEY_PRODUCTION="<.env.production private key>" dotenvx run -- node index.js
@@ -549,10 +597,12 @@ More examples
 
   Note the `DOTENV_PRIVATE_KEY_PRODUCTION` ends with `_PRODUCTION`. This instructs `dotenvx run` to load the `.env.production` file.
 
+  </details>
 * <details><summary>`.env.ci`</summary><br>
 
   ```sh
-  $ dotenvx set HELLO Ci --encrypt -f .env.ci
+  $ echo "HELLO=Ci" > .env.ci
+  $ dotenvx encrypt -f .env.ci
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   $ DOTENV_PRIVATE_KEY_CI="<.env.ci private key>" dotenvx run -- node index.js
@@ -562,11 +612,12 @@ More examples
 
   Note the `DOTENV_PRIVATE_KEY_CI` ends with `_CI`. This instructs `dotenvx run` to load the `.env.ci` file. See the pattern?
 
+  </details>
 * <details><summary>combine multiple encrypted .env files</summary><br>
 
   ```sh
-  $ dotenvx set HELLO World --encrypt -f .env
-  $ dotenvx set HELLO Production --encrypt -f .env.production
+  $ dotenvx set HELLO World -f .env
+  $ dotenvx set HELLO Production -f .env.production
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   $ DOTENV_PRIVATE_KEY="<.env private key>" DOTENV_PRIVATE_KEY_PRODUCTION="<.env.production private key>" dotenvx run -- node index.js
@@ -576,15 +627,42 @@ More examples
 
   Note the `DOTENV_PRIVATE_KEY` instructs `dotenvx run` to load the `.env` file and the `DOTENV_PRIVATE_KEY_PRODUCTION` instructs it to load the `.env.production` file. See the pattern?
 
+  </details>
+* <details><summary>combine multiple encrypted .env files for monorepo</summary><br>
+
+  ```sh
+  $ mkdir app1
+  $ mkdir app2
+  $ dotenvx set HELLO app1 -f app1/.env.ci
+  $ dotenvx set HELLO app2 -f app2/.env.ci
+  $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
+
+  $ DOTENV_PRIVATE_KEY_CI="<app1/privat ci key>,<app2/private ci key>" dotenvx run -f app1/.env.ci -f app2/.env.ci -- node index.js
+  [dotenvx] injecting env (2) from app1/.env.ci,app2/.env.ci
+  Hello app1
+
+  $ DOTENV_PRIVATE_KEY_CI="<app1/privat ci key>,<app2/private ci key>" dotenvx run -f app1/.env.ci -f app2/.env.ci --overload -- node index.js
+  [dotenvx] injecting env (2) from app1/.env.ci,app2/.env.ci
+  Hello app2
+  ```
+
+  Note the `DOTENV_PRIVATE_KEY_CI` (and any `DOTENV_PRIVATE_KEY*`) can take multiple private keys by simply comma separating them.
+
+  </details>
 * <details><summary>other curves</summary><br>
 
   > `secp256k1` is a well-known and battle tested curve, in use with Bitcoin and other cryptocurrencies, but we are open to adding support for more curves.
   > 
   > If your organization's compliance department requires [NIST approved curves](https://csrc.nist.gov/projects/elliptic-curve-cryptography) or other curves like `curve25519`, please reach out at [security@dotenvx.com](mailto:security@dotenvx.com).
 
+  </details>
+
 &nbsp;
 
-## Advanced usage
+## Advanced
+
+> Become a `dotenvx` power user.
+>
 
 * <details><summary>`run` - Variable Expansion</summary><br>
 
@@ -685,7 +763,7 @@ More examples
 
   ```sh
   $ touch .env
-  $ dotenvx set HELLO encrypted --encrypt
+  $ dotenvx set HELLO encrypted
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   # check your .env.keys files for your privateKey
@@ -701,7 +779,7 @@ More examples
 
   ```sh
   $ touch .env.production
-  $ dotenvx set HELLO "production encrypted" -f .env.production --encrypt
+  $ dotenvx set HELLO "production encrypted" -f .env.production
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   # check .env.keys for your privateKey
@@ -719,7 +797,7 @@ More examples
 
   ```sh
   $ touch .env.ci
-  $ dotenvx set HELLO "ci encrypted" -f .env.production --encrypt
+  $ dotenvx set HELLO "ci encrypted" -f .env.production
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   # check .env.keys for your privateKey
@@ -738,8 +816,8 @@ More examples
   ```sh
   $ touch .env
   $ touch .env.production
-  $ dotenvx set HELLO encrypted --encrypt
-  $ dotenvx set HELLO "production encrypted" -f .env.production --encrypt
+  $ dotenvx set HELLO encrypted
+  $ dotenvx set HELLO "production encrypted" -f .env.production
   $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
 
   # check .env.keys for your privateKeys
@@ -949,24 +1027,12 @@ More examples
   </details>
 * <details><summary>`set KEY value`</summary><br>
 
-  Set a single key/value.
+  Set an encrypted key/value (on by default).
 
   ```sh
   $ touch .env
 
   $ dotenvx set HELLO World
-  set HELLO (.env)
-  ```
-
-  </details>
-* <details><summary>`set KEY value --encrypt`</summary><br>
-
-  Set an encrypted key/value.
-
-  ```sh
-  $ touch .env
-
-  $ dotenvx set HELLO World --encrypt
   set HELLO with encryption (.env)
   ```
 
@@ -978,7 +1044,7 @@ More examples
   ```sh
   $ touch .env.production
 
-  $ dotenvx set HELLO production --encrypt -f .env.production
+  $ dotenvx set HELLO production -f .env.production
   set HELLO with encryption (.env.production)
   ```
 
@@ -991,18 +1057,30 @@ More examples
   $ touch .env.ci
 
   $ dotenvx set HELLO "my ci" -f .env.ci
-  set HELLO (.env.ci)
+  set HELLO with encryption (.env.ci)
   ```
 
   </details>
-* <details><summary>`convert`</summary><br>
+* <details><summary>`set KEY value --plain`</summary><br>
 
-  Convert a `.env` file to an encrypted `.env` file.
+  Set a plaintext key/value.
+
+  ```sh
+  $ touch .env
+
+  $ dotenvx set HELLO World --plain
+  set HELLO (.env)
+  ```
+
+  </details>
+* <details><summary>`encrypt`</summary><br>
+
+  Encrypt the contents of a `.env` file to an encrypted `.env` file.
 
   ```sh
   $ echo "HELLO=World" > .env
 
-  $ dotenvx convert
+  $ dotenvx encrypt
   ✔ encrypted (.env)
   ✔ key added to .env.keys (DOTENV_PRIVATE_KEY)
   ℹ add .env.keys to .gitignore: [echo ".env.keys" >> .gitignore]
@@ -1010,15 +1088,15 @@ More examples
   ```
 
   </details>
-* <details><summary>`convert -f`</summary><br>
+* <details><summary>`encrypt -f`</summary><br>
 
-  Convert a specified `.env` file to an encrypted `.env` file.
+  Encrypt the contents of a specified `.env` file to an encrypted `.env` file.
 
   ```sh
   $ echo "HELLO=World" > .env
   $ echo "HELLO=Production" > .env.production
 
-  $ dotenvx convert -f .env.production
+  $ dotenvx encrypt -f .env.production
   ✔ encrypted (.env.production)
   ✔ key added to .env.keys (DOTENV_PRIVATE_KEY_PRODUCTION)
   ℹ add .env.keys to .gitignore: [echo ".env.keys" >> .gitignore]
@@ -1026,7 +1104,82 @@ More examples
   ```
 
   </details>
-* <details><summary>`ls`</summary><br>
+* <details><summary>`help`</summary><br>
+
+  Output help for `dotenvx`.
+
+  ```sh
+  $ dotenvx help
+  Usage: @dotenvx/dotenvx [options] [command]
+
+  a better dotenv–from the creator of `dotenv`
+
+  Options:
+    -l, --log-level <level>           set log level (default: "info")
+    -q, --quiet                       sets log level to error
+    -v, --verbose                     sets log level to verbose
+    -d, --debug                       sets log level to debug
+    -V, --version                     output the version number
+    -h, --help                        display help for command
+
+  Commands:
+    run [options]                     inject env at runtime [dotenvx run -- yourcommand]
+    get [options] [key]               return a single environment variable
+    set [options] <KEY> <value>       set a single environment variable
+    encrypt [options]                 convert .env file(s) to encrypted .env file(s)
+    pro                               🏆 pro
+    ext                               🔌 extensions
+    help [command]                    display help for command
+  ```
+
+  You can get more detailed help per command with `dotenvx help COMMAND`.
+
+  ```sh
+  $ dotenvx help run
+  Usage: @dotenvx/dotenvx run [options]
+
+  inject env at runtime [dotenvx run -- yourcommand]
+
+  Options:
+    -e, --env <strings...>            environment variable(s) set as string (example: "HELLO=World") (default: [])
+    -f, --env-file <paths...>         path(s) to your env file(s) (default: [])
+    -fv, --env-vault-file <paths...>  path(s) to your .env.vault file(s) (default: [])
+    -o, --overload                    override existing env variables
+    --convention <name>               load a .env convention (available conventions: ['nextjs'])
+    -h, --help                        display help for command
+
+  Examples:
+
+    $ dotenvx run -- npm run dev
+    $ dotenvx run -- flask --app index run
+    $ dotenvx run -- php artisan serve
+    $ dotenvx run -- bin/rails s
+
+  Try it:
+
+    $ echo "HELLO=World" > .env
+    $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
+
+    $ dotenvx run -- node index.js
+    [dotenvx] injecting env (1) from .env
+    Hello World
+  ```
+
+  </details>
+* <details><summary>`--version`</summary><br>
+
+  Check current version of `dotenvx`.
+
+  ```sh
+  $ dotenvx --version
+  X.X.X
+  ```
+
+  </details>
+
+### Extensions 🔌
+
+* <details><summary>`ext ls`</summary><br>
 
   Print all `.env` files in a tree structure.
 
@@ -1036,7 +1189,7 @@ More examples
   $ mkdir -p apps/backend
   $ touch apps/backend/.env
 
-  $ dotenvx ls
+  $ dotenvx ext ls
   ├─ .env.production
   ├─ .env
   └─ apps
@@ -1045,7 +1198,7 @@ More examples
   ```
 
   </details>
-* <details><summary>`ls directory`</summary><br>
+* <details><summary>`ext ls directory`</summary><br>
 
   Print all `.env` files inside a specified path to a directory.
 
@@ -1055,12 +1208,12 @@ More examples
   $ mkdir -p apps/backend
   $ touch apps/backend/.env
 
-  $ dotenvx ls apps/backend
+  $ dotenvx ext ls apps/backend
   └─ .env
   ```
 
   </details>
-* <details><summary>`ls -f`</summary><br>
+* <details><summary>`ext ls -f`</summary><br>
 
   Glob `.env` filenames matching a wildcard.
 
@@ -1071,7 +1224,7 @@ More examples
   $ touch apps/backend/.env
   $ touch apps/backend/.env.prod
 
-  $ dotenvx ls -f **/.env.prod*
+  $ dotenvx ext ls -f **/.env.prod*
   ├─ .env.production
   └─ apps
      └─ backend
@@ -1079,14 +1232,14 @@ More examples
   ```
 
   </details>
-* <details><summary>`genexample`</summary><br>
+* <details><summary>`ext genexample`</summary><br>
 
   In one command, generate a `.env.example` file from your current `.env` file contents.
 
   ```sh
   $ echo "HELLO=World" > .env
 
-  $ dotenvx genexample
+  $ dotenvx ext genexample
   ✔ updated .env.example (1)
   ```
 
@@ -1096,7 +1249,7 @@ More examples
   ```
 
   </details>
-* <details><summary>`genexample -f`</summary><br>
+* <details><summary>`ext genexample -f`</summary><br>
 
   Pass multiple `.env` files to generate your `.env.example` file from the combination of their contents.
 
@@ -1104,7 +1257,7 @@ More examples
   $ echo "HELLO=World" > .env
   $ echo "DB_HOST=example.com" > .env.production
 
-  $ dotenvx genexample -f .env -f .env.production
+  $ dotenvx ext genexample -f .env -f .env.production
   ✔ updated .env.example (2)
   ```
 
@@ -1115,7 +1268,7 @@ More examples
   ```
 
   </details>
-* <details><summary>`genexample directory`</summary><br>
+* <details><summary>`ext genexample directory`</summary><br>
 
   Generate a `.env.example` file inside the specified directory. Useful for monorepos.
 
@@ -1124,7 +1277,7 @@ More examples
   $ mkdir -p apps/backend
   $ echo "HELLO=Backend" > apps/backend/.env
 
-  $ dotenvx genexample apps/backend
+  $ dotenvx ext genexample apps/backend
   ✔ updated .env.example (1)
   ```
 
@@ -1134,60 +1287,60 @@ More examples
   ```
 
   </details>
-* <details><summary>`gitignore`</summary><br>
+* <details><summary>`ext gitignore`</summary><br>
 
   Gitignore your `.env` files.
 
   ```sh
-  $ dotenvx gitignore
+  $ dotenvx ext gitignore
   creating .gitignore
   appending .env* to .gitignore
   done
   ```
 
   </details>
-* <details><summary>`precommit`</summary><br>
+* <details><summary>`ext precommit`</summary><br>
 
   Prevent `.env` files from being committed to code.
 
   ```sh
-  $ dotenvx precommit
+  $ dotenvx ext precommit
   [dotenvx][precommit] success
   ```
 
   </details>
-* <details><summary>`precommit --install`</summary><br>
+* <details><summary>`ext precommit --install`</summary><br>
 
   Install a shell script to `.git/hooks/pre-commit` to prevent accidentally committing any `.env` files to source control.
 
   ```sh
-  $ dotenvx precommit --install
+  $ dotenvx ext precommit --install
   [dotenvx][precommit] dotenvx precommit installed [.git/hooks/pre-commit]
   ```
 
   </details>
-* <details><summary>`prebuild`</summary><br>
+* <details><summary>`ext prebuild`</summary><br>
 
   Prevent `.env` files from being built into your docker containers.
 
   Add it to your `Dockerfile`.
 
   ```sh
-  RUN curl -fsS https://dotenvx.sh/install.sh | sh
+  RUN curl -fsS https://dotenvx.sh | sh
 
   ...
 
-  RUN dotenvx prebuild
+  RUN dotenvx ext prebuild
   CMD ["dotenvx", "run", "--", "node", "index.js"]
   ```
 
   </details>
-* <details><summary>`scan`</summary><br>
+* <details><summary>`ext scan`</summary><br>
 
   Use [gitleaks](https://gitleaks.io) under the hood to scan for possible secrets in your code.
 
   ```sh
-  $ dotenvx scan
+  $ dotenvx ext scan
 
       ○
       │╲
@@ -1199,91 +1352,33 @@ More examples
   no leaks found
   ```
 
-  </details>
-* <details><summary>`help`</summary><br>
-
-  Output help for `dotenvx`.
-
-  ```sh
-  $ dotenvx help
-  Usage: @dotenvx/dotenvx [options] [command]
-
-  a better dotenv–from the creator of `dotenv`
-
-  Options:
-    -l, --log-level <level>           set log level (default: "info")
-    -q, --quiet                       sets log level to error
-    -v, --verbose                     sets log level to verbose
-    -d, --debug                       sets log level to debug
-    -V, --version                     output the version number
-    -h, --help                        display help for command
-
-  Commands:
-    run [options]                     inject env at runtime [dotenvx run -- yourcommand]
-    get [options] [key]               return a single environment variable
-    set [options] <KEY> <value>       set a single environment variable
-    ...
-    help [command]                    display help for command
-  ```
-
-  You can get more detailed help per command with `dotenvx help COMMAND`.
-
-  ```sh
-  $ dotenvx help run
-  Usage: @dotenvx/dotenvx run [options]
-
-  inject env at runtime [dotenvx run -- yourcommand]
-
-  Options:
-    -e, --env <strings...>            environment variable(s) set as string (example: "HELLO=World") (default: [])
-    -f, --env-file <paths...>         path(s) to your env file(s) (default: [])
-    -fv, --env-vault-file <paths...>  path(s) to your .env.vault file(s) (default: [])
-    -o, --overload                    override existing env variables
-    --convention <name>               load a .env convention (available conventions: ['nextjs'])
-    -h, --help                        display help for command
-
-  Examples:
-
-    $ dotenvx run -- npm run dev
-    $ dotenvx run -- flask --app index run
-    $ dotenvx run -- php artisan serve
-    $ dotenvx run -- bin/rails s
-
-  Try it:
-
-    $ echo "HELLO=World" > .env
-    $ echo "console.log('Hello ' + process.env.HELLO)" > index.js
-
-    $ dotenvx run -- node index.js
-    [dotenvx] injecting env (1) from .env
-    Hello World
-  ```
-
-  </details>
-* <details><summary>`--version`</summary><br>
-
-  Check current version of `dotenvx`.
-
-  ```sh
-  $ dotenvx --version
-  X.X.X
-  ```
-
   </details>
 
 &nbsp;
 
 ## Guides
 
-* [quickstart guides](https://dotenvx.com/docs/quickstart)
-  * [run anywhere](https://dotenvx.com/docs/quickstart/run)
-  * [multi-environment](https://dotenvx.com/docs/quickstart/environments)
-  * [encrypted envs](https://dotenvx.com/docs/quickstart/encryption)
-* [dotenvx/docs](https://dotenvx.com/docs)
-  * [languages](https://dotenvx.com/docs#languages)
-  * [frameworks](https://dotenvx.com/docs#frameworks)
-  * [platforms](https://dotenvx.com/docs#platforms)
-  * [ci/cd](https://dotenvx.com/docs#cis)
+> Go deeper into using `dotenvx` with detailed framework and platform guides.
+>
+
+* <a href="https://dotenvx.com/docs/platforms/digital-ocean">Digital Ocean <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/digitalocean.svg" alt="Digital Ocean Logo" width="20" height="20" style="fill:#0080FF;"></a>
+* <a href="https://dotenvx.com/docs/platforms/docker">Docker <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/docker.svg" alt="Docker Logo" width="20" height="20" style="fill:#2496ED;"></a>
+* <a href="https://dotenvx.com/docs/platforms/fly">Fly.io</a>
+* <a href="https://dotenvx.com/docs/cis/github-actions">GitHub Actions <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/github.svg" alt="GitHub Logo" width="20" height="20" style="fill:#181717;"></a>
+* <a href="https://dotenvx.com/docs/platforms/heroku">Heroku <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/heroku.svg" alt="Heroku Logo" width="20" height="20" style="fill:#430098;"></a>
+* <a href="https://dotenvx.com/docs/platforms/netlify">Netlify <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/netlify.svg" alt="Netlify Logo" width="20" height="20" style="fill:#00C7B7;"></a>
+* <a href="https://dotenvx.com/docs/package-managers/npm">NPM <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/npm.svg" alt="NPM Logo" width="20" height="20" style="fill:#CB3837;"></a>
+* <a href="https://dotenvx.com/docs/monorepos/nx">Nx <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/nx.svg" alt="Nx Logo" width="20" height="20" style="fill:#143055;"></a>
+* <a href="https://dotenvx.com/docs/platforms/render">Render <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/render.svg" alt="Render Logo" width="20" height="20" style="fill:#000000;"></a>
+* <a href="https://dotenvx.com/docs/platforms/railway">Railway <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/railway.svg" alt="Railway Logo" width="20" height="20" style="fill:#0B0D0E;"></a>
+* <a href="https://dotenvx.com/docs/monorepos/turborepo">Turborepo <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/turborepo.svg" alt="Turborepo Logo" width="20" height="20" style="fill:#EF4444;"></a>
+* <a href="https://dotenvx.com/docs/platforms/vercel">Vercel <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/vercel.svg" alt="Vercel Logo" width="20" height="20" style="fill:#000000;"></a>
+* [more](https://dotenvx.com/docs/guides)
+  * <a href="https://dotenvx.com/docs/guides#node-js">Node.js <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/nodejs.svg" alt="Node.js Logo" width="20" height="20" style="fill:#5FA04E;"></a>
+  * <a href="https://dotenvx.com/docs/guides#python">Python <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/python.svg" alt="Python Logo" width="20" height="20" style="fill:#3776AB;"></a>
+  * <a href="https://dotenvx.com/docs/guides#php">PHP <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/php.svg" alt="PHP Logo" width="20" height="20" style="fill:#777BB4;"></a>
+  * <a href="https://dotenvx.com/docs/guides#ruby">Ruby <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/ruby.svg" alt="Ruby Logo" width="20" height="20" style="fill:#CC342D;"></a>
+  * <a href="https://dotenvx.com/docs/guides#rust">Rust <img src="https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/rust.svg" alt="Rust Logo" width="20" height="20" style="fill:#000000;"></a>
 
 &nbsp;