Release 1.9

docs/getting-started/add-existing-project.md → docs/getting-started/add-existing-project.mdx

@@ -9,17 +9,31 @@ tags:
   - godot-project-setup
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+
 # Add an Existing Project
 
 If you already have a Godot project, you can bring it into **Godot Launcher** instead of starting fresh.
 
 You can add projects in two ways:
 
-![Projects View showing Add button](/img/screenshots/screen_projects_view_dark.webp)
+<ThemedImage
+  alt="Projects View showing Add button"
+  sources={{
+    light: '/img/screenshots/screen_projects_view_light.webp',
+    dark: '/img/screenshots/screen_projects_view_dark.webp',
+  }}
+/>
 
 - **Add button**: Click **Add** in the **Projects** screen and select the folder containing your project’s `project.godot` file.
 
-![Projects View - Drop Overlay](/img/screenshots/screen_projects_drop_overlay_dark.webp)
+<ThemedImage
+  alt="Projects View - Drop Overlay"
+  sources={{
+    light: '/img/screenshots/screen_projects_drop_overlay_light.webp',
+    dark: '/img/screenshots/screen_projects_drop_overlay_dark.webp',
+  }}
+/>
 
 - **Drag and drop**: Open the **Projects** screen and drag one or more `project.godot` files onto the window. Each project imports automatically, and a progress indicator shows how many remain when adding multiple items.
 

docs/getting-started/create-project.mdx

@@ -0,0 +1,71 @@
+---
+id: create-project
+slug: /getting-started/create-project
+title: Creating a Project
+description: "Learn how to create your first project with Godot Launcher."
+tags:
+  - godot-project-setup
+  - getting-started
+  - setup-guide
+---
+
+import ThemedImage from '@theme/ThemedImage';
+
+# Create Your First Project
+
+You can create a new project and start editing in seconds, or choose to add an existing project to start using it with Godot Launcher.
+
+## Create a new Project
+
+By default, the launcher creates new projects inside the folder set in **Settings -> Projects -> Project Location**. In v1.9.0 you can keep that default and still override the path for one project when needed.
+
+<ThemedImage
+  alt="Godot Launcher - Create New Project with Overwrite Project Path"
+  sources={{
+    light: '/img/screenshots/screen_projects_new_project_overwrite_path_light.webp',
+    dark: '/img/screenshots/screen_projects_new_project_overwrite_path_dark.webp',
+  }}
+/>
+
+1. Navigate to the **Projects** section from the left-hand navigation menu.
+2. Click **Create Project**.
+3. Enter a project name and choose the Godot version you want to use.
+4. Leave **Overwrite Project Path** off to use your normal default location, or turn it on to pick a different parent folder for this project.
+5. Click the folder button to browse, or type a path manually.
+6. Click **Create Project** and, if enabled, **Edit now** to launch it immediately.
+
+When **Overwrite Project Path** is enabled, the launcher still creates a clean project folder using your project name. That means you choose the parent folder, and the launcher creates the final path as `{parent}/{project-name}`.
+
+Example parent folders:
+
+- Windows: `D:\Godot\Projects`
+- macOS: `/Users/you/Godot/Projects`
+- Linux: `/home/you/Godot/Projects`
+
+:::info
+Turning on **Overwrite Project Path** only changes the location for the project you are creating right now. It does not change your default Project Location in Settings.
+:::
+
+## Safety checks
+
+The launcher will not overwrite an existing project folder full of files.
+
+- If the target folder already exists and is empty, creation continues.
+- If the target folder already contains files, the launcher stops and shows an error.
+- If the selected path points to a file instead of a folder, the launcher stops and shows an error.
+
+If you meant to bring an existing project into the launcher, use [Add an Existing Project](/getting-started/add-existing-project) instead.
+
+## Add an Existing Project
+
+Already have a Godot project? Drag its `project.godot` file (or several at once) into the **Projects** screen, or click **Add** and pick the folder that contains `project.godot`. The launcher registers each project without moving any files and shows progress while importing multiple items. Every project then appears in your **Projects** list, ready to launch with the best matching editor.
+
+For version-selection rules, Mono handling, and integration details, visit [Add an Existing Project](/getting-started/add-existing-project).
+
+:::tip
+Looking for a refresher on setup defaults or editor locations before importing? Review [Launcher Settings](/getting-started/launcher-settings).
+:::
+
+:::important
+To open any project, including ones you import, simply click its name in the **Projects** list.
+:::

docs/getting-started/launcher-settings.md → docs/getting-started/launcher-settings.mdx

@@ -8,6 +8,8 @@ tags:
   - launcher-settings
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+
 # Launcher Settings
 
 The **Godot Launcher** includes a configurable **Settings** section that lets you tailor the launcher to your workflow. This guide covers each settings tab and explains how to adjust default paths, change the appearance, configure behavior, and set up tools like Git and Visual Studio Code.
@@ -16,25 +18,42 @@ The **Godot Launcher** includes a configurable **Settings** section that lets yo
 
 ## Projects Tab
 
-![Settings - Projects Tab](/img/screenshots/screen_settings_projects_dark.webp)
+<ThemedImage
+  alt="Settings - Projects Tab"
+  sources={{
+    light: '/img/screenshots/screen_settings_projects_light.webp',
+    dark: '/img/screenshots/screen_settings_projects_dark.webp',
+  }}
+/>
 
 The **Projects** tab allows you to define the default location where new Godot projects are created.
 
 - **Project Location**: Sets the base directory for newly created projects.
   - This does not affect existing projects already added to the launcher.
   - You can change this path at any time without impacting existing data.
