diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
new file mode 100644
index 0000000000..b9b41ddd58
--- /dev/null
+++ b/.github/workflows/main.yml
@@ -0,0 +1,49 @@
+name: Publish docs via GitHub Pages
+on:
+ push:
+ branches:
+ - master
+
+jobs:
+ build:
+ name: Deploy docs
+ runs-on: ubuntu-latest
+ steps:
+ - name: Set up Python 3.7
+ uses: actions/setup-python@v2
+ with:
+ python-version: '3.x'
+
+ - name: Install dependencies
+ run: |
+ python -m pip install --upgrade pip
+ pip install git+https://${{ secrets.GH_TOKEN }}@github.com/lensapp/mkdocs-material-insiders.git
+ pip install mkdocs-git-revision-date-localized-plugin mike
+
+
+ - name: Checkout Release from lens
+ uses: actions/checkout@v2
+ with:
+ repository: lensapp/lens
+
+ - name: git config
+ run: |
+ git config --local user.email "action@github.com"
+ git config --local user.name "GitHub Action"
+ git pull
+
+
+ - name: mkdocs deploy latest
+ run: |
+ mike deploy --push latest
+
+
+ - name: mkdocs deploy new release / tag
+ if: contains(github.ref, 'refs/tags/v')
+ run: |
+ mike deploy --push--update-aliases ${{ github.ref }} latest
+ mike set-default --push ${{ github.ref }}
+
+
+
+
diff --git a/README.md b/README.md
index b403492e72..21522cf4cb 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,16 @@ Allows for faster separate re-runs of some of the more involved processes:
1. `yarn dev:extension-types` compile declaration types for `@k8slens/extensions`
1. `yarn dev-run` runs app in dev-mode and auto-restart when main process file has changed
+## Development (documentation)
+
+Run a local instance of `mkdocs serve` in a docker container for developing the Lens Documentation.
+
+> Prerequisites: docker, yarn
+
+* `yarn mkdocs-serve-local` - local build and serve of mkdocs with auto update enabled
+
+Go to [localhost:8000](http://127.0.0.1:8000)
+
## Developer's ~~RTFM~~ recommended list:
- [TypeScript](https://www.typescriptlang.org/docs/home.html) (front-end/back-end)
@@ -53,6 +63,8 @@ Allows for faster separate re-runs of some of the more involved processes:
- [ElectronJS](https://www.electronjs.org/docs) (chrome/node)
- [NodeJS](https://nodejs.org/dist/latest-v12.x/docs/api/) (api docs)
+
+
## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/lensapp/lens.
\ No newline at end of file
diff --git a/docs/CNAME b/docs/CNAME
new file mode 100644
index 0000000000..12bc650410
--- /dev/null
+++ b/docs/CNAME
@@ -0,0 +1 @@
+docs.k8slens.dev
diff --git a/docs/README.md b/docs/README.md
new file mode 100644
index 0000000000..f8a979fb90
--- /dev/null
+++ b/docs/README.md
@@ -0,0 +1,21 @@
+# Overview
+
+Lens is the most powerful Kubernetes IDE on the market. It is a standalone application, and it is available on macOS, Windows, and Linux. Some of the benefits of using Lens include:
+
+* Confidence that your clusters are properly setup and configured.
+* Increased visibility, real time statistics, log streams, and hands-on troubleshooting capabilities.
+* The ability to work with your clusters quickly and easily, radically improving productivity and the speed of business.
+
+Watch this introductory video to see Lens in action:
+
+[![Screenshot](img/lens-intro-video-screenshot.png)](https://youtu.be/04v2ODsmtIs)
+
+**Note:** Use CTRL+click (on Windows and Linux) or CMD+click (on MacOS) to open the above in a new tab
+
+## Downloading Lens
+
+[Download Lens](https://github.com/lensapp/lens/releases) for macOS, Windows, or Linux.
+
+## Quick Start
+
+Get up and running quickly by learning to [add clusters](clusters/adding-clusters.md).
diff --git a/docs/clusters/adding-clusters.md b/docs/clusters/adding-clusters.md
new file mode 100644
index 0000000000..a89afb2f25
--- /dev/null
+++ b/docs/clusters/adding-clusters.md
@@ -0,0 +1,16 @@
+# Adding clusters
+
+Add clusters by clicking the **Add Cluster** button in the left-side menu.
+
+1. Click the **Add Cluster** button (indicated with a '+' icon).
+2. Enter the path to your kubeconfig file. You'll need to have a kubeconfig file for the cluster you want to add. You can either browse for the path from the file system or or enter it directly.
+
+Selected [cluster contexts](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context) are added as a separate item in the left-side cluster menu to allow you to operate easily on multiple clusters and/or contexts.
+
+**NOTE**: Any cluster that you added manually will not be merged into your kubeconfig file.
+
+![Add Cluster](images/add-cluster.png)
+
+For more information on kubeconfig see [Kubernetes docs](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/).
+
+To see your currently-enabled config with `kubectl`, enter `kubectl config view --minify --raw` in your terminal.
\ No newline at end of file
diff --git a/docs/clusters/images/add-cluster.png b/docs/clusters/images/add-cluster.png
new file mode 100644
index 0000000000..b53c09f704
Binary files /dev/null and b/docs/clusters/images/add-cluster.png differ
diff --git a/docs/clusters/images/cluster-settings.png b/docs/clusters/images/cluster-settings.png
new file mode 100644
index 0000000000..27a4a72ff9
Binary files /dev/null and b/docs/clusters/images/cluster-settings.png differ
diff --git a/docs/clusters/images/remove-cluster.png b/docs/clusters/images/remove-cluster.png
new file mode 100644
index 0000000000..bcaa69c44a
Binary files /dev/null and b/docs/clusters/images/remove-cluster.png differ
diff --git a/docs/clusters/removing-clusters.md b/docs/clusters/removing-clusters.md
new file mode 100644
index 0000000000..89b7286f99
--- /dev/null
+++ b/docs/clusters/removing-clusters.md
@@ -0,0 +1,12 @@
+# Removing clusters
+
+You can remove Lens clusters using the context menu that appears when you hover over the cluster in the left-side menu that you want to remove. By right-clicking the cluster of choice you can hit the `Remove` button to delete it from your list.
+
+To remove a cluster from your cluster list:
+
+1. Hover over the name of the cluster you want to remove in the left side menu. A context menu will appear.
+2. Click **Remove**.
+
+**NOTE**: This will only remove the cluster from your Lens cluster list. It will not affect your actual Kubernetes cluster or its configuration.
+
+![Remove Cluster](images/remove-cluster.png)
\ No newline at end of file
diff --git a/docs/clusters/settings.md b/docs/clusters/settings.md
new file mode 100644
index 0000000000..13371ad1e4
--- /dev/null
+++ b/docs/clusters/settings.md
@@ -0,0 +1,63 @@
+# Cluster Settings
+
+It is easy to configure Lens Clusters to your liking through its various settings. By right-clicking the cluster of choice you can open `Settings`.
+
+## Status
+
+An overview of the cluster status.
+
+### Cluster Status
+
+This section provides cluster details including the detected distribution, kernel version, API endpoint and online status.
+
+## General
+
+General information for the cluster with some settings that can be customized.
+
+### Cluster Name
+
+The cluster name is inheritated from the kubeconfig by default. You can change the cluster name to another value by updating here. Note this does not update your kubeconfig file.
+
+### Workspace
+
+This is the Lens Workspace that the cluster is associated with. You can change to another workspace or create a new workspace - this option will take you the Workspaces editor where you can create a new workspace and then
+navigate back to the cluster settings.
+
+### Cluster Icon
+
+A random cluster icon is associated with your cluster when it is first created. You can define your own cluster icon here.
+
+### HTTP Proxy
+
+If you need to use a HTTP proxy to communicate with the Kubernetes API you can define it here.
+
+### Prometheus
+
+Lens can be configured to query a Prometheus server that is installed in the cluster. The query format used can be configured here to either auto-detect or a pre-configured query format. The available formats are:
+
+* Lens
+* Helm Operator
+* Prometheus Operator
+* Stacklight
+
+For more details of custom Prometheus configurations refer to this [guide](https://github.com/lensapp/lens/blob/master/troubleshooting/custom-prometheus.md).
+
+### Working Directory
+
+The terminat working directory can be configured here - by default it is set to `$HOME`.
+
+## Features
+
+Additional Lens features that can be installed by the user.
+
+### Metrics
+
+Enable timeseries data visualization (Prometheus stack) for your cluster. Install this only if you don't have existing Prometheus stack installed.
+
+### User Mode
+
+User Mode feature enables non-admin users to see namespaces they have access to. This is achieved by configuring RBAC rules so that every authenticated user is granted to list namespaces.
+
+## Removal
+
+Remove the current cluster.
diff --git a/docs/custom_theme/img/favicon.ico b/docs/custom_theme/img/favicon.ico
new file mode 100644
index 0000000000..19b2de71d1
Binary files /dev/null and b/docs/custom_theme/img/favicon.ico differ
diff --git a/docs/custom_theme/main.html b/docs/custom_theme/main.html
new file mode 100644
index 0000000000..b6ad2467dd
--- /dev/null
+++ b/docs/custom_theme/main.html
@@ -0,0 +1,12 @@
+{% extends "base.html" %}
+
+{% block analytics %}
+
+
+
+{% endblock %}
\ No newline at end of file
diff --git a/docs/extensions/capabilities/common-capabilities.md b/docs/extensions/capabilities/common-capabilities.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/capabilities/overview.md b/docs/extensions/capabilities/overview.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/capabilities/theming.md b/docs/extensions/capabilities/theming.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/get-started/anatomy.md b/docs/extensions/get-started/anatomy.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/get-started/wrapping-up.md b/docs/extensions/get-started/wrapping-up.md
new file mode 100644
index 0000000000..95f36dbe88
--- /dev/null
+++ b/docs/extensions/get-started/wrapping-up.md
@@ -0,0 +1,18 @@
+# Wrapping Up
+
+In the [Your First Extension](your-first-extension.md) topic, you learned how to create and run an extension. In the [Extension Anatomy](anatomy.md) topic, you learned fundamental concepts to Lens extension development. However, this is just a small glimpse of what can be created with Lens Extensions. Below are some suggested routes for furthering your Lens extension development skills.
+
+## Extension Capabilities
+
+In this section, we split the Lens extension points into a few categories, each with short descriptions as to what your extension could achieve. Validate that your extension idea is achievable by reading the [Extension Capabilities](../capabilities/overview.md) section for new extension ideas.
+
+## Guides & Samples
+
+We have a great collection of sample extensions that you can adapt from, and some of them include a detailed guide that explains the source code. You can find all Samples & Guides in the [lens-extension-samples](https://github.com/lensapp/lens-extension-samples) repository.
+
+## Testing and Publishing
+
+This section includes topics that help you develop high-quality Lens extensions. For example, you can learn
+
+* How to add [integration tests](../testing-and-publishing/testing.md) for your extension
+* How to [publish your extension](../testing-and-publishing/publishing.md)
diff --git a/docs/extensions/get-started/your-first-extension.md b/docs/extensions/get-started/your-first-extension.md
new file mode 100644
index 0000000000..0b057d2a87
--- /dev/null
+++ b/docs/extensions/get-started/your-first-extension.md
@@ -0,0 +1,63 @@
+# Your First Extension
+
+In this topic, we'll teach you the fundamental concepts for building extensions. Make sure you have [Node.js](https://nodejs.org/en/) and [Git](https://git-scm.com/) installed....
+
+## Installing and Building the extension
+
+Simple Lens extension that adds "Hello World" page to a cluster menu.
+
+### Linux
+
+First you will need to clone the [Lens Extension samples](https://github.com/lensapp/lens-extension-samples) repository to your local machine:
+
+```sh
+git clone https://github.com/lensapp/lens-extension-samples.git
+```
+
+Next you need to create a symlink from the directory that Lens will monitor for user installed extensions to the sample extension, in this case **helloworld-sample**:
+
+```sh
+mkdir -p ~/.k8slens/extensions
+cd ~/.k8slens/extensions
+ln -s /helloworld-sample helloworld-sample
+```
+
+To build the extension you can use `make` or run the `npm` commands manually:
+
+```sh
+cd /helloworld-sample
+make build
+```
+
+OR
+
+```sh
+cd /helloworld-sample
+npm install
+npm run build
+```
+
+If you want to watch for any source code changes and automatically rebuild the extension you can use:
+
+```sh
+cd /helloworld-sample
+npm run dev
+```
+
+Finally, if you already have Lens open you will need to quit and restart Lens for the extension to be loaded. After this initial restart you can reload Lens and it will pick up any new builds of the extension. Within Lens connect to an existing cluster or [create a new one](../../clusters/adding-clusters.md). You should see then see the "Hello World" page in the Lens sidebar cluster menu.
+
+## Developing the extension
+
+Let's make a change to the message that our helloworld-sample extension displays:
+
+* Navigate to `/helloworld-sample`.
+* Change the message from HelloWorld! to **Hello Lens Extensions** in `page.tsx`.
+* Rebuild the extension or, if you used `npm run dev`, the extension should automatically rebuild.
+* Reload the Lens window and click on the Hello World page.
+* You should see the updated message showing up.
+
+## Next steps
+
+In the next topic, [Extension Anatomy](anatomy.md), we'll take a closer look at the source code of the Hello World sample and explain key concepts.
+
+You can find the source code of this tutorial at: [lensapp/lens-extension-samples](https://github.com/lensapp/lens-extension-samples/tree/master/helloworld-sample). The [Extension Guides](../guides/overview.md) topic contains other samples, each illustrating a different Lens Extension API.
diff --git a/docs/extensions/guides/overview.md b/docs/extensions/guides/overview.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/guides/renderer-extension.md b/docs/extensions/guides/renderer-extension.md
new file mode 100644
index 0000000000..fc4f9b8bdd
--- /dev/null
+++ b/docs/extensions/guides/renderer-extension.md
@@ -0,0 +1 @@
+# Renderer Extension
diff --git a/docs/extensions/overview.md b/docs/extensions/overview.md
new file mode 100644
index 0000000000..4a118bd4d3
--- /dev/null
+++ b/docs/extensions/overview.md
@@ -0,0 +1,48 @@
+# Lens Extension API
+
+The Extensions API in Lens allows users to customize and enhance the Lens experience by creating their own menus or page content that is extended from the existing pages. Many of the core features of Lens are built as extensions and use the same Extension API.
+
+This documentation describes:
+
+* How to build, run, test and publish an extension
+* How to take advantage of Lens's Extension API
+* Where to find [guides](guides/overview.md) and [code samples](https://github.com/lensapp/lens-extension-samples) to help get you started
+
+Code samples are available at [lensapp/lens-extension-samples](https://github.com/lensapp/lens-extension-samples).
+
+## What can extensions do
+
+Here are some examples of what you can achieve with the Extension API:
+
+* Add custom components & views in the UI - Extending the Lens Workbench
+
+If you'd like to have a more comprehensive overview of the Extension API, refer to the [Extension Capabilities Overview](capabilities/overview.md) page. [Extension Guides Overview](guides/overview.md) also includes a list of code samples and guides that illustrate various Extension API usage.
+
+## How to build extensions
+
+Building a good extension can take a lot of effort. Here is what each section of the API doc can help you with:
+
+* **Get Started** teaches fundamental concepts for building extensions with the Hello World sample.
+* **Extension Capabilities** dissects Lens's Extension API into smaller categories and points you to more detailed topics.
+* **Extension Guides** includes guides and code samples that explain specific usages of Lens Extension API.
+* **Testing and Publishing** includes in-depth guides on various extension development topics, such as testing and publishing extensions.
+* **Advanced Topics** explains advanced concepts such as integrating with 3rd party applications/services.
+* **References** contains exhaustive references for the Lens Extension API, Contribution Points, and many other topics.
+
+## What's new
+
+Lens updates on a monthly cadence, and that applies to the Extension API as well. New features and APIs become available every month to increase the power and scope of Lens extensions.
+
+To stay current with the Extension API and Lens features in general, you can review the [release notes](https://github.com/lensapp/lens/releases).
+
+## Looking for help
+
+If you have questions for extension development, try asking on:
+
+* [Lens Dev Slack](http://k8slens.slack.com/): Public chatroom for Lens developers. Some Lens team members chime in on conversations.
+
+To provide feedback on the documentation or issues with the Lens Extension API, create new issues at [lensapp/lens](https://github.com/lensapp/lens/issues) with the labels `area/documentation` and/or `area/extension`.
+
+## Download Lens - The Kubernetes IDE
+
+Go to [Lens](https://k8slens.dev)
diff --git a/docs/extensions/testing-and-publishing/bundling.md b/docs/extensions/testing-and-publishing/bundling.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/testing-and-publishing/publishing.md b/docs/extensions/testing-and-publishing/publishing.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/extensions/testing-and-publishing/testing.md b/docs/extensions/testing-and-publishing/testing.md
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/docs/getting-started/downloading-lens.md b/docs/getting-started/downloading-lens.md
new file mode 100644
index 0000000000..2493edc5f6
--- /dev/null
+++ b/docs/getting-started/downloading-lens.md
@@ -0,0 +1,64 @@
+# Downloading Lens
+
+Lens is lightweight and simple to install. You'll be up and running in just a few minutes.
+
+
+## System requirements
+
+Review the [System Requirements](/supporting/requirements/) to check if your computer configuration is supported.
+
+
+## macOS
+
+1. [Download Lens](https://github.com/lensapp/lens/releases) for macOS.
+2. Open the browser's download list and locate the downloaded archive.
+3. Select the 'magnifying glass' icon to open the archive in Finder.
+4. Double-click `Lens-{version}.dmg` and drag `Lens.app` to the `Applications` folder, making it available in the macOS Launchpad.
+5. Add Lens to your Dock by right-clicking on the icon to bring up the context menu and choosing **Options**, **Keep in Dock**.
+
+
+## Windows
+
+1. Download the [Lens installer](https://github.com/lensapp/lens/releases) for Windows.
+2. Once it is downloaded, run the installer `Lens-Setup-{version}.exe`. This will only take a minute.
+3. By default, Lens is installed under `C:\users\{username}\AppData\Local\Programs\Lens`.
+
+
+## Linux
+
+See the [Download Lens](https://github.com/lensapp/lens/releases) page for a complete list of available installation options.
+
+
+### Snap
+
+Lens is officially distributed as a Snap package in the [Snap Store](https://snapcraft.io/store):
+
+[![Get it from the Snap Store](images/snap-store.png)](https://snapcraft.io/kontena-lens)
+
+You can install it by running:
+
+```bash
+sudo snap install kontena-lens --classic
+```
+
+
+## Network
+
+Lens is built on top of Electron and benefits from all the networking stack capabilities of Chromium.
+
+
+### Proxy server support
+
+...
+
+
+## Update cadence
+
+Lens releases a new version each month with new features and important bug fixes. Lens supports auto updating and you will be prompted to install the new release when it becomes available!
+
+To stay current with the Lens features, you can review the [release notes](https://github.com/lensapp/lens/releases).
+
+
+## Quick Start
+
+Get up and running quickly by learning to [add clusters](../clusters/adding-clusters.md).
\ No newline at end of file
diff --git a/docs/getting-started/images/color-theme.png b/docs/getting-started/images/color-theme.png
new file mode 100644
index 0000000000..5e4f144560
Binary files /dev/null and b/docs/getting-started/images/color-theme.png differ
diff --git a/docs/getting-started/images/disabled-telemetry-usage-tracking.png b/docs/getting-started/images/disabled-telemetry-usage-tracking.png
new file mode 100644
index 0000000000..809a96056a
Binary files /dev/null and b/docs/getting-started/images/disabled-telemetry-usage-tracking.png differ
diff --git a/docs/getting-started/images/snap-store.png b/docs/getting-started/images/snap-store.png
new file mode 100644
index 0000000000..5e652132c3
Binary files /dev/null and b/docs/getting-started/images/snap-store.png differ
diff --git a/docs/getting-started/introductory-videos.md b/docs/getting-started/introductory-videos.md
new file mode 100644
index 0000000000..fcaee999c0
--- /dev/null
+++ b/docs/getting-started/introductory-videos.md
@@ -0,0 +1,36 @@
+# Introductory Videos
+
+Continue your Lens journey with this set of introductory videos! These videos are meant to quickly familiarize you with Lens' various powerful features.
+
+