From 7447288e5ccfbeddbc09192149fc840ab2767d33 Mon Sep 17 00:00:00 2001
From: Tuan Dang <tony@infisical.com>
Date: Mon, 28 Nov 2022 09:57:17 -0500
Subject: [PATCH] Add integrations anchor and preliminary framework
 integrations to docs

---
 README.md                                     | 19 +++++---
 docs/cli/token.mdx                            |  4 +-
 docs/getting-started/dashboard/token.mdx      |  2 +-
 docs/getting-started/introduction.mdx         |  2 +-
 docs/integrations/{ => cloud}/heroku.mdx      |  0
 docs/integrations/frameworks/django.mdx       |  5 ++
 docs/integrations/frameworks/express.mdx      | 42 ++++++++++++++++
 docs/integrations/frameworks/flask.mdx        | 21 ++++++++
 docs/integrations/frameworks/gatsby.mdx       | 39 +++++++++++++++
 docs/integrations/frameworks/laravel.mdx      |  5 ++
 docs/integrations/frameworks/nestjs.mdx       | 47 ++++++++++++++++++
 docs/integrations/frameworks/nextjs.mdx       | 37 ++++++++++++++
 docs/integrations/frameworks/rails.mdx        |  5 ++
 docs/integrations/frameworks/react.mdx        | 34 +++++++++++++
 docs/integrations/frameworks/remix.mdx        |  5 ++
 docs/integrations/overview.mdx                | 42 +++++++++-------
 .../{ => platforms}/docker-compose.mdx        |  2 +-
 docs/integrations/{ => platforms}/docker.mdx  |  2 +-
 docs/mint.json                                | 48 +++++++++++++++----
 19 files changed, 323 insertions(+), 38 deletions(-)
 rename docs/integrations/{ => cloud}/heroku.mdx (100%)
 create mode 100644 docs/integrations/frameworks/django.mdx
 create mode 100644 docs/integrations/frameworks/express.mdx
 create mode 100644 docs/integrations/frameworks/flask.mdx
 create mode 100644 docs/integrations/frameworks/gatsby.mdx
 create mode 100644 docs/integrations/frameworks/laravel.mdx
 create mode 100644 docs/integrations/frameworks/nestjs.mdx
 create mode 100644 docs/integrations/frameworks/nextjs.mdx
 create mode 100644 docs/integrations/frameworks/rails.mdx
 create mode 100644 docs/integrations/frameworks/react.mdx
 create mode 100644 docs/integrations/frameworks/remix.mdx
 rename docs/integrations/{ => platforms}/docker-compose.mdx (97%)
 rename docs/integrations/{ => platforms}/docker.mdx (95%)

