Share link product docs

docs.json

@@ -40,6 +40,7 @@
               "product/theming",
               "product/files",
               "product/responsive-design",
+              "product/sharing",
               {
                 "group": "Panels",
                 "icon": "sliders",

product/sharing.mdx

@@ -0,0 +1,100 @@
+---
+title: "Sharing"
+description: "Makeswift allows you to share previews of different versions of your site for collaboration and feedback."
+icon: "share" iconType: "solid"
+---
+
+<Warning>
+  Sharing requires a [custom host](/product/site/hosting#custom-host) running at least `v0.25.0` of the runtime. To upgrade, see our [runtime upgrade guide](/developer/upgrading/0.25.0).
+</Warning>
+
+Makeswift allows you to share different versions of your site for enhanced collaboration and feedback. In the Visual Builder, you can create shareable links to different site versions, which you can then send to your team members or stakeholders.
+
+Anyone with these links can view the shared version of your site directly on your site's domain itself. This means that site previews can be viewed on any device, including phones and tablets.
+
+You can generate shareable links for any of the following:
+
+- The current draft state of your site in the Visual Builder
+- A particular scheduled publish
+- A specific previous publish of your site
+
+## Privacy
+
+Shareable links are site-wide previews. This means that a recipient of a share link will be able to view the entire site as it was in the shared version.
+
+All share links expire after 5 days. After expiration, visiting the share link will result in an error, and users will no longer be able to see the shared version of the site.
+
+By default, share links can only be accessed by other members of your Makeswift workspace. To create a public share link, see the [Public Share Links](#public-share-links) section.
+
+## Sharing Draft State
+
+To share the draft state (the current state of your site in the Visual Builder), click on the "Share" button in the top right corner of the Visual Builder header.
+This will open a dialog that has a new shareable link generated for you. You can copy this link and share it with others.
+
+<Frame>
+  <video
+    autoPlay
+    muted
+    loop
+    playsInline
+    controls
+    title="Sharing draft state"
+    className="w-full aspect-video"
+    src="/images/sharing/draft-share.mp4"
+  ></video>
+</Frame>
+
+## Sharing a Scheduled Publish
+
+To share a particular scheduled publish, open the publish dialog and navigate to the "Scheduled" tab. Hover over the scheduled publish you'd like to share and click the "Share" icon, which will open a dialog with a shareable link for that specific publish.
+
+<Frame>
+  <video
+    autoPlay
+    muted
+    loop
+    playsInline
+    controls
+    title="Sharing a scheduled publish"
+    className="w-full aspect-video"
+    src="/images/sharing/scheduled-publish-share.mp4"
+  ></video>
+</Frame>
+
+
+## Sharing a Previous Publish
+
+To share a specific previous publish, open the publish dialog and navigate to the "History" tab. Hover over the publish you'd like to share and click the "Share" icon, which will open a dialog with a shareable link for that specific publish.
+
+<Frame>
+  <video
+    autoPlay
+    muted
+    loop
+    playsInline
+    controls
+    title="Sharing a past publish"
+    className="w-full aspect-video"
+    src="/images/sharing/past-publish-share.mp4"
+  ></video>
+</Frame>
+
+## Public Share Links
+
+By default, a share link can only be accessed by other members of your Makeswift workspace. This means that in addition to sending the share link, you may also have to invite the recipient as a guest to your workspace.
+
+If you want your share link to be accessible by anyone, you can toggle the "Public preview" option when creating the share link. This will allow anyone with the link to view the shared version of your site without needing to be a member of your Makeswift workspace.
+
+<Frame>
+  ![Public preview toggle](/images/sharing/public-preview.png)
+</Frame>
+
+## Exiting the Preview
+
+When you visit a share link, you will see the shared version of the site directly on the site's domain, even after you refresh. To exit the preview and go back to viewing the live site, click the "Exit preview" button in the bottom right corner of the page. 
+
+<Frame>
+  ![Exit preview button](/images/sharing/exit-preview.png)
+</Frame>
+
+Alternatively, you can also clear your cookies for the site.