kunolabs · ywkuno · May 21, 2026 · May 21, 2026 · May 21, 2026 · May 21, 2026
diff --git a/.github/ISSUE_TEMPLATE/bug-report.yml b/.github/ISSUE_TEMPLATE/bug-report.yml
@@ -17,6 +17,25 @@ body:
     validations:
       required: true
 
+  - type: dropdown
+    id: issue-area
+    attributes:
+      label: Issue Area
+      description: Select the closest area. Pick the most visible symptom if more than one applies.
+      options:
+        - Pairing / client connection
+        - Display / virtual display / HDR
+        - Frame pacing / stutter / bitrate
+        - Audio / channel layout / delay
+        - Controller / gamepad / input
+        - Cursor / mouse visibility
+        - Playnite / app launch / app exit
+        - Installer / upgrade / uninstall
+        - Web UI / API
+        - Other
+    validations:
+      required: true
+
   - type: dropdown
     id: host-os
     attributes:
@@ -37,18 +56,50 @@ body:
     id: host-gpu
     attributes:
       label: Host GPU and Driver
-      description: Example: RTX 4080, NVIDIA 576.xx.
+      description: "Example: RTX 4080, NVIDIA 576.xx."
     validations:
       required: true
 
   - type: input
     id: client
     attributes:
       label: Client Device and App
-      description: Example: NVIDIA Shield TV Pro, Artemis v20.2.6, 4K 120 Hz HEVC HDR.
+      description: "Example: NVIDIA Shield TV Pro, Artemis v20.2.6, 4K 120 Hz HEVC HDR."
     validations:
       required: true
 
+  - type: input
+    id: stream-settings
+    attributes:
+      label: Stream Settings
+      description: "Example: 3840x2160, 60 FPS, HEVC, HDR off, 80 Mbps."
+    validations:
+      required: false
+
+  - type: input
+    id: display-setup
+    attributes:
+      label: Host Display Setup
+      description: "Example: physical LG OLED, SudoVDA virtual display, dummy plug, headless VM."
+    validations:
+      required: false
+
+  - type: input
+    id: network-path
+    attributes:
+      label: Network Path
+      description: "Example: wired LAN, Wi-Fi 6, Tailscale direct, Tailscale relay, WireGuard, WAN."
+    validations:
+      required: false
+
+  - type: textarea
+    id: input-audio
+    attributes:
+      label: Input And Audio Notes
+      description: Mention gamepads, mouse/cursor behavior, audio sink, stereo/5.1/7.1, Bluetooth, eARC, or soundbar details if relevant.
+    validations:
+      required: false
+
   - type: textarea
     id: reproduction
     attributes:

diff --git a/.github/workflows/environment-specific-closure.yml b/.github/workflows/environment-specific-closure.yml
@@ -10,7 +10,10 @@ on:
 jobs:
   close:
     name: Close Environment-Specific Issue
+    # Disabled during Nimbus bootstrap. Re-enable only after the public support
+    # policy clearly defines when maintainers close environment-specific issues.
     if: >-
+      false &&
       github.event.action == 'labeled' &&
       github.event.label.name == 'environment-specific' &&
       github.event.issue.state == 'open' &&

diff --git a/.github/workflows/logs-needed-closure.yml b/.github/workflows/logs-needed-closure.yml
@@ -13,6 +13,9 @@ concurrency:
 
 jobs:
   close:
+    # Disabled during Nimbus bootstrap. Re-enable only after the issue-support
+    # policy, labels, and maintainer response expectations are Nimbus-owned.
+    if: false
     runs-on: ubuntu-latest
     permissions:
       issues: write

diff --git a/.gitignore b/.gitignore
@@ -37,6 +37,9 @@
 # VSCode IDE
 .vscode/
 
+# Local switch/export bundles may contain credentials, certificates, and keys.
+nimbus-switch-bundles/
+
 # build directories
 build/
 cmake-*/

diff --git a/README.md b/README.md
@@ -73,6 +73,15 @@ Early Nimbus work is focused on:
 - Preparing the future Lucent client track.
 
 See [ROADMAP.md](ROADMAP.md) for the current maintainer roadmap.
