Optimize UI animations and responsiveness

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "adventure-mods"
-version = "0.3.11"
+version = "0.3.12"
 edition = "2024"
 license = "MIT"
 

Makefile

@@ -1,4 +1,13 @@
-.PHONY: appimage
+.PHONY: appimage flatpak
+
+# Local Flatpak install (Devel by default). Override for a production build:
+#   make flatpak FLATPAK_MANIFEST=build-aux/io.github.astrovm.AdventureMods.json
+FLATPAK_BUILD_DIR ?= build
+FLATPAK_MANIFEST ?= build-aux/io.github.astrovm.AdventureMods.Devel.json
 
 appimage:
 	./build-aux/appimage/build-container.sh
+
+flatpak:
+	flatpak-builder --force-clean --user --install-deps-from=flathub --install \
+		$(FLATPAK_BUILD_DIR) $(FLATPAK_MANIFEST)

README.md

@@ -66,56 +66,46 @@ Running without a subcommand launches the GUI. Pass a subcommand for CLI mode.
 
 </details>
 
-## Command line (optional)
+## CLI (optional)
 
 <p align="center">
   <img src="data/screenshots/cli.png" alt="CLI" width="600">
 </p>
 
-The graphical app is recommended for most users. Use the command line for automation or non-interactive setup.
-
-Run a command through the installed Flatpak:
+The graphical app is recommended for most users. From a terminal, the usual entry point is the interactive setup wizard:
 
 ```sh
-flatpak run io.github.astrovm.AdventureMods [command] [options]
+flatpak run io.github.astrovm.AdventureMods setup
 ```
 
-Start the interactive setup from a terminal:
+It walks through game selection, mods, and install steps. Omit game or mod flags to stay interactive; pass them only when you want a fully non-interactive run.
 
-```sh
-flatpak run io.github.astrovm.AdventureMods setup
-```
+<details>
+<summary>Other commands</summary>
 
 | Command                      | Description                                                  |
 | ---------------------------- | ------------------------------------------------------------ |
 | `detect`                     | Show detected game installs and inaccessible Steam libraries |
 | `list-mods --game sadx\|sa2` | List available presets and mods for a game                   |
-| `setup`                      | Install runtimes, mod manager, mods, and config files        |
-
-Examples:
 
 ```sh
 flatpak run io.github.astrovm.AdventureMods detect
 flatpak run io.github.astrovm.AdventureMods list-mods --game sadx
-flatpak run io.github.astrovm.AdventureMods setup --game sadx --preset "DX Enhanced"
-flatpak run io.github.astrovm.AdventureMods setup --game sa2 --all-mods
-```
-
-Use `--help` to see every command and option:
-
-```sh
 flatpak run io.github.astrovm.AdventureMods --help
-flatpak run io.github.astrovm.AdventureMods setup --help
 ```
 
+</details>
+
 <details>
 <summary>Non-interactive setup options</summary>
 
+Use these with `setup` for scripting. When game, path, or mod selection is omitted, `setup` stays interactive.
+
 | Flag                         | Description                                  |
 | ---------------------------- | -------------------------------------------- |
 | `--game sadx\|sa2`           | Select the game                              |
 | `--game-path /path`          | Override Steam detection                     |
-| `--preset "Name"`           | Named preset (SADX only)                     |
+| `--preset "Name"`            | Named preset (SADX only)                     |
 | `--all-mods`                 | Install all recommended mods                 |
 | `--mods slug1,slug2`         | Install specific mods by slug                |
 | `--subtitle-language`        | Select subtitles                             |
@@ -129,19 +119,23 @@ Subtitle languages:
 - SADX: `japanese`, `english`, `french`, `spanish`, `german`
 - SA2: `english`, `german`, `spanish`, `french`, `italian`, `japanese`
 
-When game, path, or mod selection is omitted, `setup` opens the interactive wizard.
+```sh
+flatpak run io.github.astrovm.AdventureMods setup --game sadx --preset "DX Enhanced"
+flatpak run io.github.astrovm.AdventureMods setup --help
+```
 
 </details>
 
 ## Development
 
-**Flatpak**
+**Flatpak** (Devel manifest, installs for the current user)
 
 ```sh
-flatpak-builder --force-clean --user --install-deps-from=flathub --install \
-  build build-aux/io.github.astrovm.AdventureMods.Devel.json
+make flatpak
 ```
 
+Production manifest: `make flatpak FLATPAK_MANIFEST=build-aux/io.github.astrovm.AdventureMods.json`
+
 **AppImage** (Podman + `debian:13`)
 
 ```sh

data/io.github.astrovm.AdventureMods.metainfo.xml.in

@@ -44,6 +44,16 @@
     <color type="primary" scheme_preference="dark">#1a5fb4</color>
   </branding>
   <releases>
+    <release version="0.3.12" date="2026-07-24">
+      <description>
+        <p>Improved animation smoothness and interface responsiveness.</p>
+        <ul>
+          <li>Coalesced progress display updates to keep animations responsive</li>
+          <li>Cached and reused mod preview images while avoiding redundant refreshes</li>
+          <li>Added quick fade-in step transitions with reduced-motion support</li>
+        </ul>
+      </description>
+    </release>
     <release version="0.3.11" date="2026-07-23">
       <description>
         <p>Updated runtime requirements for the latest SA Mod Manager.</p>

data/resources/style.css

@@ -33,13 +33,19 @@
 }
 
 .game-card-clickable {
-    transition: box-shadow 160ms ease, transform 160ms ease;
+    transition: box-shadow 160ms ease-out;
 }
 
 .game-card-clickable:hover {
     box-shadow: 0 12px 26px rgba(0, 0, 0, 0.22);
 }
 
+@media (prefers-reduced-motion: reduce) {
+    .game-card-clickable {
+        transition: none;
+    }
+}
+
 .game-card-title {
     font-weight: bold;
     font-size: 0.95em;

data/resources/ui/setup_page.ui

@@ -43,13 +43,22 @@
                   </object>
                 </child>
                 <child>
-                  <object class="GtkBox" id="content_box">
-                    <property name="orientation">vertical</property>
-                    <property name="spacing">12</property>
-                    <property name="halign">fill</property>
+                  <object class="GtkRevealer" id="content_revealer">
+                    <property name="reveal-child">false</property>
+                    <property name="transition-type">crossfade</property>
+                    <property name="transition-duration">100</property>
                     <property name="hexpand">true</property>
-                    <property name="valign">fill</property>
                     <property name="vexpand">true</property>
+                    <property name="child">
+                      <object class="GtkBox" id="content_box">
+                        <property name="orientation">vertical</property>
+                        <property name="spacing">12</property>
+                        <property name="halign">fill</property>
+                        <property name="hexpand">true</property>
+                        <property name="valign">fill</property>
+                        <property name="vexpand">true</property>
+                      </object>
+                    </property>
                   </object>
                 </child>
               </object>