{% for subentry in entry.subfolderitems %}
{% assign currentSubEntry = subentry.url | append: '/' %}
diff --git a/docs/assets/css/styles.scss b/docs/assets/css/styles.scss
index 6741bfe1..92159a5b 100644
--- a/docs/assets/css/styles.scss
+++ b/docs/assets/css/styles.scss
@@ -18,6 +18,10 @@ body {
}
}
+table {
+ @extend .table;
+}
+
// logo and icon styling
#inso-logo {
padding-left: 20px;
diff --git a/docs/insomnia/enterprise-ip-whitelist-guide.md b/docs/insomnia/enterprise-ip-whitelist-guide.md
deleted file mode 100644
index 5fcde384..00000000
--- a/docs/insomnia/enterprise-ip-whitelist-guide.md
+++ /dev/null
@@ -1,62 +0,0 @@
----
-layout: article-detail
-title: Insomnia Whitelisting Guide for Enterprise Users
-category: "Insomnia Whitelisting Guide for Enterprise Users"
-category-url: enterprise-ip-whitelist-guide
----
-
-## Introduction
-
-For enterprise users utilizing Insomnia, it's crucial to ensure that specific domains are whitelisted in your network. This step is essential to guarantee that all features of Insomnia, including updates, synchronization, and documentation, work without any hindrance in environments with restricted internet access.
-
-## Domains to Whitelist
-
-To fully utilize Insomnia, please ensure the following domains are whitelisted:
-
-- **insomnia.rest**: Main website for Insomnia.
-
-- **ai.insomnia.rest**: Handles AI-related features within Insomnia.
-
-- **api.insomnia.rest**: API endpoint for Insomnia services.
-
-- **docs.insomnia.rest**: Provides access to Insomnia documentation and user guides.
-
-- **mock.insomnia.rest**: Used for Insomnia App's Mocking feature.
-
-- **updates.insomnia.rest**: For receiving software updates and patches.
-
-- **auth.insomnia.rest**: Manages authentication processes for Insomnia.
-
-- **insomnia-prod.us.auth0.com**: A domain linked to authentication used for secure logins.
-
-- **djvq2ky33rnc.cloudfront.net**: A CDN domain for hosting static assets related to Insomnia.
-
-- **api.segment.io**: Used for analytics and telemetry within Insomnia.
-
-- **o1147619.ingest.sentry.io**: Used for error reporting and monitoring to enhance the application's stability and performance.
-
-## Whitelisting Steps
-
-### For IT Administrators
-
-Follow these steps to add the domains to your network's whitelist:
-
-1. **Access Firewall or Network Security Settings:**
- - Log in to your firewall or web filter's administrative interface.
-
-2. **Find the Whitelisting Section:**
- - Locate the area where you can list allowed websites or domains.
-
-3. **Input the Domains:**
- - Add each of the above domains to the whitelist section. Ensure you save the changes after adding each domain.
-
-4. **Implement the Changes:**
- - Apply the changes, which may necessitate restarting the firewall or web filter service.
-
-### For Individual Users
-
-If you're an individual user, contact your IT department with this list and request these domains be whitelisted to enable full functionality of Insomnia in your workspace.
-
-## Conclusion
-
-Whitelisting these domains ensures uninterrupted access to all functionalities of Insomnia, including updates, documentation, and necessary backend services. Should you experience issues post-whitelisting, it's advisable to seek assistance from your IT support or reach out to Insomnia's customer service at OR .
diff --git a/docs/insomnia/get-started/collections/create.md b/docs/insomnia/get-started/collections/create.md
new file mode 100644
index 00000000..8262d8b7
--- /dev/null
+++ b/docs/insomnia/get-started/collections/create.md
@@ -0,0 +1,6 @@
+---
+layout: article-detail
+title: Create your first Collection
+---
+
+
\ No newline at end of file
diff --git a/docs/insomnia/get-started/collections/pre-request-script.md b/docs/insomnia/get-started/collections/pre-request-script.md
new file mode 100644
index 00000000..af85ccb7
--- /dev/null
+++ b/docs/insomnia/get-started/collections/pre-request-script.md
@@ -0,0 +1,6 @@
+---
+layout: article-detail
+title: Add a pre-request script
+---
+
+
\ No newline at end of file
diff --git a/docs/insomnia/send-your-first-request.md b/docs/insomnia/get-started/collections/send-your-first-request.md
similarity index 91%
rename from docs/insomnia/send-your-first-request.md
rename to docs/insomnia/get-started/collections/send-your-first-request.md
index 24512f6b..e31c0cd8 100644
--- a/docs/insomnia/send-your-first-request.md
+++ b/docs/insomnia/get-started/collections/send-your-first-request.md
@@ -1,9 +1,8 @@
---
layout: article-detail
title: Send Your First Request
-category: "Get Started"
-category-url: get-started
---
+
Insomnia is an API client that enables you to send API requests outside of your terminal, and without writing any code. This means you don't have to write any finicky cURL requests or backend code to quickly retrieve information, push content to a database, and do anything else a given API enables you to do.
diff --git a/docs/insomnia/get-started/documents/generate-collection.md b/docs/insomnia/get-started/documents/generate-collection.md
new file mode 100644
index 00000000..36a86791
--- /dev/null
+++ b/docs/insomnia/get-started/documents/generate-collection.md
@@ -0,0 +1,6 @@
+---
+layout: article-detail
+title: Generate a Collection
+---
+
+
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/pre-request-script.md b/docs/insomnia/get-started/documents/pre-request-script.md
new file mode 100644
index 00000000..5f2c28ac
--- /dev/null
+++ b/docs/insomnia/get-started/documents/pre-request-script.md
@@ -0,0 +1,6 @@
+---
+layout: article-detail
+title: Add a pre-request script
+---
+
+
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/spec.md b/docs/insomnia/get-started/documents/spec.md
new file mode 100644
index 00000000..544f2bf4
--- /dev/null
+++ b/docs/insomnia/get-started/documents/spec.md
@@ -0,0 +1,6 @@
+---
+layout: article-detail
+title: Import an OpenAPI Spec
+---
+
+
\ No newline at end of file
diff --git a/docs/insomnia/get-started/documents/test.md b/docs/insomnia/get-started/documents/test.md
new file mode 100644
index 00000000..f24f3107
--- /dev/null
+++ b/docs/insomnia/get-started/documents/test.md
@@ -0,0 +1,6 @@
+---
+layout: article-detail
+title: Write your first test
+---
+
+
\ No newline at end of file
diff --git a/docs/insomnia/get-started.md b/docs/insomnia/get-started/index.md
similarity index 79%
rename from docs/insomnia/get-started.md
rename to docs/insomnia/get-started/index.md
index f91e7255..62269a2b 100644
--- a/docs/insomnia/get-started.md
+++ b/docs/insomnia/get-started/index.md
@@ -1,10 +1,24 @@
---
layout: article-detail
title: Introduction to Insomnia
-category: "Get Started"
-category-url: get-started
---
+
+
Insomnia is an open source desktop application that takes the pain out of interacting with and designing, debugging, and testing APIs. Insomnia combines an easy-to-use interface with advanced functionality like authentication helpers, code generation, and environment variables.