+See [docs/community-research.md](docs/community-research.md) for the community
+setup research behind Setup Doctor, Client Profiles, and future fixture work.
+See [docs/streaming-recipes.md](docs/streaming-recipes.md) and
+[docs/fixture-matrix.md](docs/fixture-matrix.md) for the first repeatable
+testing surfaces.
+See [docs/apollo-to-nimbus-switch.md](docs/apollo-to-nimbus-switch.md) before
+testing Nimbus on a host that already runs Apollo.
+See [docs/ui-identity-plan.md](docs/ui-identity-plan.md) for the staged Nimbus
+Web UI identity direction.
 
 ## Building
 

diff --git a/ROADMAP.md b/ROADMAP.md
@@ -42,6 +42,8 @@ Goal: build maintainer credibility through user-visible stability work.
 
 - Prioritize Windows 11, NVIDIA Shield TV Pro, Android TV, and Moonlight/Artemis
   compatibility reports.
+- Turn community setup pain into guided diagnostics, starting with Setup Doctor,
+  Client Profiles, Cursor Doctor, and a fixture matrix.
 - Improve logs and diagnostics before changing capture behavior.
 - Create reproducible issue templates for frame pacing, WGC, virtual display,
   HDR, audio, controller, and Playnite issues.
@@ -72,7 +74,8 @@ The next engineering pass should validate the package-branding slice from
 `docs/packaging-identity-plan.md` before any branded Nimbus release:
 
 1. Use `docs/release-build-audit.md` as the release automation baseline.
-2. Use `docs/upstream-issue-radar.md` to choose the first reliability issue.
+2. Use `docs/community-research.md` and `docs/upstream-issue-radar.md` to choose
+   the first reliability issue.
 3. Confirm runtime identifiers remained unchanged unless the packaging identity
    plan says the migration has a test path.
 4. Produce a local Nimbus-named installer and inspect install, upgrade, and

diff --git a/cmake/compile_definitions/linux.cmake b/cmake/compile_definitions/linux.cmake
@@ -200,7 +200,7 @@ if(${SUNSHINE_ENABLE_TRAY})
     if(${SUNSHINE_BUILD_FLATPAK})
         set(SUNSHINE_TRAY_PREFIX "${PROJECT_FQDN}")
     else()
-        set(SUNSHINE_TRAY_PREFIX "apollo")
+        set(SUNSHINE_TRAY_PREFIX "nimbus")
     endif()
     list(APPEND SUNSHINE_DEFINITIONS SUNSHINE_TRAY_PREFIX="${SUNSHINE_TRAY_PREFIX}")
 else()

