diff --git a/content/installation-and-setup/index.mdx b/content/installation-and-setup/index.mdx
index d52daf1..5ee91ff 100644
--- a/content/installation-and-setup/index.mdx
+++ b/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)
diff --git a/content/installation-and-setup/invite-links.mdx b/content/installation-and-setup/invite-links.mdx
new file mode 100644
index 0000000..21b2ab2
--- /dev/null
+++ b/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.
+
+
+
+
+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:
+
+
+
+Pick the download that matches your operating system:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+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.
+
+
+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.
+
+
+
+
+
+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:
+
+
+
+You can also get to the same download links from [keet.io/download](https://keet.io/download):
+
+
+
+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.
+
+
+
+
+
+For the full list of supported platforms and versions, see [Installation](/installation-and-setup/installation).
+
+
+If you're having trouble joining after installing Keet, please email us at `support@holepunch.to`
diff --git a/content/keet-groups/invite-peers.mdx b/content/keet-groups/invite-peers.mdx
index e471f03..a196a98 100644
--- a/content/keet-groups/invite-peers.mdx
+++ b/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
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.
+
+## 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.
diff --git a/content/keet-groups/joining-groups.mdx b/content/keet-groups/joining-groups.mdx
index 46fc657..1eda7b2 100644
--- a/content/keet-groups/joining-groups.mdx
+++ b/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
+
+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.
+
+
### Join with a QR Code
You can use your camera to scan a QR code or upload it as a file. Here's how:
diff --git a/public/images/installation-and-setup/invite-links/desktop-download-linux.jpg b/public/images/installation-and-setup/invite-links/desktop-download-linux.jpg
new file mode 100644
index 0000000..ccd1e56
Binary files /dev/null and b/public/images/installation-and-setup/invite-links/desktop-download-linux.jpg differ
diff --git a/public/images/installation-and-setup/invite-links/desktop-download-macos.jpg b/public/images/installation-and-setup/invite-links/desktop-download-macos.jpg
new file mode 100644
index 0000000..ee4496f
Binary files /dev/null and b/public/images/installation-and-setup/invite-links/desktop-download-macos.jpg differ
diff --git a/public/images/installation-and-setup/invite-links/desktop-download-windows.jpg b/public/images/installation-and-setup/invite-links/desktop-download-windows.jpg
new file mode 100644
index 0000000..2d1eec6
Binary files /dev/null and b/public/images/installation-and-setup/invite-links/desktop-download-windows.jpg differ
diff --git a/public/images/installation-and-setup/invite-links/desktop-join-page.jpg b/public/images/installation-and-setup/invite-links/desktop-join-page.jpg
new file mode 100644
index 0000000..8651c7e
Binary files /dev/null and b/public/images/installation-and-setup/invite-links/desktop-join-page.jpg differ
diff --git a/public/images/installation-and-setup/invite-links/mobile-download-page.jpg b/public/images/installation-and-setup/invite-links/mobile-download-page.jpg
new file mode 100644
index 0000000..0de9d89
Binary files /dev/null and b/public/images/installation-and-setup/invite-links/mobile-download-page.jpg differ
diff --git a/public/images/installation-and-setup/invite-links/mobile-join-page.jpg b/public/images/installation-and-setup/invite-links/mobile-join-page.jpg
new file mode 100644
index 0000000..2d8eeec
Binary files /dev/null and b/public/images/installation-and-setup/invite-links/mobile-join-page.jpg differ
diff --git a/src/lib/custom-tree.ts b/src/lib/custom-tree.ts
index 1361ab7..44e5916 100644
--- a/src/lib/custom-tree.ts
+++ b/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' },
diff --git a/src/lib/image-dimensions.generated.ts b/src/lib/image-dimensions.generated.ts
index 17ad529..8263e6e 100644
--- a/src/lib/image-dimensions.generated.ts
+++ b/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