diff --git a/docs/insomnia/install.md b/docs/insomnia/get-started/install.md
similarity index 51%
rename from docs/insomnia/install.md
rename to docs/insomnia/get-started/install.md
index e1a11695..4b2fae6b 100644
--- a/docs/insomnia/install.md
+++ b/docs/insomnia/get-started/install.md
@@ -1,15 +1,13 @@
---
layout: article-detail
title: Install Insomnia
-category: "Get Started"
-category-url: get-started
---
Insomnia is available on macOS, Windows, and Linux. If you haven't already downloaded Insomnia, visit the [Download Page](https://insomnia.rest/download).
-The Windows application is a generic installer .exe. Double click the installer file to install Insomnia in your existing filesystem. This option is recommended, as it will enable automatic app updates.
-
-
Uninstall on Windows
-To uninstall Insomnia from a Windows computer, go to the settings menu on Windows and select Apps.
+Download Insomnia on Windows
-From the Add/Remove Programs section, click on the app and select to uninstall.
+The Windows application is a generic installer .exe.
-Insomnia runs on common Linux distributions.
+
Ubuntu and Debian
+The Debian package apt repository can be added and installed using apt-get:
-
Ubuntu and Debian
-The Debian package apt repository can be added and installed using apt-get.
-
-
# Add to sources
+1. Add the package to sources:
+
-Snap is a new cross-platform package format that supports convenient auto-updates. You can view Insomnia on Snapcraft or install it directly with the following command.
+Snap is a cross-platform package format that supports convenient auto-updates. You can install Insomnia on Snapcraft or install it directly:
sudo snap install insomnia
-There's also an AppImage package that can be run directly as an executable.
+You can also run a AppImage package as an executable.
Troubleshooting Linux Installations
-Here are some issues that have caused problems for Linux users in the past:
+Use the following recommendations if you're encountering problems while installing Insomnia on Linux:
-## Previous Insomnia Versions
+## Install older Insomnia versions
-To roll back to a previous Insomnia version, download the version from [GitHub Releases](https://github.com/kong/insomnia/releases). This process is only intended for debugging and emergencies, as the app will try to update itself after it launches.
+To roll back to a previous Insomnia version, download the version from the [GitHub Releases](https://github.com/kong/insomnia/releases). This is only intended for debugging and emergencies, as the app will try to update itself after it launches.
diff --git a/docs/insomnia/get-started/mock-server/allowlist.md b/docs/insomnia/get-started/mock-server/allowlist.md
new file mode 100644
index 00000000..bb7a65d6
--- /dev/null
+++ b/docs/insomnia/get-started/mock-server/allowlist.md
@@ -0,0 +1,24 @@
+---
+layout: article-detail
+title: Allowlist for Insomnia
+---
+
+Ensure the following domains are allowlisted to use Insomnia:
+
+| Hostname | Description |
+| -------- | ----------- |
+| `insomnia.rest` | Main website for Insomnia. |
+| `ai.insomnia.rest` | Handles AI-related features in Insomnia. |
+| `api.insomnia.rest` | API endpoint for Insomnia services. |
+| `docs.insomnia.rest` | Provides access to Insomnia's documentation and user guides. |
+| `mock.insomnia.rest` | Used for the Insomnia app's [mocking feature](/insomnia/api-mocking). |
+| `updates.insomnia.rest` | For receiving software updates and patches. |
+| `auth.insomnia.rest` | Manages authentication processes for Insomnia. |
+| `insomnia-prod.us.auth0.com` | A domain linked to authentication used for secure logins. |
+| `djvq2ky33rnc.cloudfront.net` | A CDN domain for hosting static assets related to Insomnia. |
+| `api.segment.io` | Used for analytics and telemetry within Insomnia. |
+| `o1147619.ingest.sentry.io` | Used for error reporting and monitoring to enhance the application's stability and performance. |
+
+You might need to restart your firewall or web filter after adding these to the allowlist.
+
+If you have issues after allowlisting Insomnia hostnames, contact your IT support or reach out to Insomnia's customer service at or .
diff --git a/docs/insomnia/import-export-data.md b/docs/insomnia/get-started/mock-server/import-export-data.md
similarity index 96%
rename from docs/insomnia/import-export-data.md
rename to docs/insomnia/get-started/mock-server/import-export-data.md
index 23e007b5..05051b0a 100644
--- a/docs/insomnia/import-export-data.md
+++ b/docs/insomnia/get-started/mock-server/import-export-data.md
@@ -1,10 +1,10 @@
---
layout: article-detail
-title: Import and Export Data
-category: "Get Started"
-category-url: get-started
+title: Import data from another API client
---
+
+
Insomnia supports importing and exporting. Currently, the supported import formats are Insomnia, Postman v2, HAR, OpenAPI (versions 3.0, 3.1), Swagger, WSDL, and cURL.
## Export Data
diff --git a/docs/insomnia/proxy.md b/docs/insomnia/get-started/mock-server/proxy.md
similarity index 88%
rename from docs/insomnia/proxy.md
rename to docs/insomnia/get-started/mock-server/proxy.md
index 440011e6..4c520f6e 100644
--- a/docs/insomnia/proxy.md
+++ b/docs/insomnia/get-started/mock-server/proxy.md
@@ -1,10 +1,10 @@
---
layout: article-detail
-title: Proxy
-category: "Get Started"
-category-url: get-started
+title: Configure a proxy server
---
+
+
Insomnia does not automatically detect system-wide proxy settings. A proxy can be set up manually. Set your HTTP, HTTPS, SOCKS4 or SOCKS5 proxy server and reroute all future requests through that server by accessing Preferences via the cog icon > **General** > **HTTP Network Proxy**.
{:.alert .alert-primary}
diff --git a/docs/vercel.json b/docs/vercel.json
index 6c0e3b2c..f76f0f8d 100644
--- a/docs/vercel.json
+++ b/docs/vercel.json
@@ -123,6 +123,12 @@
{ "source": "/category/(.*)", "destination": "/", "permanent": false },
{ "source": "/collection/(.*)", "destination": "/", "permanent": false },
- { "source": "/insomnia/team-collaboration", "destination": "/insomnia/teams", "permanent": false}
+ { "source": "/insomnia/team-collaboration", "destination": "/insomnia/teams", "permanent": false},
+
+ { "source": "/insomnia/install", "destination": "/insomnia/get-started/install", "permanent": false},
+ { "source": "/insomnia/send-your-first-request", "destination": "/insomnia/get-started/collections/send-your-first-request", "permanent": false},
+ { "source": "/insomnia/import-export-data", "destination": "/insomnia/get-started/mock-server/import-export-data", "permanent": false},
+ { "source": "/insomnia/enterprise-ip-whitelist-guide", "destination": "/insomnia/get-started/mock-server/allowlist", "permanent": false},
+ { "source": "/insomnia/proxy", "destination": "/insomnia/get-started/mock-server/proxy", "permanent": false}
]
}