Desktop app

desktop.mdx

@@ -0,0 +1,167 @@
+---
+title: "Desktop app"
+description: "Install the Mintlify desktop app for macOS, Windows, or Linux to use your dashboard and editor in a native window with tabs and keyboard shortcuts."
+tag: "New"
+---
+
+<Note>
+  The desktop app is in beta and subject to change.
+</Note>
+
+The Mintlify desktop app runs your [dashboard](https://app.mintlify.com) and [editor](/editor/index) on your computer. Work in tabs or multiple windows with access to the same content and settings you access in the browser.
+
+The desktop app updates content the same as working in the editor. It does not open or edit files on your computer. To work on local files, use the [CLI](/cli/index).
+
+<Frame>
+  <img
+    alt="The desktop app with three tabs open on different pages."
+    className="block dark:hidden"
+    src="/images/desktop-app/app-light.png"
+  />
+  <img
+    alt="The desktop app with three tabs open on different pages."
+    className="hidden dark:block"
+    src="/images/desktop-app/app-dark.png"
+  />
+</Frame>
+
+## Install
+
+<Tabs>
+  <Tab title="macOS">
+    Requires macOS 14 or later on Apple silicon.
+
+    1. Download the desktop app from [mintlify.com/desktop](https://mintlify.com/desktop).
+    2. Open the file.
+    3. Drag **Mintlify** to your **Applications** folder.
+
+    You can also install from the terminal.
+
+    ```bash Install the desktop app
+    curl -fsSL https://desktop.mintlify.com/install.sh | bash
+    ```
+
+    The script installs to `/Applications`, or to `~/Applications` if you can't write to `/Applications`.
+  </Tab>
+  <Tab title="Windows">
+    Requires Windows 10 or later, 64-bit.
+
+    1. Download the desktop app from [mintlify.com/desktop](https://mintlify.com/desktop).
+    2. Run the installer.
+
+  </Tab>
+  <Tab title="Linux">
+    Requires an x86_64 machine. The desktop app is available as an AppImage and a `.deb` package.
+
+    Download either file from [mintlify.com/desktop](https://mintlify.com/desktop) or install the AppImage from the terminal.
+
+    ```bash Install the desktop app
+    curl -fsSL https://desktop.mintlify.com/install.sh | bash
+    ```
+
+    The script installs the app to `~/.local/share/mintlify-desktop`, adds a `mintlify-desktop` command to `~/.local/bin`, and adds Mintlify to your application menu.
+
+    AppImages require FUSE 2. If the desktop app doesn't start, install FUSE 2. On Ubuntu:
+
+    ```bash Install FUSE 2
+    sudo apt install libfuse2
+    ```
+  </Tab>
+</Tabs>
+
+## Sign in
+
+1. Open the desktop app. The desktop app shows a **Log in to Mintlify** screen.
+2. Click **Log in here instead**.
+3. Sign in the same way you sign in to your dashboard in your browser.
+
+<Note>
+  Browser-based login is not available during beta access. You cannot use the **Continue in browser** button to sign in.
+</Note>
+
+## Tabs and windows
+
+Open each page you're working on in its own tab or window. Tabs and windows reopen where you left them when you restart the app.
+
+Right-click a tab to duplicate it, copy its link, or close other tabs. Middle-click a tab to close it.
+
+To show tabs in a sidebar instead of across the top of the window, change the tab layout in [Settings](#settings).
+
+### Each tab has its own session
+
+A new tab opens signed in to the same account and organization as the tab you opened it from. After that, each tab keeps its own session:
+
+- Switching organizations in one tab doesn't change your other tabs, so you can work in different organizations side by side.
+- Signing out or signing in to a different account only affects that tab.
+
+To sign out everywhere, use **Clear all data** in [Settings](#settings).
+
+### Links to other sites
+
+Tabs only load the Mintlify dashboard and the services it uses for signing in, accessing credits for AI features, and connecting Git providers. Links to any other site open in your default browser.
+
+## Keyboard shortcuts
+
+On Windows and Linux, use <kbd>Ctrl</kbd> instead of <kbd>Cmd</kbd>.
+
+| Action | Shortcut |
+| :--- | :--- |
+| New tab | <kbd>Cmd</kbd> + <kbd>T</kbd> |
+| New window | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>N</kbd> |
+| Close tab | <kbd>Cmd</kbd> + <kbd>W</kbd> |
+| Close window | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>W</kbd> |
+| Go to tab 1-9 | <kbd>Cmd</kbd> + <kbd>1</kbd>-<kbd>9</kbd> |
+| Next tab | <kbd>Ctrl</kbd> + <kbd>Tab</kbd> |
+| Previous tab | <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>Tab</kbd> |
+| Back | <kbd>Cmd</kbd> + <kbd>[</kbd> |
+| Forward | <kbd>Cmd</kbd> + <kbd>]</kbd> |
+| Reload | <kbd>Cmd</kbd> + <kbd>R</kbd> |
+| Copy page URL | <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>C</kbd> |
+| Open settings | <kbd>Cmd</kbd> + <kbd>,</kbd> |
+
+For shortcuts inside the editor, see [Keyboard shortcuts](/editor/keyboard-shortcuts).
+
+## Settings
+
+Open settings with <kbd>Cmd</kbd> + <kbd>,</kbd> on macOS or <kbd>Ctrl</kbd> + <kbd>,</kbd> on Windows and Linux.
+
+- **Tab layout**: Show tabs across the top of the window (**Horizontal**) or in a sidebar (**Vertical**).
+- **Clear all data**: Sign out of every tab, close all tabs, and reset settings. The app restarts.
+
+The settings window also shows the app version.
+
+## Updates
+
+The app checks for updates when it starts and every four hours while it runs. When an update is available, an **Update** button appears in the tab bar.
+
+- **macOS**: Click **Update** to download and install the update in the app.
+- **Windows and Linux**: Click **Update** to download the new version from your browser, then install it.
+
+## Uninstall
+
+<Tabs>
+  <Tab title="macOS">
+    1. Quit the desktop app.
+    2. Move **Mintlify** from your **Applications** folder to the Trash.
+    3. To remove your sign-in and settings, delete `~/Library/Application Support/Mintlify Electron`.
+  </Tab>
+  <Tab title="Windows">
+    1. Open **Settings** > **Apps** > **Installed apps**.
+    2. Find **Mintlify** and select **Uninstall**.
+    3. To remove your sign-in and settings, delete `%APPDATA%\Mintlify Electron`.
+  </Tab>
+  <Tab title="Linux">
+    If you installed the desktop app with the script, delete the files it created:
+
+    ```bash Remove the desktop app
+    rm -rf ~/.local/share/mintlify-desktop \
+      ~/.local/bin/mintlify-desktop \
+      ~/.local/share/applications/mintlify-desktop.desktop \
+      ~/.local/share/icons/hicolor/512x512/apps/mintlify-desktop.png
+    ```
+
+    If you installed the `.deb` package, remove it with your package manager.
+
+    To remove your sign-in and settings, delete `~/.config/Mintlify Electron`.
+  </Tab>
+</Tabs>

docs.json

@@ -42,6 +42,7 @@
                       "cli/commands"
                     ]
                   },
+                  "desktop",
                   {
                     "group": "Migration guide",
                     "root": "migration/index",