Add Invite Links article

content/installation-and-setup/index.mdx

@@ -6,6 +6,7 @@ schemaType: WebPage
 ---
 
 - [Installation](https://support.keet.io/installation-and-setup/installation.md)
+- [Invite Links](https://support.keet.io/installation-and-setup/invite-links.md)
 - [Setup](https://support.keet.io/installation-and-setup/setup.md)
 - [Back Up Your Profile](https://support.keet.io/installation-and-setup/back-up-your-profile.md)
 - [App Permissions](https://support.keet.io/installation-and-setup/app-permissions.md)

content/installation-and-setup/invite-links.mdx

@@ -0,0 +1,77 @@
+---
+title: "Invite Links"
+description: "Clicking a Keet room link, scanning a room QR code, or scanning someone's profile QR code takes you straight into the app — or guides you to install it first and lands you right back where you started."
+docType: faq
+schemaType: TechArticle
+---
+
+You can be invited into Keet in three ways:
+
+* Click a Keet room link (`https://keet.io/chat#...`)
+* Scan a Keet room QR code
+* Scan a user's profile QR code
+
+All three work the same way. If Keet is already installed, you're taken straight into the room or chat. If it isn't installed yet, you're guided to download the app first — once you open it, you land right back in the room or chat you were invited to, with no need to click the link or scan the code again.
+
+## If Keet is already installed
+
+The link or QR code opens Keet directly and continues into the intended action — [joining the group](/keet-groups/joining-groups) or starting the chat.
+
+## If Keet is not installed
+
+The link or QR code opens a join page in your browser instead. This page explains what you're joining and offers two options: **Open Keet** (if you already have it) or **Download Keet** to install it first.
+
+<Tabs items={["Desktop", "Mobile"]}>
+<Tab value="Desktop">
+
+The join page shows the group or profile you're invited to, download links for your device, and a QR code you can scan with your phone instead:
+
+![The Keet join page in a desktop browser, showing who invited you, the app download links, and a QR code to join from a phone.](/images/installation-and-setup/invite-links/desktop-join-page.jpg "Invite Links · Desktop")
+
+Pick the download that matches your operating system:
+
+<Tabs items={["Windows", "MacOS", "Linux"]}>
+<Tab value="Windows">
+
+![The Windows download options on keet.io, offering .exe and .msix installers.](/images/installation-and-setup/invite-links/desktop-download-windows.jpg "Invite Links · Windows")
+
+</Tab>
+<Tab value="MacOS">
+
+![The keet.io download page showing macOS Apple Silicon and Intel download links.](/images/installation-and-setup/invite-links/desktop-download-macos.jpg "Invite Links · MacOS")
+
+</Tab>
+<Tab value="Linux">
+
+![The Linux download options on keet.io, including the Snap Store, ARM64/x64 builds, and required dependencies.](/images/installation-and-setup/invite-links/desktop-download-linux.jpg "Invite Links · Linux")
+
+</Tab>
+</Tabs>
+
+Once Keet is installed and you open it, it continues straight into the room or chat you were invited to — you don't need to click the invite link again.
+
+<Callout type="info">
+If opening the app automatically doesn't work, you can always paste the `https://keet.io/chat#...` link into the **Search or paste invite link** field inside Keet — the same way it works on mobile.
+</Callout>
+
+</Tab>
+<Tab value="Mobile">
+
+The join page shows the group or profile you're invited to, with links to the App Store, Google Play, or desktop, plus a QR code and a button to join once you have the app:
+
+![The Keet join page on mobile, with App Store, Google Play and Desktop links, a QR code, and a 'Join here' button.](/images/installation-and-setup/invite-links/mobile-join-page.jpg "Invite Links · Mobile")
+
+You can also get to the same download links from [keet.io/download](https://keet.io/download):
+
+![The keet.io download page on mobile, with a QR code, App Store, Google Play, and APK download links.](/images/installation-and-setup/invite-links/mobile-download-page.jpg "Invite Links · Mobile download page")
+
+Install Keet from the [App Store](https://apps.apple.com/lu/app/keet-by-holepunch/id6443880549) (iOS) or [Google Play](https://play.google.com/store/apps/details?id=io.keet.app) (Android), then open the app. It continues straight into the room or chat you were invited to — no need to tap the link or rescan the code again.
+
+</Tab>
+</Tabs>
+
+<Callout type="info">
+For the full list of supported platforms and versions, see [Installation](/installation-and-setup/installation).
+</Callout>
+
+If you're having trouble joining after installing Keet, please email us at `support@holepunch.to`

content/keet-groups/invite-peers.mdx

@@ -37,3 +37,7 @@ If you're facing issues joining the group using the invite link, please ask your
 <Callout type="info">
 If you are experiencing further issues, please [submit a bug report](/technical-support-and-troubleshooting/submit-a-report) to the '**Bug Bandits**' group and our team will look into it.
 </Callout>
+
+## What if my peer doesn't have Keet installed?
+
+They don't need to install it first. Sharing the invite link or QR code guides them to download Keet, and once they open the app, they're taken straight into the group — see [Invite Links](/installation-and-setup/invite-links) for the full flow.

content/keet-groups/joining-groups.mdx

@@ -13,6 +13,10 @@ When you receive an invite link from a peer (keet://...) , just click it or copy
 
 ![When you receive an invite link from a peer (keet://...) , just click it or copy & paste it into the search….](/images/keet-groups/joining-groups/receive-invite-link-peer-keet.png "Joining Groups 🛋️")
 
+<Callout type="info">
+Don't have Keet yet? See [Invite Links](/installation-and-setup/invite-links) to learn what happens when you click a room link, scan a room QR code, or scan a profile QR code before installing the app.
+</Callout>
+
 ### Join with a QR Code
 
 You can use your camera to scan a QR code or upload it as a file. Here's how:

src/lib/custom-tree.ts

@@ -19,6 +19,7 @@ export const customTree: Node[] = [
     },
     children: [
       { type: 'page', name: 'Installation', url: '/installation-and-setup/installation' },
+      { type: 'page', name: 'Invite Links', url: '/installation-and-setup/invite-links' },
       { type: 'page', name: 'Setup', url: '/installation-and-setup/setup' },
       { type: 'page', name: 'Back Up Your Profile', url: '/installation-and-setup/back-up-your-profile' },
       { type: 'page', name: 'App Permissions', url: '/installation-and-setup/app-permissions' },

src/lib/image-dimensions.generated.ts

@@ -48,96 +48,99 @@ export const imageDimensions = {
     "height": 867,
     "width": 648
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/banner-multiple-videos.png": {
+  "/images/file-sharing-and-messages/contact-indicators/desktop/contact-indicator-in-dm.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/banner-single-video.png": {
+  "/images/file-sharing-and-messages/contact-indicators/desktop/dm-request-notification.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/conversion-failed-retry.png": {
+  "/images/file-sharing-and-messages/contact-indicators/desktop/dm-request-review.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/conversion-success.png": {
+  "/images/file-sharing-and-messages/contact-indicators/desktop/profile-card-not-saved-contact.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/converting-progress.png": {
+  "/images/file-sharing-and-messages/contact-indicators/desktop/profile-card-saved-contact.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/video-too-large.png": {
+  "/images/file-sharing-and-messages/contact-indicators/desktop/trust-label-in-group.png": {
     "width": 1224,
-    "height": 810
+    "height": 874
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/banner-multiple-videos.png": {
+  "/images/file-sharing-and-messages/contact-indicators/mobile/contact-indicator-in-dm.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/banner-single-video.png": {
+  "/images/file-sharing-and-messages/contact-indicators/mobile/dm-request-notification.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/conversion-failed-retry.png": {
+  "/images/file-sharing-and-messages/contact-indicators/mobile/dm-request-review.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/conversion-success.png": {
+  "/images/file-sharing-and-messages/contact-indicators/mobile/profile-card-not-saved-contact.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/converting-progress.png": {
+  "/images/file-sharing-and-messages/contact-indicators/mobile/profile-card-saved-contact.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/video-too-large.png": {
-  "/images/file-sharing-and-messages/contact-indicators/desktop/contact-indicator-in-dm.png": {
+  "/images/file-sharing-and-messages/contact-indicators/mobile/trust-label-in-group.png": {
+    "width": 393,
+    "height": 852
+  },
+  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/banner-multiple-videos.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/contact-indicators/desktop/dm-request-notification.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/banner-single-video.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/contact-indicators/desktop/dm-request-review.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/conversion-failed-retry.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/contact-indicators/desktop/profile-card-not-saved-contact.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/conversion-success.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/contact-indicators/desktop/profile-card-saved-contact.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/converting-progress.png": {
     "width": 1224,
     "height": 810
   },
-  "/images/file-sharing-and-messages/contact-indicators/desktop/trust-label-in-group.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/desktop/video-too-large.png": {
     "width": 1224,
-    "height": 874
+    "height": 810
   },
-  "/images/file-sharing-and-messages/contact-indicators/mobile/contact-indicator-in-dm.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/banner-multiple-videos.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/contact-indicators/mobile/dm-request-notification.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/banner-single-video.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/contact-indicators/mobile/dm-request-review.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/conversion-failed-retry.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/contact-indicators/mobile/profile-card-not-saved-contact.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/conversion-success.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/contact-indicators/mobile/profile-card-saved-contact.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/converting-progress.png": {
     "width": 393,
     "height": 852
   },
-  "/images/file-sharing-and-messages/contact-indicators/mobile/trust-label-in-group.png": {
+  "/images/file-sharing-and-messages/convert-incompatible-videos/mobile/video-too-large.png": {
     "width": 393,
     "height": 852
   },
@@ -421,6 +424,30 @@ export const imageDimensions = {
     "width": 690,
     "height": 304
   },
+  "/images/installation-and-setup/invite-links/desktop-download-linux.jpg": {
+    "height": 477,
+    "width": 720
+  },
+  "/images/installation-and-setup/invite-links/desktop-download-macos.jpg": {
+    "height": 417,
+    "width": 720
+  },
+  "/images/installation-and-setup/invite-links/desktop-download-windows.jpg": {
+    "height": 417,
+    "width": 720
+  },
+  "/images/installation-and-setup/invite-links/desktop-join-page.jpg": {
+    "height": 413,
+    "width": 720
+  },
+  "/images/installation-and-setup/invite-links/mobile-download-page.jpg": {
+    "height": 969,
+    "width": 360
+  },
+  "/images/installation-and-setup/invite-links/mobile-join-page.jpg": {
+    "height": 975,
+    "width": 360
+  },
   "/images/installation-and-setup/keet-username/change-username.png": {
     "width": 820,
     "height": 580