From 0cf3a055d381339289fa9e435999ceae008b7279 Mon Sep 17 00:00:00 2001
From: saturneric <eric@bktus.com>
Date: Sat, 28 Jun 2025 02:02:24 +0200
Subject: docs(overview): add Downloads section with installation options and
 asset descriptions

---
 src/content/docs/overview/downloads.mdx | 93 +++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 src/content/docs/overview/downloads.mdx

(limited to 'src/content/docs/overview/downloads.mdx')

diff --git a/src/content/docs/overview/downloads.mdx b/src/content/docs/overview/downloads.mdx
new file mode 100644
index 0000000..6f1935a
--- /dev/null
+++ b/src/content/docs/overview/downloads.mdx
@@ -0,0 +1,93 @@
+---
+title: Downloads
+sidebar:
+  order: 3
+---
+
+GpgFrontend is available for download through multiple channels. For more
+detailed instructions on installation and getting started, please refer to the
+[Getting Started Guide](/overview/getting-started/).
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/gpgfrontend.svg)](https://repology.org/project/gpgfrontend/versions)
+
+import { LinkCard, CardGrid } from "@astrojs/starlight/components";
+import { Tabs, TabItem, Badge } from "@astrojs/starlight/components";
+
+## Direct Downloads
+
+![GitHub Release](https://img.shields.io/github/v/release/saturneric/GpgFrontend?style=for-the-badge)
+
+Choose from the options below to download GpgFrontend for your platform:
+
+<CardGrid>
+  <LinkCard
+    title="GitHub Releases"
+    href="https://github.com/saturneric/GpgFrontend/releases/latest"
+    description="Fastest and most up-to-date source for stable builds. Recommended for most users."
+  />
+  <LinkCard
+    title="Privacy-Friendly HTTPS Mirror"
+    href="https://ftp.bktus.com/GpgFrontend/"
+    description="Direct, secure download. No tracking, no authentication, no rate limits, no redirections."
+  />
+</CardGrid>
+
+### Asset Naming Patterns and Descriptions
+
+Below is a summary table explaining the naming patterns and purposes of each
+downloadable asset. You can use the filename patterns to quickly identify and
+select the appropriate package for your platform or use case.
+
+| Filename Pattern                  | Description                                                                                 |
+| --------------------------------- | ------------------------------------------------------------------------------------------- |
+| `***-universal.zip`               | The universal package: contains both Windows Portable and Linux AppImage in one archive.    |
+| `***-windows-x86_64-portable.zip` | Fully portable Windows version. No installation needed; just extract and run.               |
+| `***-windows-x86_64.msix`         | MSIX installer for Windows (recommended for most Windows users).                            |
+| `***-windows-x86_64.msi`          | Classic MSI installer for Windows; suitable for legacy/enterprise environments.             |
+| `***-macos-**.dmg`                | macOS disk image; number = minimum required macOS version. Drag to install.                 |
+| `***-linux-******.AppImage`       | AppImage for Linux; make it executable and run directly.                                    |
+| `*.sig`                           | GPG signature file for verifying the integrity and authenticity of the corresponding asset. |
+
+## Homebrew Cask
+
+Mac users can check the version information through the badge below or install
+using the command line.
+
+[![Homebrew Cask](https://img.shields.io/homebrew/cask/v/gpgfrontend?style=for-the-badge)](https://formulae.brew.sh/cask/gpgfrontend)
+
+Install command:
+
+```
+brew install --cask gpgfrontend
+```
+
+## Flatpak
+
+Linux users can click the image below to navigate to the Flathub page for
+installation.
+
+[![Download on Flathub](https://flathub.org/api/badge?locale=en)](https://flathub.org/apps/com.bktus.gpgfrontend)
+
+## Windows
+
+There are several convenient ways to install GpgFrontend on Windows. Choose the
+method that best fits your workflow.
+
+<Tabs>
+  <TabItem label="WinGet">
+    Install directly using the command line.
+
+    ```shell
+    winget install Saturneric.GpgFrontend
+    ```
+
+  </TabItem>
+  <TabItem label="Microsoft Store">
+    Visit the application store page via the badge below:
+
+    <a href="https://apps.microsoft.com/detail/9nh716mqk2b5?referrer=appbadge&mode=direct">
+      <img src="https://get.microsoft.com/images/en-us%20dark.svg" width="200"/>
+    </a>
+
+  </TabItem>
+</Tabs>
-- 
cgit v1.2.3

