From cb2c3127a05a88a7e750e10c1c41b0e3b290b867 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 Jan 2026 13:59:44 +0000
Subject: [PATCH 1/2] Initial plan


From 6990043287602b517eb0aef6d9ba07d105643634 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 22 Jan 2026 14:52:56 +0000
Subject: [PATCH 2/2] Add FAQ guide for releasing and distributing Desktop
 applications

Co-authored-by: dominicletz <2987674+dominicletz@users.noreply.github.com>
---
 guides/faq.md | 35 +++++++++++++++++++++++++++++++++++
 mix.exs       |  3 ++-
 2 files changed, 37 insertions(+), 1 deletion(-)
 create mode 100644 guides/faq.md

diff --git a/guides/faq.md b/guides/faq.md
new file mode 100644
index 0000000..eae7241
--- /dev/null
+++ b/guides/faq.md
@@ -0,0 +1,35 @@
+# Frequently Asked Questions (FAQ)
+
+## How do I release and distribute my Desktop application?
+
+### Creating an Installer
+
+To create a distributable installer for your Desktop application, use the following command:
+
+```bash
+mix desktop.installer
+```
+
+This command will create platform-specific installers for Windows, macOS, and Linux that you can distribute to your users.
+
+### About `mix release`
+
+While `mix release` is a standard Elixir command for creating releases, it's not the recommended approach for Desktop applications. The `mix release` command creates a standalone Erlang release, but it doesn't include the platform-specific packaging and UI components needed for a Desktop application.
+
+### Distribution
+
+After running `mix desktop.installer`, you'll find the installer files in your project's build directory. These are the files you should distribute to your users:
+
+- **Windows**: `.exe` installer file
+- **macOS**: `.dmg` or `.app` bundle
+- **Linux**: `.AppImage`, `.deb`, or `.rpm` package
+
+Users can simply download and run these installers to install your application on their system.
+
+### Getting Started
+
+If you're new to Elixir Desktop:
+
+1. Follow the [Getting your Environment Ready Guide](getting_started.md) to set up your development environment
+2. Create your first app with the [Your first Desktop App Guide](your_first_desktop_app.md)
+3. When ready to distribute, run `mix desktop.installer` to create platform-specific installers
diff --git a/mix.exs b/mix.exs
index ff3bc0d..4b65d59 100644
--- a/mix.exs
+++ b/mix.exs
@@ -105,7 +105,8 @@ defmodule Desktop.MixProject do
         "README.md": [title: "Overview"],
         "CHANGELOG.md": [title: "Changelog"],
         "guides/getting_started.md": [title: "Getting your Environment Ready"],
-        "guides/your_first_desktop_app.md": [title: "Your first Desktop App"]
+        "guides/your_first_desktop_app.md": [title: "Your first Desktop App"],
+        "guides/faq.md": [title: "FAQ"]
       ],
       main: "readme",
       source_ref: "v#{@version}",