diff --git a/cmake/compile_definitions/windows.cmake b/cmake/compile_definitions/windows.cmake
@@ -34,9 +34,9 @@ file(GLOB NVPREFS_FILES CONFIGURE_DEPENDS
 include_directories(SYSTEM "${CMAKE_SOURCE_DIR}/third-party/ViGEmClient/include")
 include_directories(SYSTEM "${CMAKE_SOURCE_DIR}/third-party/sudovda")
 
-# apollo icon
+# Nimbus icon
 if(NOT DEFINED PROJECT_ICON_PATH)
-    set(PROJECT_ICON_PATH "${CMAKE_SOURCE_DIR}/apollo.ico")
+    set(PROJECT_ICON_PATH "${CMAKE_SOURCE_DIR}/nimbus.ico")
 endif()
 
 list(APPEND SUNSHINE_DEFINITIONS PROJECT_APP_USER_MODEL_ID="${WINDOWS_APP_USER_MODEL_ID}")

diff --git a/cmake/packaging/common.cmake b/cmake/packaging/common.cmake
@@ -13,7 +13,7 @@ set(CPACK_PACKAGE_CONTACT "https://github.com/kunolabs/Nimbus/issues")
 set(CPACK_PACKAGE_DESCRIPTION ${CMAKE_PROJECT_DESCRIPTION})
 set(CPACK_PACKAGE_HOMEPAGE_URL ${CMAKE_PROJECT_HOMEPAGE_URL})
 set(CPACK_RESOURCE_FILE_LICENSE ${PROJECT_SOURCE_DIR}/LICENSE)
-set(CPACK_PACKAGE_ICON ${PROJECT_SOURCE_DIR}/sunshine.png)
+set(CPACK_PACKAGE_ICON ${PROJECT_SOURCE_DIR}/nimbus.png)
 # Ensure the generated installer filename uses the branded name
 set(CPACK_PACKAGE_FILE_NAME "${CPACK_PACKAGE_NAME}")
 set(CPACK_STRIP_FILES YES)

diff --git a/cmake/packaging/linux.cmake b/cmake/packaging/linux.cmake
@@ -98,38 +98,38 @@ set(CPACK_DEBIAN_PACKAGE_SHLIBDEPS OFF)
 
 # application icon
 if(NOT ${SUNSHINE_BUILD_FLATPAK})
-    install(FILES "${CMAKE_SOURCE_DIR}/apollo.svg"
+    install(FILES "${CMAKE_SOURCE_DIR}/nimbus.svg"
             DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/apps")
 else()
-    install(FILES "${CMAKE_SOURCE_DIR}/apollo.svg"
+    install(FILES "${CMAKE_SOURCE_DIR}/nimbus.svg"
             DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/apps"
             RENAME "${PROJECT_FQDN}.svg")
 endif()
 
 # tray icon
 if(${SUNSHINE_TRAY} STREQUAL 1)
     if(NOT ${SUNSHINE_BUILD_FLATPAK})
-        install(FILES "${CMAKE_SOURCE_DIR}/apollo.svg"
+        install(FILES "${CMAKE_SOURCE_DIR}/nimbus.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status"
-                RENAME "apollo-tray.svg")
-        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/apollo-playing.svg"
+                RENAME "nimbus-tray.svg")
+        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/nimbus-playing.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status")
-        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/apollo-pausing.svg"
+        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/nimbus-pausing.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status")
-        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/apollo-locked.svg"
+        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/nimbus-locked.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status")
     else()
         # flatpak icons must be prefixed with the app id or they will not be included in the flatpak
-        install(FILES "${CMAKE_SOURCE_DIR}/apollo.svg"
+        install(FILES "${CMAKE_SOURCE_DIR}/nimbus.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status"
                 RENAME "${PROJECT_FQDN}-tray.svg")
-        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/apollo-playing.svg"
+        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/nimbus-playing.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status"
                 RENAME "${PROJECT_FQDN}-playing.svg")
-        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/apollo-pausing.svg"
+        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/nimbus-pausing.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status"
                 RENAME "${PROJECT_FQDN}-pausing.svg")
-        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/apollo-locked.svg"
+        install(FILES "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web/public/images/nimbus-locked.svg"
                 DESTINATION "${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/status"
                 RENAME "${PROJECT_FQDN}-locked.svg")
     endif()

diff --git a/cmake/packaging/windows.cmake b/cmake/packaging/windows.cmake
@@ -116,11 +116,10 @@ if(NOT EXISTS "${CMAKE_BINARY_DIR}/assets/shaders")
     execute_process(COMMAND cmd.exe /c mklink /J "${shaders_in_build_dest_native}" "${shaders_in_build_src_native}")
 endif()
 
-set(CPACK_PACKAGE_ICON "${CMAKE_SOURCE_DIR}\\\\apollo.ico")
+set(CPACK_PACKAGE_ICON "${CMAKE_SOURCE_DIR}\\\\nimbus.ico")
 
 # The name of the directory that will be created in C:/Program Files/
-# Match the legacy NSIS layout by installing under Apollo
-set(CPACK_PACKAGE_INSTALL_DIRECTORY "Apollo")
+set(CPACK_PACKAGE_INSTALL_DIRECTORY "Nimbus")
 
 # Setting components groups and dependencies
 set(CPACK_COMPONENT_GROUP_CORE_EXPANDED true)

diff --git a/cmake/packaging/windows_wix.cmake b/cmake/packaging/windows_wix.cmake
@@ -5,7 +5,7 @@
 set(CPACK_GENERATOR "WIX")
 
 # Product identity and visuals
-set(CPACK_WIX_PRODUCT_ICON "${CMAKE_SOURCE_DIR}/src_assets/common/assets/web/public/images/apollo.ico")
+set(CPACK_WIX_PRODUCT_ICON "${CMAKE_SOURCE_DIR}/src_assets/common/assets/web/public/images/nimbus.ico")
 set(CPACK_WIX_PROGRAM_MENU_FOLDER "Nimbus")
 
 # Stable Upgrade GUID to enable in-place upgrades

diff --git a/cmake/targets/common.cmake b/cmake/targets/common.cmake
@@ -57,8 +57,18 @@ endif()
 # Default layout: ${CMAKE_SOURCE_DIR}/src_assets/common/assets/web
 set(WEB_UI_DIR "${SUNSHINE_SOURCE_ASSETS_DIR}/common/assets/web")
 
-#WebUI build
-find_program(NPM npm REQUIRED)
+# WebUI build. On Windows prefer the Node.js launcher from the standard
+# installer; MSYS npm can fail when invoked through cmd.exe during packaging.
+if(WIN32)
+    find_program(NPM npm.cmd
+            HINTS "$ENV{ProgramFiles}/nodejs"
+            NO_DEFAULT_PATH)
+    if(NOT NPM)
+        find_program(NPM NAMES npm.cmd npm REQUIRED)
+    endif()
+else()
+    find_program(NPM npm REQUIRED)
+endif()
 
 set(NPM_INSTALL_FLAGS
     --ignore-scripts
@@ -69,6 +79,7 @@ set(NPM_INSTALL_FLAGS
 if (NPM_OFFLINE)
     list(APPEND NPM_INSTALL_FLAGS --offline)
 endif()
+set(NPM_CACHE_DIR "${CMAKE_BINARY_DIR}/npm-cache")
 
 # Choose web UI build mode based on active CMake configuration.
 # In Debug config, build Vite in "debug" mode to enable Vue devtools.
@@ -83,8 +94,11 @@ set(NPM_BUILD_NODE_OPTIONS "")
 add_custom_target(web-ui ALL
     WORKING_DIRECTORY "${WEB_UI_DIR}"
     COMMENT "Installing NPM dependencies and building the Web UI"
-    COMMAND "$<$<BOOL:${WIN32}>:cmd;/C>" "${NPM}" ci ${NPM_INSTALL_FLAGS}
     COMMAND "${CMAKE_COMMAND}" -E env
+            "NPM_CONFIG_CACHE=${NPM_CACHE_DIR}"
+            "$<$<BOOL:${WIN32}>:cmd;/C>" "${NPM}" ci ${NPM_INSTALL_FLAGS}
+    COMMAND "${CMAKE_COMMAND}" -E env
+            "NPM_CONFIG_CACHE=${NPM_CACHE_DIR}"
             "SUNSHINE_BUILD_HOMEBREW=${NPM_BUILD_HOMEBREW}"
             "SUNSHINE_SOURCE_ASSETS_DIR=${NPM_SOURCE_ASSETS_DIR}"
             "SUNSHINE_ASSETS_DIR=${NPM_ASSETS_DIR}"

diff --git a/cmake/targets/windows.cmake b/cmake/targets/windows.cmake
@@ -62,7 +62,7 @@ add_custom_command(
             "${CMAKE_SOURCE_DIR}/packaging/windows/bootstrapper/VibeshineInstaller.cs"
             "${CMAKE_SOURCE_DIR}/packaging/windows/bootstrapper/app.manifest"
             "${CMAKE_SOURCE_DIR}/LICENSE"
-            "${CMAKE_SOURCE_DIR}/apollo.ico"
+            "${CMAKE_SOURCE_DIR}/nimbus.ico"
             generate_windows_versioninfo
     COMMENT "Building lightweight Nimbus uninstaller UI"
 )