diff --git a/README.md b/README.md
index d819b1cd93..5ca7bd43c2 100644
--- a/README.md
+++ b/README.md
@@ -38,7 +38,7 @@
 - **[Complete control over your data](https://infisical.com/docs/self-hosting/overview)** - host it yourself on any infrastructure
 - **Navigate Multiple Environments** per project (e.g. development, staging, production, etc.)
 - **Personal/Shared** scoping for environment variables
-- **[Integrations](https://infisical.com/docs/integrations/heroku)** with CI/CD and production infrastructure (Heroku available, more coming soon)
+- **[Integrations](https://infisical.com/docs/integrations/overview)** with CI/CD and production infrastructure (Heroku available, more coming soon)
 - 🔜 **1-Click Deploy** to Digital Ocean and Heroku
 - 🔜 **Authentication/Authorization** for projects (read/write controls soon)
 - 🔜 **Automatic Secret Rotation**
@@ -92,19 +92,24 @@ Infisical officially launched as v.1.0 on November 21st, 2022. However, a lot of
 
 ## Integrations
 
-We're currently setting the foundation and building integrations so secrets can be synced everywhere. Any help is welcome! :)
+We're currently setting the foundation and building [integrations](https://infisical.com/docs/integrations/overview) so secrets can be synced everywhere. Any help is welcome! :)
 
-- [x] [Docker](https://infisical.com/docs/integrations/docker)
-- [x] [Docker Compose](https://infisical.com/docs/integrations/docker-compose)
-- [x] [Heroku](https://infisical.com/docs/integrations/heroku)
-- [ ] Vercel
+- [x] [Docker](https://infisical.com/docs/integrations/platforms/docker)
+- [x] [Docker Compose](https://infisical.com/docs/integrations/platforms/docker-compose)
 - [ ] Kubernetes
+- [x] [Heroku](https://infisical.com/docs/integrations/cloud/heroku)
+- [ ] Vercel
 - [ ] AWS
 - [ ] GCP
 - [ ] Azure
 - [ ] Digital Ocean
 - [ ] GitLab
-- [ ] CircleCI
+- [x] React
+- [x] Express
+- [x] Next.js
+- [x] NestJS
+- [x] Gatsby
+- [x] Flask
 
 ## Open-source vs. paid
 
diff --git a/docs/cli/token.mdx b/docs/cli/token.mdx
index 043f07431c..5b3d2fd6b8 100644
--- a/docs/cli/token.mdx
+++ b/docs/cli/token.mdx
@@ -12,8 +12,8 @@ The CLI looks out for an environment variable called the `INFISICAL_TOKEN` which
 
 A common use-case is to use the Infisical Token to fetch environment variables with Docker. More specifically, a token can be passed to a container as an environment variable for the CLI to authenticate and pull its corresponding secrets. Check out the integration guides for that:
 
-- [Docker](../../integrations/docker)
-- [Docker Compose](../../integrations/docker-compose)
+- [Docker](../../integrations/platforms/docker)
+- [Docker Compose](../../integrations/platforms/docker-compose)
 
 <Info>
   Once the token is expired, the CLI using it will no longer be able to make
diff --git a/docs/getting-started/dashboard/token.mdx b/docs/getting-started/dashboard/token.mdx
index 5cde8d61d6..85f46b7992 100644
--- a/docs/getting-started/dashboard/token.mdx
+++ b/docs/getting-started/dashboard/token.mdx
@@ -4,7 +4,7 @@ title: "Infisical Token"
 
 An Infisical Token is needed to authenticate the CLI when there isn't an easy way to input your login credentials.
 
-It's useful for the [Docker](/integrations/docker) and [Docker Compose](/integrations/docker-compose) integrations.
+It's useful for the [Docker](/integrations/platforms/docker) and [Docker Compose](/integrations/platforms/docker-compose) integrations.
 
 It's possible to generate the token in the settings of a project.
 
diff --git a/docs/getting-started/introduction.mdx b/docs/getting-started/introduction.mdx
index 5f5d2a44dd..72b86bf05a 100644
--- a/docs/getting-started/introduction.mdx
+++ b/docs/getting-started/introduction.mdx
@@ -27,7 +27,7 @@ Start syncing environment variables with [Infisical Cloud](https://app.infisical
     Learn how to configure and deploy Infisical.
   </Card>
   <Card
-    href="/integrations/heroku"
+    href="/integrations/overview"
     title="Integrations"
     icon="plug"
     color="#dc2626"
diff --git a/docs/integrations/heroku.mdx b/docs/integrations/cloud/heroku.mdx
similarity index 100%
rename from docs/integrations/heroku.mdx
rename to docs/integrations/cloud/heroku.mdx
diff --git a/docs/integrations/frameworks/django.mdx b/docs/integrations/frameworks/django.mdx
new file mode 100644
index 0000000000..1835c2e9e8
--- /dev/null
+++ b/docs/integrations/frameworks/django.mdx
@@ -0,0 +1,5 @@
+---
+title: "Django"
+---
+
+Instructions coming soon.
diff --git a/docs/integrations/frameworks/express.mdx b/docs/integrations/frameworks/express.mdx
new file mode 100644
index 0000000000..851483cc7c
--- /dev/null
+++ b/docs/integrations/frameworks/express.mdx
@@ -0,0 +1,42 @@
+---
+title: "Express, Fastify, Koa"
+---
+
+Prerequisite: [Install the CLI](/cli/overview)
+
+The steps apply to the following non-exhaustive list of frameworks:
+
+- [Express](https://expressjs.com)
+- [Fastify](https://www.fastify.io)
+- [Koa](https://koajs.com)
+
+## Initialize Infisical for your app
+
+```bash
+# move to your app
+cd /path/to/project
+
+# initialize infisical
+infisical init
+```
+
+## Modify the start script in your `package.json`
+
+```json
+...
+"scripts": {
+    "start": "infisical run -- node index.js"
+    "dev": "infisical run -- nodemon index.js" // if using nodemon for dev
+}
+...
+```
+
+## Start your server with environment variables injected
+
+```bash
+npm run start
+
+# or start development server
+
+npm run dev
+```
diff --git a/docs/integrations/frameworks/flask.mdx b/docs/integrations/frameworks/flask.mdx
new file mode 100644
index 0000000000..bb35bd23c6
--- /dev/null
+++ b/docs/integrations/frameworks/flask.mdx
@@ -0,0 +1,21 @@
+---
+title: "Flask"
+---
+
+Prerequisite: [Install the CLI](/cli/overview)
+
+## Initialize Infisical for your [Flask](https://flask.palletsprojects.com/en/2.2.x) app
+
+```bash
+# move to your Flask app
+cd /path/to/project
+
+# initialize infisical
+infisical init
+```
+
+## Start your server with environment variables injected
+
+```bash
+infisical run -- flask run
+```
diff --git a/docs/integrations/frameworks/gatsby.mdx b/docs/integrations/frameworks/gatsby.mdx
new file mode 100644
index 0000000000..4e0b576c8f
--- /dev/null
+++ b/docs/integrations/frameworks/gatsby.mdx
@@ -0,0 +1,39 @@
+---
+title: "Gatsby"
+---
+
+Prerequisite: [Install the CLI](/cli/overview)
+
+## Initialize Infisical for your [Gatsby](https://www.gatsbyjs.com) app
+
+```bash
+# move to your app
+cd /path/to/project
+
+# initialize infisical
+infisical init
+```
+
+## Modify the start script in your `package.json`
+
+```json
+...
+"scripts": {
+    "develop": "infisical run -- gatsby develop",
+    "start": "infisical run -- gatsby develop",
+    "build": "infisical run -- gatsby build",
+    "serve": "infisical run -- gatsby serve",
+    "clean": "infisical run -- gatsby clean"
+}
+...
+```
+
+## Start your server with environment variables injected
+
+```bash
+yarn run start
+
+# or start development server
+
+yarn run develop
+```
diff --git a/docs/integrations/frameworks/laravel.mdx b/docs/integrations/frameworks/laravel.mdx
new file mode 100644
index 0000000000..78786c719c
--- /dev/null
+++ b/docs/integrations/frameworks/laravel.mdx
@@ -0,0 +1,5 @@
+---
+title: "Laravel"
+---
+
+Instructions coming soon.
diff --git a/docs/integrations/frameworks/nestjs.mdx b/docs/integrations/frameworks/nestjs.mdx
new file mode 100644
index 0000000000..c24615ffa9
--- /dev/null
+++ b/docs/integrations/frameworks/nestjs.mdx
@@ -0,0 +1,47 @@
+---
+title: "NestJS"
+---
+
+Prerequisite: [Install the CLI](/cli/overview)
+
+## Initialize Infisical for your [NestJS](https://nestjs.com) app
+
+```bash
+# move to your Next.js app
+cd /path/to/project
+
+# initialize infisical
+infisical init
+```
+
+## Modify the start script in your `package.json`
+
+```json
+...
+"scripts": {
+    "prebuild": "rimraf dist",
+    "build": "nest build",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "start": "infisical run -- nest start",
+    "start:dev": "infisical run -- nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:debug": "node --inspect-brk -r tsconfig-paths/register -r ts-node/register node_modules/.bin/jest --runInBand",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+}
+...
+```
+
+## Start your server with environment variables injected
+
+```bash
+npm run start
+
+# or start development server
+
+npm run start:dev
+```
diff --git a/docs/integrations/frameworks/nextjs.mdx b/docs/integrations/frameworks/nextjs.mdx
new file mode 100644
index 0000000000..2b7a564681
--- /dev/null
+++ b/docs/integrations/frameworks/nextjs.mdx
@@ -0,0 +1,37 @@
+---
+title: "Next.js"
+---
+
+Prerequisite: [Install the CLI](/cli/overview)
+
+## Initialize Infisical for your [Next.js](https://nextjs.org)
+
+```bash
+# move to your Next.js app
+cd /path/to/project
+
+# initialize infisical
+infisical init
+```
+
+## Modify the start script in your `package.json`
+
+```json
+...
+"scripts": {
+    "dev": "infisical run -- next dev",
+    "build": "infisical run -- next build",
+    "start": "infisical run -- next start"
+}
+...
+```
+
+## Start your server with environment variables injected
+
+```bash
+yarn run dev
+
+# or
+
+npm run dev
+```
diff --git a/docs/integrations/frameworks/rails.mdx b/docs/integrations/frameworks/rails.mdx
new file mode 100644
index 0000000000..9bb59f9200
--- /dev/null
+++ b/docs/integrations/frameworks/rails.mdx
@@ -0,0 +1,5 @@
+---
+title: "Ruby on Rails"
+---
+
+Instructions coming soon.
diff --git a/docs/integrations/frameworks/react.mdx b/docs/integrations/frameworks/react.mdx
new file mode 100644
index 0000000000..80ee250cb6
--- /dev/null
+++ b/docs/integrations/frameworks/react.mdx
@@ -0,0 +1,34 @@
+---
+title: "React"
+---
+
+Prerequisite: [Install the CLI](/cli/overview)
+
+## Initialize Infisical for your [Create React App](https://create-react-app.dev)
+
+```bash
+# move to your React app
+cd /path/to/project
+
+# initialize infisical
+infisical init
+```
+
+## Modify the start script in your `package.json`
+
+```json
+...
+"scripts": {
+    "start": "infisical run -- react-scripts start",
+    "build": "react-scripts build",
+    "test": "react-scripts test",
+    "eject": "react-scripts eject"
+}
+...
+```
+
+## Start your server with environment variables injected
+
+```bash
+yarn start
+```
diff --git a/docs/integrations/frameworks/remix.mdx b/docs/integrations/frameworks/remix.mdx
new file mode 100644
index 0000000000..6712c693ff
--- /dev/null
+++ b/docs/integrations/frameworks/remix.mdx
@@ -0,0 +1,5 @@
+---
+title: "Remix"
+---
+
+Instructions coming soon.
diff --git a/docs/integrations/overview.mdx b/docs/integrations/overview.mdx
index 268f233194..887efbec89 100644
--- a/docs/integrations/overview.mdx
+++ b/docs/integrations/overview.mdx
@@ -6,19 +6,29 @@ Integrations allow environment variables to be synced from Infisical into your l
 
 Missing an integration? Throw in a [request](https://github.com/Infisical/infisical/issues).
 
-| Integration                                    | Status      |
-| ---------------------------------------------- | ----------- |
-| [Docker](/integrations/docker)                 | Available   |
-| [Docker-Compose](/integrations/docker-compose) | Available   |
-| [Heroku](/integrations/heroku)                 | Available   |
-| Kubernetes                                     | Coming soon |
-| Vercel                                         | Coming soon |
-| AWS                                            | Coming soon |
-| GCP                                            | Coming soon |
-| Azure                                          | Coming soon |
-| DigitalOcean                                   | Coming soon |
-| GitLab                                         | Coming soon |
-| CircleCI                                       | Coming soon |
-| TravisCI                                       | Coming soon |
-| GitHub Actions                                 | Coming soon |
-| Jenkins                                        | Coming soon |
+| Integration                                              | Type      | Status      |
+| -------------------------------------------------------- | --------- | ----------- |
+| [Docker](/integrations/platforms/docker)                 | Platform  | Available   |
+| [Docker-Compose](/integrations/platforms/docker-compose) | Platform  | Available   |
+| Kubernetes                                               | Platform  | Coming soon |
+| [Heroku](/integrations/cloud/heroku)                     | Cloud     | Available   |
+| Vercel                                                   | Cloud     | Coming soon |
+| AWS                                                      | Cloud     | Coming soon |
+| GCP                                                      | Cloud     | Coming soon |
+| Azure                                                    | Cloud     | Coming soon |
+| DigitalOcean                                             | Cloud     | Coming soon |
+| GitLab                                                   | CI/CD     | Coming soon |
+| CircleCI                                                 | CI/CD     | Coming soon |
+| TravisCI                                                 | CI/CD     | Coming soon |
+| GitHub Actions                                           | CI/CD     | Coming soon |
+| Jenkins                                                  | CI/CD     | Coming soon |
+| [React](/integrations/frameworks/react)                  | Framework | Available   |
+| [Express](integrations/frameworks/express)               | Framework | Available   |
+| [Next.js](/integrations/frameworks/nextjs)               | Framework | Available   |
+| [NestJS](/integrations/frameworks/nestjs)                | Framework | Available   |
+| [Gatsby](/integrations/frameworks/gatsby)                | Framework | Available   |
+| [Remix](/integrations/frameworks/remix)                  | Framework | Coming soon |
+| [Django](/integrations/)                                 | Framework | Coming soon |
+| [Flask](/integrations/frameworks/flask)                  | Framework | Available   |
+| [Laravel](/integrations/frameworks/laravel)              | Framework | Coming soon |
+| [Ruby on Rails](/integrations/frameworks/rails)          | Framework | Coming soon |
diff --git a/docs/integrations/docker-compose.mdx b/docs/integrations/platforms/docker-compose.mdx
similarity index 97%
rename from docs/integrations/docker-compose.mdx
rename to docs/integrations/platforms/docker-compose.mdx
index 133eba3780..9e0f90e558 100644
--- a/docs/integrations/docker-compose.mdx
+++ b/docs/integrations/platforms/docker-compose.mdx
@@ -6,7 +6,7 @@ The Docker Compose integration enables you to inject environment variables from
 
 ## Add the CLI to your Dockerfile(s)
 
-Follow steps 1 through 3 on our [guide to configure Infisical CLI](../integrations/docker) in your Dockerfile.
+Follow steps 1 through 3 on our [guide to configure Infisical CLI](../integrations/platforms/docker) in your Dockerfile.
 
 ## Generate Infisical Token
 
diff --git a/docs/integrations/docker.mdx b/docs/integrations/platforms/docker.mdx
similarity index 95%
rename from docs/integrations/docker.mdx
rename to docs/integrations/platforms/docker.mdx
index 3b03abea3b..6f08c9ec84 100644
--- a/docs/integrations/docker.mdx
+++ b/docs/integrations/platforms/docker.mdx
@@ -2,7 +2,7 @@
 title: "Docker"
 ---
 
-The Docker integration enables you to inject environment variables from Infisical into a container.
+Infisical can be used in a Dockerfile to inject environment variables into a Docker container.
 
 ## Add the CLI to your Dockerfile
 
diff --git a/docs/mint.json b/docs/mint.json
index 4e203102aa..04891f7b8f 100644
--- a/docs/mint.json
+++ b/docs/mint.json
@@ -37,6 +37,11 @@
       "icon": "server",
       "url": "self-hosting"
     },
+    {
+      "name": "Integrations",
+      "icon": "plug",
+      "url": "integrations"
+    },
     {
       "name": "Contributing",
       "icon": "code",
@@ -92,15 +97,6 @@
         }
       ]
     },
-    {
-      "group": "Integrations",
-      "pages": [
-        "integrations/overview",
-        "integrations/heroku",
-        "integrations/docker",
-        "integrations/docker-compose"
-      ]
-    },
     {
       "group": "Self-hosting",
       "pages": [
@@ -115,6 +111,40 @@
         }
       ]
     }, 
+    {
+      "group": "Integrations",
+      "pages": [
+        "integrations/overview"
+      ]
+    },
+    {
+      "group": "Platforms",
+      "pages": [
+        "integrations/platforms/docker",
+        "integrations/platforms/docker-compose"
+      ]
+    },
+    {
+      "group": "Cloud",
+      "pages": [
+        "integrations/cloud/heroku"
+      ]
+    },
+    {
+      "group": "Frameworks",
+      "pages": [
+        "integrations/frameworks/react",
+        "integrations/frameworks/express",
+        "integrations/frameworks/nextjs",
+        "integrations/frameworks/nestjs",
+        "integrations/frameworks/gatsby",
+        "integrations/frameworks/remix",
+        "integrations/frameworks/django",
+        "integrations/frameworks/flask",
+        "integrations/frameworks/laravel",
+        "integrations/frameworks/rails"
+      ]
+    },
     {
       "group": "Security",
       "pages": [