From 92706c2532d4202eedc9246822f61a1f6d6fe286 Mon Sep 17 00:00:00 2001 From: Ahmed Taha Date: Tue, 9 Dec 2025 13:04:53 +0200 Subject: [PATCH] Include warning for Windows symbolic link issues Add warning about symbolic links on Windows for Flet apps. --- docs/getting-started/index.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/getting-started/index.md b/docs/getting-started/index.md index 77c28203..09cf9aef 100644 --- a/docs/getting-started/index.md +++ b/docs/getting-started/index.md @@ -200,3 +200,14 @@ Now you are ready to [create your first Flet app](create-flet-app). When [creating](create-flet-app) and [running](running-app) Flet app using uv, you'll need to use `uv run` before each command! ::: +:::warning +On Windows, Flet apps may exit silently if `uv` uses **symbolic links** to manage the virtual environment. Flet requires **hardlink** (default) or **copy** mode to correctly locate its binary dependencies. + +If you encounter this issue, force the link mode to `copy` in your `pyproject.toml`: + +```toml +[tool.uv] +link-mode = "copy" #or "hardlink" +``` +::: +