Changes/DankFedoraMiracleWM

Dank Fedora MiracleWM

Summary

Replace the nwg-shell with Dank Material Shell (built on QuickShell) for the Fedora MiracleWM spin.

Owner

• Name: Matthew Kosarek, Neal Gompa
• Email: matthew@matthewkosarek.xyz, ngompa13@gmail.com

Current status

• Targeted release: Fedora Linux 44
• Last updated: 2026-02-03
• Announced
• Discussion thread
• FESCo issue: #3552
• Tracker bug: #2436477
• Release notes tracker: #295

Detailed Description

This Change involves packaging the Dank Material Shell overlay to QuickShell and updating miracle-wm-config so the default shell for new installs uses it.

Benefit to Fedora

The nwg-shell experience has been difficult to maintain and stabilize for MiracleWM, with updates subtly breaking the experience on a regular basis. Switching to a QuickShell-based experience will give us a higher quality UX that has better stability as it is updated and maintained as part of the spin.

Scope

• Proposal owners:
  • Package DankMaterialShell
  • Update miracle-wm-config to ship configuration to activate DMS as the shell

• Other developers: N/A

• Release engineering: #13167

• Policies and guidelines: N/A (not needed for this Change)

• Trademark approval: N/A (not needed for this Change)

• Alignment with the Fedora Strategy: No

Upgrade/compatibility impact

Existing systems will retain the nwg-shell configuration unless they purge their configuration and relogin, which will trigger MiracleWM's behavior to instantiate the user settings. They will get DMS in that scenario.

How To Test

Once everything is packaged, grabbing a new Fedora MiracleWM Rawhide ISO, installing it, and trying to interact with the system is sufficient for testing.

User Experience

This will be a drastic user experience change, as swapping from nwg-shell to DMS will be a huge upgrade. Aside from switching from GTK3 to Qt6+Qt Quick, the shell will more correctly integrate with MiracleWM's IPC and more features will work properly (e.g. workspaces, resolution selection, etc.).

Dependencies

• DankMaterialShell (not yet packaged)
• quickshell
• miracle-wm-config

Contingency Plan

• Contingency mechanism: Revert back to nwg-shell configuration and defer to the next release.
• Contingency deadline: Final Freeze
• Blocks release? No

Documentation

• QuickShell documentation: https://quickshell.org/about/
• Dank Material Shell documentation: https://danklinux.com/docs/

Release Notes

The Fedora MiracleWM spin has switched its default experience from nwg-shell to DankMaterialShell (built on QuickShell). Users should experience a more fully featured, reliable, snappier, and polished experience.