+  - Starting with v1.9.0, you can still override this path per project from the **Create Project** dialog by enabling **Overwrite Project Path**.
 
 :::info
 Changing this location only affects _new_ projects created through the launcher.
 
 Adding existing projects will not move them to this location
 :::
 
+:::tip
+Need one project in a different place without changing your default? Use **Overwrite Project Path** while creating a project. See [Creating a Project](/getting-started/create-project).
+:::
+
 ---
 
 ## Installs Tab
 
-![Settings - Installs Tab](/img/screenshots/screen_settings_installs_dark.webp)
+<ThemedImage
+  alt="Settings - Installs Tab"
+  sources={{
+    light: '/img/screenshots/screen_settings_installs_light.webp',
+    dark: '/img/screenshots/screen_settings_installs_dark.webp',
+  }}
+/>
 
 The **Installs** tab lets you choose where Godot editor versions are stored.
 
@@ -56,7 +75,13 @@ The button have a 1 minute cooldown to prevent your from hitting the GitHub API
 
 ## Appearance Tab
 
-![Settings - Appearance Tab Showing the Language Picker](/img/screenshots/screen_settings_appearance_dark.webp)
+<ThemedImage
+  alt="Settings - Appearance Tab Showing the Language Picker"
+  sources={{
+    light: '/img/screenshots/screen_settings_appearance_light.webp',
+    dark: '/img/screenshots/screen_settings_appearance_dark.webp',
+  }}
+/>
 
 The **Appearance** tab lets you customize the look and feel of the launcher interface.
 
@@ -87,7 +112,13 @@ Found a string that needs polish or want to help add a new locale? Follow the [t
 
 ## Behavior Tab
 
-![Settings - Behavior Tab](/img/screenshots/screen_settings_behavior_dark.webp)
+<ThemedImage
+  alt="Settings - Behavior Tab"
+  sources={{
+    light: '/img/screenshots/screen_settings_behavior_light.webp',
+    dark: '/img/screenshots/screen_settings_behavior_dark.webp',
+  }}
+/>
 
 The **Behavior** tab defines how the launcher behaves when launching projects or starting with your system.
 
@@ -116,7 +147,13 @@ The **Behavior** tab defines how the launcher behaves when launching projects or
 
 ## Tools Tab
 
-![Settings - Tools Tab](/img/screenshots/screen_settings_tools_dark.webp)
+<ThemedImage
+  alt="Settings - Tools Tab"
+  sources={{
+    light: '/img/screenshots/screen_settings_tools_light.webp',
+    dark: '/img/screenshots/screen_settings_tools_dark.webp',
+  }}
+/>
 
 The **Tools** tab manages integration with development tools like Git and Visual Studio Code.
 
@@ -141,16 +178,24 @@ The launcher uses this information to configure external editor support, also fo
 
 ## Updates Tab
 
-![Settings - Updates Tab](/img/screenshots/screen_settings_updates_dark.webp)
+<ThemedImage
+  alt="Settings - Updates Tab"
+  sources={{
+    light: '/img/screenshots/screen_settings_updates_light.webp',
+    dark: '/img/screenshots/screen_settings_updates_dark.webp',
+  }}
+/>
 
-The **Updates** tab controls how the launcher checks for updates.
+The **Updates** tab controls how the launcher discovers and prepares launcher updates.
 
-- **Automatically check for updates**: Enabled by default.
-- **Prerelease updates**: Toggle this if you want the launcher to download beta builds instead of only stable releases. Beta updates may change more often and can be less stable. You can switch back to stable at any time.
-- **Manual Check**: Click **Check for updates** to check immediately.
+- **Automatically check for updates**: Enabled by default. This checks for a newer launcher version in the background, but it does not download the update automatically.
+- **Prerelease updates**: Toggle this if you want the launcher to look for beta builds instead of only stable releases. You can switch back to stable at any time.
+- **Manual Check**: Click **Check for updates** to check immediately. This also lets you surface a skipped version again from Settings.
+- **Update available**: When a new version is found, you can choose **Download update** or **Skip this version**.
+- **Update ready**: After the download finishes, the launcher shows **Restart now** so you can install the update when it suits you.
 
 :::tip
-Keeping this enabled ensures you always have the latest features and fixes.
+Need the full update flow, including skipped versions, manual override, retry states, and sidebar banners? See [Manage Launcher Updates](/guides/manage-launcher-updates).
 :::
 
 ---

docs/guides/editor-settings.md → docs/guides/editor-settings.mdx

@@ -11,6 +11,8 @@ tags:
   - configuration
 ---
 
+import ThemedImage from '@theme/ThemedImage';
+
 # Editor Settings Per Project
 
 The Godot Launcher supports **per-project editor settings**, allowing each project to maintain its own editor configuration. This helps prevent cross-project conflicts and ensures a consistent development environment across different Godot versions. 
@@ -47,7 +49,13 @@ The `<major.minor>` portion reflects the Godot version used by the project—for
 The launcher provides built-in options to **import** or **export** editor settings for each project. This is useful for migrating settings, keeping consistency across machines, or sharing configurations in a team.
 
 :::tip
-![Launcher Project Menu UI](/img/Per_Project_Editor_Settings_Dark.png)
+<ThemedImage
+  alt="Launcher Project Menu UI"
+  sources={{
+    light: '/img/Per_Project_Editor_Settings_Light.webp',
+    dark: '/img/Per_Project_Editor_Settings_Dark.png',
+  }}
+/>
 
 Use the project dropdown menu in the launcher to access the import and export options.
 :::