files-community/Files
55.2
Adequate · 10 November 2026
122.9k
lines of production code
C#
primary language
7
measurements over time
What this system is
Features
Add ability to open folders in the other pane
Users can now open a selected folder in the secondary pane of the dual-pane view. This capability is exposed through three new context-menu actions: one for standard file-list selections, one triggered by right-clicking items on the Home page, and one for right-clicking location items in the sidebar. Each action checks that the multi-pane view is active and that the target is a valid folder before navigating the other pane to that location.
src/Files.App/Actions/Navigation/OpenInOtherPane · high confidence
Add copy, cut, and delete actions for items in the Shelf
Users can now perform file system operations directly on items stored in the Shelf. New action handlers have been added to support copying, cutting, and deleting selected items from the Shelf pane, integrating these operations with the existing context and status center for feedback.
src/Files.App/Actions/Shelf · high confidence
Add custom save dialog COM component
Added a new ATL-based DLL project (Files.App.SaveDialog) that implements a custom IFileSaveDialog COM object. This component exposes the standard Windows save dialog interfaces (IFileDialog, IFileDialog2, IFileDialogCustomize) and includes event handling logic via FilesDialogEvents, allowing the application to integrate a custom save dialog experience.
src/Files.App.SaveDialog · high confidence
Added Digital Signatures utility for verifying file signatures
The new \DigitalSignaturesUtil\ class in \src/Files.App/Utils/Signatures\ provides the core logic for detecting and displaying digital signatures on files. It exposes methods to load signature details into the UI (\LoadItemSignatures\) and to open the system's native signer information dialog (\DisplaySignerInfoDialog\), enabling the 'Digital Signatures' tab in the properties window to function correctly.
src/Files.App/Utils/Signatures · high confidence
Added NativeAOT publish profiles for Windows architectures
The application now includes dedicated publish profiles for win-arm64, win-x64, and win-x86 targets. These profiles are configured to produce self-contained, NativeAOT-compiled binaries, enabling optimized, standalone executables for Windows users on these architectures.
src/Files.App/Properties · high confidence
Added Play All and Refresh Items actions
Users can now use the new 'Play All' action to open all selected media files at once, with the label dynamically switching to 'Play' when only a single media file is selected. Additionally, a new 'Refresh Items' action has been introduced, allowing users to refresh the current view via a button or keyboard shortcuts (Ctrl+R or F5).
src/Files.App/Actions/Content · high confidence
Added Sentry integration for exception reporting
The application now includes a new SentryLogger and SentryLoggerProvider in the logging utilities. This change enables the automatic capture and sending of unhandled exceptions to Sentry for error tracking, while filtering out Information-level logs and only reporting exceptions that are not explicitly marked as handled.
src/Files.App/Utils/Logger · high confidence
Added action to open current folder in the other pane
Users can now open the currently selected folder in the adjacent pane of the dual-pane view. This new action, available in the DualPane category, checks if multi-pane mode is active and the current location is not the Recycle Bin before executing. When triggered, it retrieves the working directory of the current shell page and instructs the pane holder to open that same path in the other pane.
src/Files.App/Actions/Navigation/OpenCurrentFolderInOtherPane · high confidence
Added background task to refresh Jump List and clean up logs
A new background task implementation has been added to handle periodic maintenance. This task automatically refreshes the Windows Jump List to ensure string resources are updated and prevents localization issues by clearing and rebuilding recent items. It also removes previous version debug log files (debug.log and debug\_fulltrust.log) from the local application data folder to keep storage clean.
src/Files.App.BackgroundTasks · high confidence
Added base template selector and file system dialog item selector
Introduced a generic \BaseTemplateSelector\<TItem\>\ class to simplify the implementation of data template selection logic, and added a \FileSystemDialogItemSelector\ that uses this base to choose between conflict and default data templates for file system dialog items.
src/Files.App/Data/TemplateSelectors · high confidence
Added data model enums for file system, UI, and application settings
This change introduces a comprehensive set of new enumerations in the \Files.App.Data.Enums\ namespace to support various application features. These include \AccessControlEntryFlags\, \AccessControlEntryType\, \AccessControlPrincipalType\, and \AccessMaskFlags\ for handling file system security and permissions; \ArchiveCompressionLevels\, \ArchiveDictionarySizes\, \ArchiveFormats\, \ArchiveSplittingSizes\, and \ArchiveWordSizes\ to configure 7z archive operations; and \BackdropMaterialType\ to support visual themes like Mica and Thin Acrylic. Additionally, it adds enums for UI layouts (\CardsViewSizeKind\, \ColumnsViewSizeKind\, \DetailsViewSizeKind\, \GridViewSizeKind\, \ListViewSizeKind\, \FolderLayoutModes\), status center items (\StatusCenterItemIconKind\, \StatusCenterItemKind\, \StatusCenterVisibility\), and application configuration (\AppEnvironment\, \OpenInIDEOption\, \SettingsPageKind\, \SingleClickOpenMode\, \SizeUnitTypes\).
src/Files.App/Data/Enums · high confidence
Added data model for omnibar path mode suggestions
A new internal record, OmnibarPathModeSuggestionModel, has been introduced to support the omnibar feature. This model implements the IOmnibarTextMemberPathProvider interface, enabling the system to map and retrieve specific path and display name properties for suggestions within the omnibar interface.
Files.App · high confidence
Added install actions for certificates, fonts, and INF drivers
Users can now install certificate files, font files, and INF driver packages directly from the Files app. New toolbar actions have been added for each file type: selecting certificate files enables the 'Install Certificate' action, selecting font files enables 'Install Font' (which displays progress in the status center), and selecting a single INF file enables 'Install Driver'. These actions are only available when the selected files match the expected extensions and the current page is not the Recycle Bin or a Zip folder.
src/Files.App/Actions/Content/Install · high confidence
Added pin and unpin actions for Start Menu integration
Users can now pin files, folders, and archives to the Windows Start Menu via the new 'Pin to Start' action, and remove them using 'Unpin from Start'. These actions are available in the Start category and handle both individual selections and the current folder context, including special handling for archives and shortcuts.
src/Files.App/Actions/Start · high confidence
Adds drag-to-select with modifier-key selection modes
Users can now click and drag to select multiple items in list views. The selection behavior adapts based on keyboard modifiers: dragging without modifiers clears previous selections, holding Shift extends the selection from the last item, and holding Control toggles the selection state of individual items. This new capability is implemented via the \RectangleSelection\ helper and specific \ItemSelectionStrategy\ classes within the \Files.App.UserControls.Selection\ namespace.
src/Files.App/UserControls/Selection · high confidence
Centralized theme resource registration for new UI controls
The application now includes a centralized Generic.xaml resource dictionary that registers theme resources and styles for a suite of new and refactored UI components. This change ensures that controls such as StorageRing, StorageBar, ThemedIcon (including its layers and various icon style sets), ToolbarButton, ToolbarToggleButton, BladeView, GridSplitter, SidebarView, Omnibar, SamplePanel, and BreadcrumbBar are properly themed and available for use throughout the application.
src/Files.App.Controls/Themes · high confidence
Expanded ThemedIcon library with new navigation, favorite, and utility icons
The ThemedIcon control library has been significantly expanded with new icon resources. This includes 16px and 12px navigation icons (Forward, Back, Up, Refresh), favorite management icons (Favorite, FavoriteAdd, FavoritePin, FavoritePinRemove), and utility icons for grouping, sorting, and filtering. These icons are now available for use in the application's UI through the ThemedIcon component.
src/Files.App.Controls/ThemedIcon/Styles · high confidence
Git operations now report progress in the status center
Git operations such as pull, push, fetch, and clone now display real-time progress updates in the application's status center. This change introduces a new \GitStatusCenterOperation\ helper that manages progress reporting and cancellation tokens, allowing users to monitor the completion percentage and current file being processed during long-running Git tasks.
src/Files.App/Utils/Git · high confidence
Introduce AdaptiveGridView control for responsive item layouts
Added the AdaptiveGridView control (src/Files.App.Controls/AdaptiveGridView) which automatically adjusts the number and width of grid items to fit the available screen space. The control exposes properties such as DesiredWidth, ItemHeight, and OneRowModeEnabled to configure layout behavior, and includes a OneRowModeEnabled option that forces items to stretch across a single row when only one row of content is present. It also supports binding an ItemClickCommand for handling item interactions and automatically recalculates the layout in response to container size changes or item count updates.
src/Files.App.Controls/AdaptiveGridView · high confidence
Introduce SidebarContext for managing sidebar state
A new SidebarContext class and its ISidebarContext interface have been added to centralize the management of sidebar-specific state. This context exposes properties such as RightClickedItem, IsItemRightClicked, IsPinnedFolderItem, and OpenDriveItem, allowing the UI to react to right-click interactions and determine if the selected item is a pinned folder or a drive. The implementation subscribes to the SidebarViewModel's RightClickedItemChanged event to keep these properties in sync with user actions.
src/Files.App/Data/Contexts/SideBar · high confidence
Introduce TagsContext for managing tagged file items
A new data context layer for tags has been added to the application, consisting of an ITagsContext interface and a TagsContext implementation. This context exposes a TaggedItems property that tracks the currently selected tagged files and folders, and it automatically updates this list in response to selection changes from both the sidebar and the widget, ensuring the UI reflects the current tag selection state.
src/Files.App/Data/Contexts/Tags · high confidence
Introduce configurable date and time formatting styles
The application now supports multiple date and time display formats (Application, System, Universal, and User-defined) via a new \DateTimeFormatter\ service layer. This change allows users to select their preferred date format in settings, which dynamically updates how file timestamps are displayed in the file list and details views. The implementation includes specific formatters for short labels (e.g., "2 days ago", "Yesterday") and long labels, ensuring consistent localization and grouping behavior based on the selected style.
src/Files.App/Services/DateTimeFormatter · high confidence
Introduce the Omnibar control for unified search and navigation
This change introduces the new Omnibar control, a unified search and navigation component for the application. It supports multiple modes (e.g., Search, Path) that can be switched via mode buttons, each with its own placeholder text, icon, and suggestion list. The control handles focus management, keyboard navigation (Up/Down/Enter/Escape), and text changes, exposing events for query submission, suggestion selection, and mode changes. It includes a suggestions popup with a shadow effect and supports custom item templates and item sources for each mode.
src/Files.App.Controls/Omnibar · high confidence
Introduces multi-pane context abstraction
The application now exposes a dedicated \IMultiPanesContext\ interface and its \MultiPanesContext\ implementation to manage state for the multi-pane shell view. This change centralizes tracking of the active pane, the active pane or column, and the current shell pane arrangement (horizontal or vertical). It also introduces events (\ActivePaneChanging\, \ActivePaneChanged\, \ShellPaneArrangementChanged\) that allow other parts of the application to react to changes in pane selection or layout, providing a structured way to handle multi-pane navigation and orientation updates.
src/Files.App/Data/Contexts/MultiPanes · high confidence
Introduces new storage helper utilities in src/Files.App/Utils/Storage/Helpers
This change adds a new set of helper classes to the storage utilities namespace to support core file management operations. ArchiveEntryHelpers provides logic to handle nameless entries in archives (such as gzip files) by substituting the container's filename. FileThumbnailHelper and FontFileHelper manage icon and thumbnail retrieval, including specific generation for font files. DriveHelpers, MtpHelpers, and FtpHelpers handle path resolution and classification for local drives, MTP devices, and FTP locations. Additionally, FilesystemResult, FilesystemTasks, and ErrorCodeConverter introduce a structured error-handling model for filesystem operations, while FolderHelpers, StorageFileExtensions, and StorageHelpers provide utilities for folder enumeration, path manipulation, and storage item conversion.
src/Files.App/Utils/Storage/Helpers · high confidence
Introduces unified storage abstraction layer for files and folders
The storage subsystem now uses a new set of base classes and interfaces (BaseStorageFile, BaseStorageFolder, IBaseStorageFile, IBaseStorageFolder) within the Files.App.Utils.Storage namespace. This change provides a consistent API for interacting with files and folders across different storage providers, including local files, FTP, and ZIP archives. It also introduces support for password-protected items via the IPasswordProtectedItem interface and StorageCredential class, enabling seamless handling of credentials for FTP and encrypted archives.
src/Files.App/Utils/Storage/StorageBaseItems · high confidence
Introduction of Home page and Release Notes view models
The application now includes dedicated view models for the Home page (HomeViewModel) and the Release Notes tab (ReleaseNotesViewModel). HomeViewModel manages the visibility and expansion state of various widgets (Quick Access, Drives, Network Locations, File Tags, Recent Files) and handles their reloading, while ReleaseNotesViewModel provides the URLs for the release notes blog post and support page.
src/Files.App/ViewModels · high confidence
Introduction of Info and Shelf panes with tag search and file shelving capabilities
The Files application now includes a redesigned InfoPane that allows users to switch between Details and Preview views, and supports initiating tag searches directly from the pane by tapping on file tags. Additionally, a new ShelfPane feature has been added, enabling users to drag and drop files into a dedicated shelf area for quick access, with support for batch operations like copy, cut, and delete, as well as removing items from the shelf.
src/Files.App/UserControls/Pane · high confidence
Introduction of LibraryManager for Windows Library management
The application now uses a new \LibraryManager\ class located in \src/Files.App/Utils/Library\ to handle user library operations. This component manages the lifecycle of Windows Libraries by watching for file system changes in the Libraries folder and exposing a singleton instance for accessing library data. It provides functionality to list user libraries, create new libraries with default folders, and update library properties such as save locations and pinned status, utilizing \STATask.Run\ to execute shell interactions on the appropriate thread.
src/Files.App/Utils/Library · high confidence
Introduction of Rich Commands with customizable hotkeys and metrics
The command system in the application has been upgraded to a 'RichCommand' model, allowing for more detailed command definitions including extended labels, access keys, and automation IDs. A key user-facing change is the support for custom key bindings, enabled by the new \ModifiableCommand\ wrapper which allows hotkeys to be overridden based on current key modifiers. Additionally, command execution now emits metrics to Sentry for monitoring, and the command infrastructure supports richer iconography via the \RichGlyph\ struct.
src/Files.App/Data/Commands · high confidence
Migrated Views to Files.App and introduced new UI components
The view layer has been moved from the previous project structure into the new \Files.App\ namespace, introducing fresh XAML and code-behind implementations for core screens. This includes a redesigned \HomePage\ with custom expander styles and context menus, a restructured \MainPage\ featuring a new \TabBar\ control and sidebar context flyout, and a dedicated \ReleaseNotesPage\ that uses WebView2 to display changelogs while forwarding keyboard shortcuts. Additionally, a new \ShellPanesPage\ manages multi-pane layouts with drag-and-drop support, and a \SplashScreenPage\ provides a branded loading experience with branch-specific labels.
src/Files.App/Views · high confidence
New 'Add Item' dialog for creating files and folders
The application now includes a dedicated dialog for adding new items. Users can create standard folders, files, and shortcuts, as well as custom file types registered via the system. The dialog displays localized headers and subheaders for each option and renders custom icons for custom file types when available.
src/Files.App/ViewModels/Dialogs/AddItemDialog · high confidence
New 'Open' actions for toolbar customization, IDEs, properties, and terminals
Users can now access a suite of new commands from the 'Open' category. These include opening the Toolbar Customization dialog, launching the Command Palette, and opening the classic Properties window (separate from the modern flyout). Developers can open the current folder or Git repository in their configured IDE, and edit batch/ahk/cmd files in Notepad. The Terminal action now intelligently respects the system's default terminal (launching Windows Terminal if set, otherwise falling back to cmd.exe) and supports opening terminals as Administrator or from the Home and Sidebar contexts. Additional convenience actions allow opening the application's log file or its location, viewing release notes, editing the settings JSON file, and launching Storage Sense for specific drives.
src/Files.App/Actions/Open · high confidence
New 'Run As' actions and improved PowerShell execution
Users can now run executable files and shortcuts as an administrator or as another user directly from the context menu, with the 'Run As Another User' option correctly disabled for AutoHotkey (.ahk) files. The 'Run with PowerShell' action has been updated to launch scripts in the current folder's working directory and properly handles file paths containing spaces.
src/Files.App/Actions/Content/Run · high confidence
New BreadcrumbBar control for navigation
The Files application now includes a new BreadcrumbBar control in the Files.App.Controls library, replacing previous implementations. This component provides a navigation path display that automatically collapses items into an ellipsis button when space is limited, supports keyboard navigation and accessibility via AutomationPeers, and allows users to open breadcrumbs in new tabs via a right-click context menu or chevron dropdown.
src/Files.App.Controls/BreadcrumbBar · high confidence
New Files.App.Launcher component for handling file associations and folder shortcuts
A new C++ launcher component (Files.App.Launcher) has been added to handle file associations and folder shortcuts. It implements the IShellView and IWebBrowserApp interfaces to integrate with Windows Explorer, allowing the Files application to open folder shortcuts and handle 'open in folder' actions from external applications. The component is built using C++20 and the Windows Implementation Library (wil), and its executable is copied to the Files.App assets during the build process.
src/Files.App.Launcher · high confidence
New Git actions for clone, fetch, init, pull, push, and sync
Users can now perform core Git operations directly from the Files interface. This change introduces dedicated action handlers for initializing a folder as a Git repository, cloning a repository (including via drag-and-drop), fetching, pulling, pushing, and syncing with the remote origin. These actions are integrated into the application's command system and are available when the current context supports Git operations.
src/Files.App/Actions/Git · high confidence
New GridSplitter control for resizing Grid rows and columns
A new GridSplitter control has been added to the Files.App.Controls library, allowing users to interactively resize columns or rows within a Grid layout. The control supports automatic or explicit direction detection (columns vs. rows), configurable resize behaviors (such as resizing the current and next row/column or previous and current), and customizable visual feedback including gripper foreground colors and cursor changes on hover. It also provides keyboard navigation support (arrow keys for movement, Ctrl+arrows for larger steps) and respects min/max width/height constraints on the target grid elements.
src/Files.App.Controls/GridSplitter · high confidence
New HotKey data model and parsing infrastructure
The application introduces a new set of data structures in the \src/Files.App/Data/Commands/HotKey\ directory to manage keyboard shortcuts. This includes a \HotKey\ struct for representing individual key combinations, a \HotKeyCollection\ struct for handling multiple shortcuts with parsing and localization support, and supporting enums for \Keys\ and \KeyModifiers\. These components provide the underlying data model for displaying and parsing keyboard shortcuts in the Command Palette, replacing previous ad-hoc implementations with a standardized, immutable, and localized approach.
src/Files.App/Data/Commands/HotKey · high confidence
New KeyboardShortcut control for displaying key bindings
A new \KeyboardShortcut\ user control has been added to render keyboard shortcuts in the Command Palette. This control accepts a collection of hotkeys and formats them into styled items (Outlined, Filled, or TextOnly) with configurable sizes (Small, Medium, Large), handling the display of modifiers (Alt, Ctrl, Shift, Win) and keys with proper localization and visual separation.
src/Files.App/UserControls/KeyboardShortcut · high confidence
New RichCommand actions for file system operations
The file system actions in the app have been refactored into a new RichCommand system, introducing dedicated action classes for core operations. This includes new commands for creating items (files, folders, shortcuts, and alternate data streams), managing clipboard operations (copying paths with or without quotes, pasting as shortcuts, and pasting into selected folders), and handling deletions (standard and permanent). The update also adds specific actions for opening items, opening file locations for shortcuts, flattening folders, and formatting drives from various contexts like the home page or sidebar.
src/Files.App/Actions/FileSystem · high confidence
New SamplePanel control for displaying content with optional side content
A new \SamplePanel\ control has been added to the \Files.App.Controls\ library, providing a UI component that displays a header, main content, and an optional side content panel. The control features a default style with a 360px wide side panel and automatically toggles a 'Nothing to show' message when the side content is not provided, supporting visual state management for this visibility change.
src/Files.App.Controls/SamplePanel · high confidence
New Status Center UI with speed graph visualization
The Status Center now features a redesigned interface that includes a new SpeedGraph control for visualizing transfer speeds, along with improved text wrapping and button placement for status items. Users can now see real-time speed data in a graphical format within the status cards, and the layout has been adjusted to better accommodate longer text descriptions and action buttons.
src/Files.App/UserControls/StatusCenter · high confidence
New StorageBar and RingShape controls for drive storage visualization
The Details Pane now includes a new \StorageBar\ control and a supporting \RingShape\ primitive to display drive storage usage. The \StorageBar\ visualizes the percentage of used space with a value bar and a track, dynamically switching colors to indicate Safe, Caution, or Critical states based on configurable thresholds. The \RingShape\ provides the underlying geometry for circular or elliptical ring segments, enabling the control to render storage data in a compact, visually distinct format.
src/Files.App.Controls/Storage/StorageBar · high confidence
New StorageRing control for displaying storage usage
A new \StorageRing\ control has been added to the \Files.App.Controls\ library to visualize storage usage as a percentage-based ring. The control exposes properties for configuring the value, minimum/maximum ranges, and angular span (MinAngle, MaxAngle, StartAngle), along with thresholds for caution and critical states that trigger distinct visual states (Safe, Caution, Critical, Disabled). It uses the CommunityToolkit \GeneratedDependencyProperty\ attribute for its properties and defines its appearance via a XAML style with theme dictionaries for Default, Light, and HighContrast modes, allowing customization of ring thicknesses, colors, and line caps.
src/Files.App.Controls/Storage/StorageRing · high confidence
New StringBuilder extension methods for source generator headers
The source generator now includes a new \StringBuilderExtensions\ class that provides helper methods to automatically append standard headers to generated files. Users will see generated code files consistently include an \\<auto-generated/\>\ tag (with optional source attribution) and the project's MIT license header, ensuring compliance and clarity in the output without manual intervention.
src/Files.Core.SourceGenerator/Extensions · high confidence
New ThemedIcon and ThemedIconLayer controls for state-aware, layered icons
The \src/Files.App.Controls/ThemedIcon\ location introduces the \ThemedIcon\ control and its supporting \ThemedIconLayer\ component, enabling icons that automatically adapt their appearance based on system themes, high-contrast settings, and owner control states (such as \ToggleButton\ toggle status). This location provides the core implementation, including the \ThemedIconColorType\ and \ThemedIconLayerType\ enums, visual state definitions for outline/filled/layered modes, and theme resource dictionaries that map icon colors to system brushes (e.g., \SystemFillColorCritical\, \AccentFillColorDefaultBrush\). The \ThemedIconLayer\ class handles the rendering of individual layers within a layered icon, allowing for complex, multi-color icon designs that respect the application's current theme and accessibility settings.
src/Files.App.Controls/ThemedIcon · high confidence
New Toolbar and ToolbarButton controls added
Added a new Toolbar control and associated ToolbarButton, ToolbarFlyoutButton, and ToolbarItem components to the Files.App.Controls library. The Toolbar supports configurable sizes (Small, Medium, Large) and manages item layout, including an overflow mechanism for items that do not fit. ToolbarButton provides themed icon support, label display, and visual states (Normal, PointerOver, Pressed, Disabled). ToolbarItem serves as an abstract data model for toolbar entries, supporting properties like ItemType, OverflowBehavior, Label, and SubItems to define how items are rendered and behave within the toolbar.
src/Files.App.Controls/Toolbar · high confidence
New UI styles and components for status center and menu customization
The application introduces new XAML styles and components to support recent UI enhancements. This includes a new \DefaultGridSplitterStyle\ for the dual-pane layout, custom styles for \MenuFlyoutSubItem\ with image and themed icon support, and a comprehensive set of \InfoBadge\ styles for the status center. Additionally, new styles for the Properties pane and status center controls have been added to align with the updated toolbar and font installation progress features.
src/Files.App/Styles · high confidence
New ViewModel implementations for Info Pane, Navigation Toolbar, Shelf, Sidebar, and Status Center
The \src/Files.App/ViewModels/UserControls\ directory now contains the primary view-model logic for several core UI components. The \InfoPaneViewModel\ manages the details and preview tabs, including tag loading and cloud drive status. The \NavigationToolbarViewModel\ (replacing the legacy address bar) handles the Omnibar, path suggestions, and layout mode indicators. The \ShelfViewModel\ provides a temporary clipboard for files, managing folder watchers to keep shelf items in sync with the file system. The \SidebarViewModel\ and its partial classes (\FlatTree\, \TabExpansion\) implement the new flat sidebar tree, tab-specific expansion state persistence, and section ordering. Finally, the \StatusCenterViewModel\ centralizes ongoing file operation tracking, badge updates, and Windows taskbar progress integration.
src/Files.App/ViewModels/UserControls · high confidence
New Windows-specific service implementations for shell integration and system settings
This change introduces a suite of new services in the Windows layer to handle platform-specific interactions, replacing previous implementations or filling gaps. WindowsDialogService now manages file open/save dialogs using the Windows App SDK, including proper COM error handling and state persistence. WindowsJumpListService manages taskbar jump lists with bounded recent items to prevent shell limit errors, while WindowsQuickAccessService handles pinning/unpinning folders to the sidebar via shell verbs. WindowsRecentItemsService tracks recent files and folders by monitoring the AutomaticDestinations directory. Additional services include WindowsIniService for robust INI file parsing, WindowsCompatibilityService for managing AppCompat registry flags, WindowsWallpaperService for setting desktop/lock screen wallpapers and slideshows, WindowsStartMenuService for managing secondary tiles, WindowsSecurityService for elevation and drag-and-drop checks, and WindowsShellService for caching Shell New context menu entries.
src/Files.App/Services/Windows · high confidence
New action infrastructure with rich metadata and hotkey support
The application introduces a new action framework in the Actions module, replacing the previous implementation with a structured interface (IAction) and base class (BaseUIAction). This change enables richer user-facing metadata for commands, including descriptions for command palette integration, extended labels, access keys, and automation IDs for testing. It also adds support for multiple hotkeys (primary, secondary, tertiary, and media keys) and glyph-based icons, allowing for more flexible and discoverable UI interactions.
src/Files.App/Actions · high confidence
New actions for tab and pane management
This change introduces a comprehensive set of new navigation actions for managing tabs and dual-pane layouts. Users can now explicitly split panes horizontally or vertically, close the active pane, or close all tabs. Tab management actions include reopening closed tabs, duplicating the selected tab, and closing tabs to the left or right of the selected one. Navigation actions for moving between tabs (next/previous) and standard browser-style navigation (back/forward/up/home) are also added, each with defined keyboard shortcuts.
src/Files.App/Actions/Navigation · high confidence
New actions to toggle UI panes and view settings
The Files app now exposes dedicated actions for toggling various UI elements and view preferences. Users can show or hide the sidebar, toolbar, filter header, and shelf pane. Additionally, new actions allow toggling the info pane (with specific tabs for details and preview), dual-pane mode, hidden items, dot files, and file extensions. These actions are registered in the \Show\ category and include keyboard shortcuts for quick access.
src/Files.App/Actions/Show · high confidence
New and updated dialogs for Git, archive, and shortcut operations
This change introduces a suite of new and redesigned dialog components in the Files.App interface to support recent feature additions. Users will see a new Add Branch dialog for creating Git branches with options to base them on existing ones and switch immediately. The Create Archive dialog now includes advanced options for compression levels, splitting sizes, dictionary/word sizes, and CPU threads, along with encryption settings. A new Create Shortcut dialog allows users to specify a custom name and destination path for shortcuts. Additionally, the Extract Archive dialog now supports selecting character encoding for files with undetermined encoding and remembers previous extraction locations. A new Compress Skipped Items dialog informs users when files are skipped during compression and offers a Skip option, while the Add Item dialog provides a unified interface for adding new items to the file system.
src/Files.App/Dialogs · high confidence
New application lifecycle and telemetry helpers
The application now includes new helper classes in the Application namespace to manage startup, language, and telemetry. AppLifecycleHelper initializes core services and manages update checks. ActiveSessionTracker measures and reports foreground usage time to Sentry. AppLanguageHelper manages supported languages and RTL support. AppMemoryHelper optimizes memory usage by trimming the working set during idle periods. AppToastNotificationHelper handles system notifications for exceptions and background tasks.
src/Files.App/Helpers/Application · high confidence
New attributes for command generation and registry serialization
Added the GeneratedRichCommandAttribute to mark classes for command generation, allowing associated actions to be specified. Introduced RegistrySerializableAttribute and RegistryIgnoreAttribute to control which classes and properties are included in registry preferences and tags storage.
src/Files.Shared/Attributes · high confidence
New background actions for app theme, lock screen, and desktop slideshow
Users can now set images as the app's theme background, lock screen wallpaper, or desktop slideshow directly from the Files app. This change introduces specific action handlers (SetAsAppBackgroundAction, SetAsLockscreenBackgroundAction, SetAsSlideshowBackgroundAction, SetAsWallpaperBackgroundAction) that leverage the IWindowsWallpaperService to apply these settings, with availability controlled by file compatibility and selection context.
src/Files.App/Actions/Content/Background · high confidence
New command-line argument parser for Windows
The application now includes a dedicated command-line parsing utility (CommandLineParser) that processes raw command-line strings into structured commands. This parser supports specific flags such as Directory, OutputPath, Select, and Tag, and automatically detects paths, shell commands, or unknown arguments. This change introduces the underlying mechanism for handling command-line inputs, which previously may have been handled differently or not at all in this specific modular way.
src/Files.App/Utils/CommandLine · high confidence
New data models for sidebar navigation, file details, and security
The application introduces a comprehensive set of new data models in the \src/Files.App/Data/Items\ directory to support enhanced UI and functionality. \DriveItem\ and \LocationItem\ now feature lazy-loading sidebar expansion with live subfolder watching, while \ListedItem\ and \IListedItem\ provide the core data structure for file listings, including support for Git status, tags, and detailed metadata. Security capabilities are added via \AccessControlEntry\, \AccessControlList\, and \AccessControlPrincipal\ models for displaying and managing file permissions. Additional models like \DetailsLayoutColumnItem\ enable resizable columns in the details view, \EncodingItem\ supports ZIP archive encoding selection, and \BranchItem\ facilitates Git branch display.
src/Files.App/Data/Items · high confidence
New display actions for layout, sorting, and grouping
The Files app now includes dedicated action classes for managing file display settings, allowing users to change layouts (Details, List, Cards, Grid, Columns, Adaptive), sort items (by name, date, size, type, sync status, tag, path, original folder, date deleted, folder path), and group items (by name, date modified, date created, size, type, sync status, tag, original folder, date deleted, folder path). These actions are implemented as rich commands with localized labels, descriptions, and icons, and they integrate with the application's context to update the view accordingly.
src/Files.App/Actions/Display · high confidence
New environment helper utilities for app detection and policy checks
Added new helper classes in the Environment namespace to support environment-specific checks: PackageHelper provides a method to check if a Windows app package is installed, PolicyHelpers checks a specific Windows Explorer policy setting via the registry, and SoftwareHelpers detects if Visual Studio Code is installed while safely handling potential security exceptions during registry access.
src/Files.App/Helpers/Environment · high confidence
New extension utilities and middle-click scrolling support
This change introduces a suite of new extension methods and helper classes in the Files.App.Extensions namespace to support new features and improve code organization. Most notably, it adds middle-click auto-scrolling functionality for list controls via ScrollViewerMiddleClickExtensions, allowing users to scroll by holding the middle mouse button. It also introduces SingleClickOpenModeExtensions to support separate mouse and touch settings for single-click file opening, and MessageFormatExtensions to handle localized string formatting with custom number styles. Additional utility extensions include DispatcherQueueExtensions for safer UI thread operations, ImageFromBytes for binding byte arrays to images, Fractions for number formatting, and Win32FindDataExtensions for correctly handling large file sizes from Windows API structures.
src/Files.App/Extensions · high confidence
New factory classes for context menus, properties, and theming
The \src/Files.App/Data/Factories\ directory now contains several new factory classes that centralize the creation of UI data structures. \ContentPageContextFlyoutFactory\ and \ShellContextFlyoutHelper\ generate the right-click context menu items, handling shell integration, access keys, and filtering based on the current view and selection. \PropertiesNavigationItemsFactory\ builds the navigation tabs for the Properties window, dynamically showing or hiding tabs like Security, Hashes, and Customization based on the selected file type. \AppThemeResourceFactory\ provides the list of available accent colors for the theme picker, and \LocalizedEnumDescriptionFactory\ maps view size enums to their localized display names.
src/Files.App/Data/Factories · high confidence
New file logging with privacy sanitization and log rotation
The application now includes a new FileLogger implementation that writes logs to disk using an asynchronous channel-based writer. This change introduces automatic log rotation, keeping only the last 100 lines of the log file to prevent unbounded growth. Additionally, it implements privacy protection by sanitizing log messages to mask sensitive user information, including file paths, usernames, email addresses, and URL authorities, ensuring that private data is not written to the log files.
src/Files.Shared/Utils/Logger · high confidence
New file preview controls introduced
The preview pane now includes dedicated user controls for rendering various file types, including code (with syntax highlighting and a lightweight CSS renderer to prevent freezing), HTML (via WebView2), images, media (with compact transport controls and keyboard shortcuts), PDFs (with page navigation), markdown (with clickable links), rich text, and basic file icons. A new ShellPreview control also enables rendering of native shell previews.
src/Files.App/UserControls/FilePreviews · high confidence
New global keyboard shortcuts and window management actions
This change introduces a set of new global actions in the application's action system, enabling users to control the app's appearance and window state via keyboard shortcuts. Users can now switch between Light, Dark, and Default themes, toggle Full Screen (F11), and toggle Compact Overlay mode (F12) using dedicated hotkeys. Additionally, new actions for Undo (Ctrl+Z), Redo (Ctrl+Y), Search (Ctrl+F / F3), and editing the file path (Ctrl+L / Alt+D) have been added, providing faster access to common file system and navigation tasks.
src/Files.App/Actions/Global · high confidence
New helper utilities for image, path, and file operations
The Files.App/Helpers directory now includes a suite of new utility classes to support core file management features. BitmapHelper provides methods to convert byte arrays to BitmapImages, rotate images in-place, and save software bitmaps, enabling image editing capabilities. MediaFileHelper allows changing or clearing album covers in media files. NaturalStringComparer implements human-readable sorting for filenames (e.g., file10 after file2), improving list organization. PathNormalization handles robust path resolution and root extraction, fixing issues with special characters or invalid paths. TransferHelpers manages copy/cut operations to the clipboard with progress tracking, while ShareItemHelpers handles the Windows share UI for files and folders. Additional helpers include ColorHelpers for color conversion, CredentialsHelpers for secure password storage, and RegexHelpers for pattern matching.
src/Files.App/Helpers · high confidence
New image rotation actions added
Users can now rotate selected images left or right via new 'Rotate Left' and 'Rotate Right' commands. These actions are implemented in the ImageManipulation action folder, inheriting from a shared base that handles execution via BitmapHelper and updates the preview pane. The commands are marked with \[GeneratedRichCommand\] and include localized labels, descriptions, and themed icons.
src/Files.App/Actions/Content/ImageManipulation · high confidence
New model classes for cloud providers and shell new entries
Added new model classes in the Files.Shared.Models namespace to support cloud integration and shell context menu features. This includes the CloudProvider model and ICloudProvider interface along with the CloudProviders enum (listing providers like OneDrive, Google Drive, etc.) for managing cloud storage connections, and the ShellNewEntry model for handling 'New File' context menu entries.
src/Files.Shared/Models · high confidence
New on-demand folder size calculation service
The application now includes a new size provider infrastructure (CachedSizeProvider, DrivesSizeProvider, UserSizeProvider) that enables calculating folder sizes on demand. This implementation uses Windows P/Invoke for file enumeration and caches results, supporting intermediate updates to prevent UI freezes during large directory scans. The UserSizeProvider integrates with folder settings, allowing users to toggle this feature via the CalculateFolderSizes preference.
src/Files.App/Services/SizeProvider · high confidence
New preview pane view models for archives, code, folders, and more
The preview pane now uses a set of dedicated view models in the Previews folder to handle specific file types, replacing the previous generic approach. ArchivePreviewViewModel displays the item count and uncompressed size for ZIP files using SevenZip. CodePreviewViewModel provides syntax highlighting for source code files (C\#, C++, JS, etc.) and shows line counts. FolderPreviewViewModel shows folder details, including Git branch and repository information when applicable. MarkdownPreviewViewModel renders Markdown with raw HTML escaping to prevent crashes. PDFPreviewViewModel renders pages with a page count and limits rendering to prevent memory issues. ImagePreviewViewModel and MediaPreviewViewModel handle images and audio/video playback. TextPreviewViewModel shows line and word counts for plain text. ShellPreviewViewModel integrates Windows Shell Preview Handlers for Office and other system-supported formats. ShortcutPreviewViewModel displays target path and arguments for shortcuts. These changes improve preview accuracy, performance, and stability for users.
src/Files.App/ViewModels/UserControls/Previews · high confidence
New preview providers for PowerToys Peek, QuickLook, and Seer Pro
The application now supports three additional preview popup providers: PowerToys Peek, QuickLook, and Seer Pro. The new \PowerToysPeekProvider\ detects the PowerToys Peek executable via the Windows registry and launches it to preview files. The \QuickLookProvider\ communicates with the QuickLook application via named pipes to toggle or switch previews. The \SeerProProvider\ integrates with Seer Pro by sending window messages and respects the application's "Track selected file" setting, reading this configuration from both the Windows Registry and local INI files. The \PreviewPopupService\ has been updated to detect the availability of these providers in a specific order (QuickLook, then Seer Pro, then PowerToys Peek) and return the first available one.
src/Files.App/Services/PreviewPopupProviders · high confidence
New selection actions (Select All, Clear, Invert, Toggle) with rich command support
The selection area now includes four new actions: Select All, Clear Selection, Invert Selection, and Toggle Select. These actions are implemented as IAction classes using the \[GeneratedRichCommand\] attribute, providing labels, descriptions, icons, and hotkeys (Ctrl+A for Select All, Ctrl+Space for Toggle Select). They integrate with the command palette and respect context constraints (e.g., disabled on Home page, during renaming, or when no selection exists).
src/Files.App/Actions/Content/Selection · high confidence
New service contracts for settings, UI, and file operations
The application introduces a comprehensive set of new service interfaces in the Data/Contracts layer to support recent feature additions and architectural improvements. These include \IActionsSettingsService\ for custom hotkeys, \IAppThemeModeService\ for theme management, and \IAppearanceSettingsService\ for controlling UI elements like the toolbar and status bar. File and folder behavior is now governed by \IFoldersSettingsService\ (single-click, extensions) and \IGeneralSettingsService\ (startup, widgets). Archive creation is supported via \ICompressArchiveModel\, while file tagging is handled by \IFileTagsService\ and \IFileTagsSettingsService\. Additional contracts cover network operations (\INetworkService\), dialog services (\ICommonDialogService\, \IDialogService\), and UI components like the address bar (\IAddressToolbarViewModel\) and preview popups (\IPreviewPopupService\).
src/Files.App/Data/Contracts · high confidence
New shared extension methods for arrays, enums, dates, and collections
The \src/Files.Shared/Extensions\ directory now includes a suite of new extension methods to simplify common operations. \ArrayExtensions\ provides a \CloneArray\ method for deep copying arrays, while \ComponentModelExtensions\ adds utilities to retrieve and resolve enum values based on their \DescriptionAttribute\. \DateExtensions\ introduces a safe conversion from \FILETIME\ structures to \DateTime\. Collection handling is enhanced with \EnumerableExtensions\ (parallel async iteration, list creation), \LinqExtensions\ (null-safe empty checks, thread-safe dictionary access with defaults, sorted list insertion), and \GenericExtensions\ (safe casting and null filtering). Additionally, \SafetyExtensions\ offers robust exception handling wrappers, \TaskExtensions\ adds timeout and chaining capabilities, \StringExtensions\ provides left/right substring helpers, \SerializationExtensions\ simplifies async serialization calls, and \FileLoggerExtensions\ registers a file-based logging provider.
src/Files.Shared/Extensions · high confidence
New shared helper libraries for file extensions, checksums, and paths
The Files.Shared/Helpers location now includes new helper classes: AsyncManualResetEvent for asynchronous synchronization, ChecksumHelpers for calculating CRC32, MD5, SHA1, SHA256, SHA384, and SHA512 hashes, FileExtensionHelpers for identifying file types (images, audio, video, archives, scripts, etc.) and checking compatibility for actions like setting wallpapers or converting to ICO, and PathHelpers for combining paths, finding executable paths via where.exe, and checking if a path is in the Windows Fonts folder. These helpers provide foundational utilities for file type detection, hashing, and path manipulation used across the application.
src/Files.Shared/Helpers · high confidence
New sidebar actions for copying items and pinning/unpinning folders
The sidebar now includes dedicated actions to copy selected items to the clipboard and to pin or unpin folders to the sidebar's Quick Access section. The new CopyItemFromSidebarAction handles copying files and folders via the system clipboard, with a fallback to copying the file path if standard storage access fails, while explicitly excluding non-copyable locations like the Recycle Bin or Settings. The PinFolderToSidebarAction and UnpinFolderFromSidebarAction allow users to add or remove folders from the sidebar's pinned list, ensuring that only valid, non-archived folders are pinned and that duplicates are prevented.
src/Files.App/Actions/Sidebar · high confidence
New source generators for commands, registry settings, and localized strings
The application now uses three new source generators to automate code generation at compile time. The CommandManagerGenerator creates the CommandCodes enum, ICommandManager interface, and CommandManager class based on \[GeneratedRichCommand\] attributes, while also generating CommandGroups classes for abstract classes ending in 'CommandGroup'. The RegistrySerializationGenerator produces serialization and deserialization logic for classes marked with \[RegistrySerializableAttribute\], handling various data types including enums via Enum.TryParse. The StringsPropertyGenerator reads .resw and .json resource files from the en-US\\Resources directory to generate strongly-typed string properties, including validation to detect duplicate resource file names.
src/Files.Core.SourceGenerator/Generators · high confidence
New storage service implementations for icons, archives, devices, network, security, and trash
The application introduces a suite of new storage services in the \src/Files.App/Services/Storage\ directory to handle core file system operations. \IconCacheService\ provides a generic, extension-based icon caching mechanism that works across local, network, and cloud paths. \StorageArchiveService\ manages compression and decompression of archives (ZIP, 7Z, RAR) with progress reporting and encoding support. \StorageDevicesService\ handles drive enumeration and removable device detection, probing drives in parallel to improve startup performance. \NetworkService\ manages network locations, computers, and shortcuts, including filtering for virtual disk prefixes. \StorageSecurityService\ enables reading and modifying file ownership and ACLs via Windows APIs. \StorageTrashBinService\ implements recycle bin querying, emptying, and restoration. \StorageCacheService\ provides a simple in-memory cache for display names.
src/Files.App/Services/Storage · high confidence
New tab management helpers and navigation interaction tracking
This change introduces new helper classes in the navigation layer to improve tab control and navigation gestures. MultitaskingTabsHelpers adds actions to close tabs to the left, right, other tabs, or all tabs, and to move a tab to a new window. NavigationHelpers refactors tab creation logic, including support for opening paths in new tabs with optional auto-switching, and adds logic to display path hints for tabs with identical names. NavigationInteractionTracker implements a new gesture-based navigation system using InteractionTracker for back/forward navigation with custom animations and resistance.
src/Files.App/Helpers/Navigation · high confidence
New tag management actions: open all tagged items and remove all tags
Users can now open all files associated with a specific tag in a single action via the new OpenAllTaggedAction, which opens files in the current window and folders in new tabs. Additionally, a new RemoveTagsAction allows users to bulk-remove all tags from selected files, with the interface automatically refreshing to reflect the changes.
src/Files.App/Actions/Content/Tags · high confidence
New themed menu flyout controls and file tag context menu
This change introduces a new FileTagsContextMenu that allows users to add, remove, and clear file tags directly from the context menu, with support for dynamic item providers and tag-change notifications. It also adds a suite of custom menu flyout controls (MenuFlyoutHeaderItem, MenuFlyoutItemWithImage, MenuFlyoutItemWithThemedIcon, ToggleMenuFlyoutItemWithThemedIcon, and MenuFlyoutSubItemCustomProperties) that enable themed icons and bitmap icons in menu items, improving visual consistency and accessibility in context menus.
src/Files.App/UserControls/Menus · high confidence
New undo/redo history system for file operations
The file operation subsystem in \src/Files.App/Utils/Storage\ has been refactored to introduce a dedicated history tracking system. New interfaces and classes (\IStorageHistory\, \StorageHistory\, \IStorageHistoryOperations\, \StorageHistoryOperations\, \StorageHistoryWrapper\) now record the source, destination, and type of file operations (such as copy, move, delete, rename, and recycle). This enables the application to support undo and redo actions for these operations, allowing users to reverse recent file changes directly within the file manager.
src/Files.App/Utils/Storage/Operations · high confidence
New unified storage item abstraction layer
The application introduces a new \Files.App.Utils.Storage\ namespace that provides a unified abstraction for file system operations. This change adds specialized storage item classes—including \FtpStorageFile\ and \FtpStorageFolder\ for FTP support, \NativeStorageFile\ for handling shortcuts and alternate data streams, and \ShellStorageFile\/\ShellStorageFolder\ for Windows Shell paths (such as shortcuts and the Recycle Bin)—along with query result wrappers. This allows the application to manage diverse storage backends and special system paths through a consistent interface.
src/Files.App/Utils/Storage/StorageItems · high confidence
New utility interfaces for async initialization, persistence, and serialization
The \src/Files.Shared/Utils\ directory now includes several new interfaces to support structured application lifecycle and data handling: \IAsyncInitialize\ for asynchronous startup routines, \IPersistable\ for saving and loading state, \IAsyncSerializer\ for data transformation, \IImage\ as a UI image abstraction, and \IWrapper\ for exposing inner implementations. These interfaces provide the foundational contracts for upcoming features like the Shelf and file tags widget, as well as improved app startup performance.
src/Files.Shared/Utils · high confidence
Redesigned Properties window with new tabbed interface and expanded capabilities
The Properties window has been completely redesigned with a new sidebar navigation and dedicated tabs for General, Details, Compatibility, Customization, Hashes, and Library properties. Users can now view and edit file metadata, adjust Windows compatibility settings (such as run as administrator and DPI scaling), customize folder icons by selecting from DLL resources, and view or compare file hashes (MD5, SHA1, SHA256, etc.). The General tab includes album cover management and drive renaming, while the Library tab allows managing library locations. The interface now features a loading state with a progress ring and improved high-contrast support.
src/Files.App/Views/Properties · high confidence
Redesigned home page widgets with new layouts and capabilities
The home page widgets have been completely redesigned to use modern XAML layouts and offer enhanced functionality. The Drives and Network Locations widgets now display drive cards with storage usage progress bars and direct access to Storage Sense. The Quick Access widget has been updated to show pinned items with a dedicated pin icon. The Recent Files widget now supports dragging items and displays a warning banner when recent files are disabled in Windows. Additionally, a new File Tags widget has been introduced, allowing users to view files grouped by tag and open all items associated with a specific tag.
src/Files.App/UserControls/Widgets · high confidence
Settings UI restructured into dedicated pages with new view models
The Settings dialog has been replaced with a page-based interface, introducing dedicated view models for each section (About, Actions, Advanced, Appearance, DevTools, Folders, General, Layout, and the main SettingsPage). This change adds specific capabilities such as custom key binding management in the Actions page, IDE configuration in DevTools, and background image/font selection in Appearance, while the main SettingsPage now supports searching across all settings categories.
src/Files.App/ViewModels/Settings · high confidence
Source generator adds JSON and RESW file parsing capabilities
The source generator now supports extracting localization keys from JSON and RESW resource files. A new JsonParser component parses JSON text to extract keys, values, and optional Crowdin context comments, handling nested objects, arrays, and various data types. Additionally, a new ReswParser component parses RESW XML files to extract keys, values, and comments, replacing dots in attribute names with a configured separator. These parsers enable the generator to process these specific resource formats for string generation.
src/Files.Core.SourceGenerator/Parser · high confidence
Sticky headers in Details View
The Details View now keeps column headers visible while scrolling through the file list. This is achieved by a new StickyHeaderBehavior that uses composition animations to pin the header to the top of the view as the user scrolls.
src/Files.App/Data/Behaviors · high confidence
Architecture
Refactored TabBar into a modular, interface-driven component
The TabBar control has been restructured to improve maintainability and testability by introducing a clear separation of concerns. A new \BaseTabBar\ abstract class and a set of interfaces (\ITabBar\, \ITabBarItem\, \ITabBarItemContent\) now define the core contract for tab management, handling shared logic such as tab restoration, instance tracking, and loading states. The concrete \TabBar\ implementation now relies on these abstractions and integrates with the IoC container for command management, while \TabBarItem\ encapsulates individual tab state and navigation frames. This change standardizes how tabs are created, dragged, and closed, providing a cleaner foundation for future multitasking features.
src/Files.App/UserControls/TabBar · high confidence
Refactored file browser layouts into a shared base class hierarchy
The file browser layouts (Grid, Details, Columns, and List) have been refactored to share a common base class structure, with new \BaseLayoutPage\ and \BaseGroupableLayoutPage\ classes centralizing core logic for item selection, renaming, and event handling. This change consolidates duplicated code across layout implementations, improving maintainability and ensuring consistent behavior for features like drag-and-drop, keyboard navigation, and context menus across all view modes.
src/Files.App/Views/Layouts · high confidence
Repository restructured for .NET 10 and NativeAOT support
The project has been reorganized into a modern solution structure with separate \src\ and \tests\ directories, replacing the previous layout. The codebase has been upgraded to target .NET 10.0 and Windows SDK 26100, enabling NativeAOT and strict Roslyn compilation modes. The legacy Visual Studio solution file has been replaced by a new \Files.slnx\ format, and the licensing has changed from GPL-3.0 to a dual MIT/Mozilla Public License 2.0 model.
(repo-wide) · high confidence
Behavioural changes
2 commits (0 fixes) modifying src/Files.App/Assets/FilesOpenDialog
A change to existing behaviour in src/Files.App/Assets/FilesOpenDialog — 2 commits, 2 files: “Feature: Removed FullTrustProcess (\#10283)”; “Code Quality: Renamed Files.OpenDialog (\#12845)” (refs \#10283, \#12845).
src/Files.App/Assets/FilesOpenDialog · medium confidence · unverified
22 commits (1 fix) modifying src/Files.App.Server
A change to existing behaviour in src/Files.App.Server — 22 commits (1 fix), 81 files: “Code Quality: Shared shell helpers between the app and server (\#19051)”; “Code Quality: WinRT out-of-proc server (\#18911)”; “Bump Microsoft.Windows.CsWin32 from 0.3.363 to 0.3.369 (\#19107)”; and 19 more (refs \#19051, \#18911, \#19107, \#15178, \#18841, …).
src/Files.App.Server · medium confidence · unverified
23 commits (7 fixes) modifying src/Files.App/Utils/Global
A change to existing behaviour in src/Files.App/Utils/Global — 23 commits (7 fixs), 2 files: “Code Quality: Enumerate wsl distros from registry”; “Code Quality: Improved app startup routine 2 - Checkpoint 1 (\#13854)”; “Feature: Added support for reordering sidebar items (\#18951)”; and 20 more (refs \#13854, \#18951, \#15210, \#14862, \#16741, …).
src/Files.App/Utils/Global · medium confidence · unverified
4 commits (0 fixes) modifying Files.App.Controls
A change to existing behaviour in Files.App.Controls — 4 commits, 1 file: “Feature: Added support for reordering sidebar items (\#18951)”; “Feature: Moved Settings button to the Sidebar (\#16911)”; “Code Quality: Ran code cleanup (\#17307)”; and 1 more (refs \#18951, \#16911, \#17307, \#17972).
Files.App.Controls · medium confidence · unverified
4 commits (0 fixes) modifying src/Files.App/Assets/Libraries
A change to existing behaviour in src/Files.App/Assets/Libraries — 4 commits, 4 files: “Code Quality: Updated SevenZipSharp for Native AOT (\#18835)”; “Code Quality: Upgrade dependencies (\#16741)”; “Feature: SSH and AOT support for git operations (\#18885)”; and 1 more (refs \#18835, \#16741, \#18885, \#16432).
src/Files.App/Assets/Libraries · medium confidence · unverified
58 commits (8 fixes) modifying src/Files.App/ViewModels/Dialogs
A change to existing behaviour in src/Files.App/ViewModels/Dialogs — 58 commits (8 fixs), 14 files: “Code Quality: Handle missing directory in default destination”; “Code quality: Compare null with 'is' instead of '==' (\#10326)”; “Code Quality: Introduce Implicit Usings (\#12121)”; and 55 more (refs \#10326, \#12121, \#11013, \#15934, \#16317, …).
src/Files.App/ViewModels/Dialogs · medium confidence · unverified
7 commits (0 fixes) modifying src/Files.Storage
A change to existing behaviour in src/Files.Storage — 7 commits, 76 files: “Code Quality: Shared shell helpers between the app and server (\#19051)”; “Bump Microsoft.Windows.CsWin32 from 0.3.363 to 0.3.369 (\#19107)”; “Feature: Added support for folder aliases (\#18998)”; and 4 more (refs \#19051, \#19107, \#18998, \#19053, \#19078, …).
src/Files.Storage · medium confidence · unverified
App startup and activation logic restructured for improved performance and reliability
The application entry point and main window initialization have been refactored to significantly improve startup speed and stability. The new \App.xaml.cs\ and \Program.cs\ implement off-thread dependency injection container construction and command warmup, allowing the UI to render while background services initialize. A new splash screen mechanism is introduced for non-Native AOT builds to mask this initialization time. Activation handling is consolidated in \MainWindow.xaml.cs\ to better manage single-instance locking, protocol launches, and command-line arguments, ensuring the correct window is brought to the foreground and tabs are restored or created as expected. Additionally, the app now captures and respects the working directory of the launching process (e.g., a terminal) for relative path resolution.
src/Files.App · high confidence
BladeView control refactored to support resizing and fullscreen modes
The BladeView control in the Files App has been restructured to introduce a resizable BladeItem and a new Fullscreen mode. Users can now manually resize individual blade columns by dragging their right edge, with double-clicking the edge to auto-size the column based on its content. The control also supports a Fullscreen mode where blades expand to fill the entire container width. Additionally, the BladeItem now exposes a VisibilityChanged event to notify when blades are opened or closed, improving accessibility and state management.
src/Files.App.Controls/BladeView · high confidence
Consolidated and expanded value converter library
The application now uses a unified set of value converters in the \Files.App.Converters\ namespace to handle UI data binding. This change introduces a generic \ValueConverter\ base class to simplify implementation and adds specific converters for mapping action categories to localized strings, handling file conflict resolution options, converting status center states to colored brushes and icons, and formatting various data types (dates, booleans, enums, arrays, and colors) for display. These converters provide the underlying logic for consistent data presentation and user interaction across the app's views.
src/Files.App/Converters · high confidence
Context menus now feature a primary command row and support access keys
The context menu system has been refactored to improve usability and performance. Primary commands are now displayed as a horizontal row of icon buttons at the top of the menu, separated from the rest of the items. Additionally, context menu items now support access keys, allowing users to activate commands via keyboard shortcuts. The underlying helper classes have been updated to support these new UI elements and lazy-loading for shell submenus.
src/Files.App/Helpers/MenuFlyout · high confidence
Cursor manipulation and debug logging infrastructure added to controls
The Files.App.Controls library now includes a GlobalHelper class that enables changing UI element cursors via UnsafeAccessor to bypass protected property restrictions, and provides conditional debug logging for the Omnibar feature when the OMNIBAR\_DEBUG flag is defined. Additionally, GlobalUsings were consolidated to reduce boilerplate across the controls project.
src/Files.App.Controls · high confidence
File tags now persist across app updates via registry storage
The file tagging system has been migrated from a local database to the Windows Registry, ensuring that user-defined tags are preserved even when the application is updated. This change resolves issues where tags were lost during updates and fixes bugs related to searching for tags containing spaces. The new implementation also includes a dedicated UI option to remove all tags from selected files and handles edge cases such as non-NTFS drives and security exceptions during registry access.
src/Files.App/Utils/FileTags · high confidence
Git operations now report progress and handle errors gracefully
Git operations now provide progress reporting to the user via the StatusCenter, allowing them to track the completion of actions like fetching and checking out branches. The underlying service has been refactored to use dependency injection and includes improved error handling, ensuring that issues such as corrupted repositories or missing paths are logged and managed without crashing the application.
src/Files.App/Services/Git · high confidence
Introduce ContentPageContext for unified page state management
The application now uses a new \ContentPageContext\ to centralize the state and navigation logic for the main file-viewing area. This context exposes properties that reflect the current shell page, including the active folder, selected items, navigation capabilities (back/forward/parent), and multi-pane status. It also tracks specific page types such as Home, Recycle Bin, Zip folders, FTP, Libraries, Cloud Drives, MTP devices, Search Results, Release Notes, and Settings, allowing the UI to adapt its layout and toolbar based on the current view. Additionally, it provides Git-specific state indicators like \IsGitRepository\ and \CanExecuteGitAction\, ensuring the interface correctly reflects repository context and action availability.
src/Files.App/Data/Contexts/ContentPage · high confidence
Introduce HomePageContext for widget state management
The HomePage location now uses a dedicated HomePageContext (implementing IHomePageContext) to centralize and expose widget-related state, including the last right-clicked item, its context flyout, and selected tagged items. This context subscribes to widget view-model events to keep these properties in sync, providing a single source of truth for the home page's widget interactions.
src/Files.App/Data/Contexts/HomePage · high confidence
Introduce new storage enumerators for improved folder listing performance
Added UniversalStorageEnumerator and Win32StorageEnumerator to the storage utilities, replacing previous enumeration logic. These new components implement batched retrieval with intermediate flushing to display content on screen more quickly, support configurable folder size calculation, and handle icon caching and alternate data streams more efficiently.
src/Files.App/Utils/Storage/Enumerators · high confidence
Introduces a centralized dialog helper and factory for consistent UI interactions
Users benefit from a more consistent and robust dialog experience across the application. A new \DialogDisplayHelper\ provides a standardized method for showing simple confirmation dialogs, while \DynamicDialogFactory\ centralizes the creation of complex dialogs, including the 'Create new item' dialog which now pre-fills default names for folders and files, and the 'File In Use' dialog which now displays specific locking process details. This refactoring ensures uniform styling and behavior for all user-facing prompts.
src/Files.App/Helpers/Dialog · high confidence
Introduces dedicated event argument classes for navigation and UI interactions
The application now uses a set of strongly-typed event argument classes in the \Files.App.Data.EventArguments\ namespace to handle internal communication. This includes \NavigationArguments\ and \PaneNavigationArguments\ for managing file explorer navigation and dual-pane arrangements, \LayoutModeEventArgs\ and \LayoutPreferenceEventArgs\ for controlling folder view settings, and specific arguments for search (\SearchBoxQuerySubmittedEventArgs\), quick access modifications (\ModifyQuickAccessEventArgs\), and widget interactions (\WidgetsRightClickedItemChangedEventArgs\). This change standardizes how UI state changes and user actions are passed between components.
src/Files.App/Data/EventArguments · high confidence
Introduction of new source generator diagnostics and constants
The source generator now includes new diagnostic rules (FSG1001 and FSG1003) to enforce design constraints and file generation integrity. FSG1001 reports an error when unsupported types are used with the Windows Registry, while FSG1003 detects and flags conflicts arising from multiple localization string files sharing the same name. Additionally, constants for DependencyProperty and string generation have been centralized in a new Constants class to support these features.
src/Files.Core.SourceGenerator · high confidence
Layout preferences now persist across application updates via Windows Registry
The application has migrated folder layout preferences from local storage to the Windows Registry (HKEY\_CURRENT\_USER). This change ensures that your custom view settings, sort orders, and grouping preferences are retained even after application updates or reinstalls. The new \LayoutPreferencesDatabase\ and \LayoutPreferencesDatabaseManager\ classes handle reading and writing these settings, while \LayoutPreferencesItem\ and \LayoutPreferencesManager\ manage the in-memory state and synchronization with the UI.
src/Files.App/Helpers/Layout · high confidence
Major data model and ViewModel refactoring in src/Files.App/Data/Models
The data models and ViewModels in this location have been completely rewritten to support new application features and improve performance. Key changes include the introduction of \ColumnsViewModel\ to manage detailed layout columns (including Git status, commit info, and tags), \CompressArchiveModel\ to handle advanced archive creation with options for dictionary/word size and UTF-8 encoding, and \ContextMenuFlyoutItemViewModel\ with a builder pattern to support access keys and keyboard accelerators. The \AppModel\ now tracks DPI scaling and clipboard state, while \DrivesViewModel\ uses a new \IStorageDeviceWatcher\ interface for more robust drive enumeration. Git integration is deepened with \GitItemModel\ and \StatusBarViewModel\ updates for branch management and IDE integration. Additionally, new utility models like \ByteSize\ for localized size formatting, \DisposableArray\ for secure memory handling, and \ItemManipulationModel\ for list interactions have been added.
src/Files.App/Data/Models · high confidence
New DisplayPage context for managing folder view and sort settings
A new DisplayPage context has been introduced to centralize the management of folder display preferences. This change adds a new context class and interface that expose properties for controlling the active layout mode (Details, List, Cards, Grid, Columns, or Adaptive), sorting options (by name, date, etc., with direction), grouping settings, and file prioritization (sorting files first or alongside directories). The context listens for changes in the active pane and layout settings service to keep the UI state synchronized with the underlying folder preferences.
src/Files.App/Data/Contexts/DisplayPage · high confidence
New Files.OpenDialog COM component for protocol-based file selection
A new ATL-based COM DLL (Files.App.OpenDialog) has been added to handle file open dialogs. Instead of using the native Windows dialog, the component launches the Files application via a custom URI protocol (\files-dev:?cmd=...\) to perform the selection, writing the result to a temporary file. This implementation supports multiple architectures (Win32, x64, arm64) and uses the v145 platform toolset.
src/Files.App.OpenDialog · high confidence
New MultitaskingContext for tab state management
The application now uses a dedicated MultitaskingContext to manage tab-related state, exposing properties for the current and selected tab items, their indices, and the total tab count. This context listens for changes in the app instance collection and tab strip selection to keep the UI state synchronized, and handles focus events to ensure the selected tab index is updated correctly when users interact with the interface.
src/Files.App/Data/Contexts/Multitasking · high confidence
New data models for navigation parameters in the Files.App
The application introduces a new namespace, Files.App.Data.Parameters, containing several new classes to handle navigation state: ColumnParam for column view context, NavigationParams for basic path selection, PropertiesPageNavigationParameter for property dialog context, SettingsNavigationParams for settings page routing, and TabBarItemParameter for tab state serialization and deserialization. These changes support the internal refactoring of how navigation arguments and tab data are passed and persisted within the application.
src/Files.App/Data/Parameters · high confidence
New tag search query parsing infrastructure
The search module in src/Files.App/Utils/Storage/Search now includes dedicated classes for parsing tag-based queries: TagQueryExpression defines the structure for OR groups of tag terms, and TagTerm represents individual tag conditions including exclusion flags and tag UIDs. These new files support the underlying logic for handling tag searches, including fixes for tags with spaces and AND/OR operator support, by providing a structured way to represent tag query expressions within the search pipeline.
src/Files.App/Utils/Storage/Search · high confidence
New thread-safe storage collection utilities for grouping and sorting
The Files.App storage layer now includes a new set of thread-safe collection utilities in the \Files.App.Utils.Storage\ namespace to improve reliability and performance when handling file lists. This introduces \BulkConcurrentObservableCollection\ and \ConcurrentCollection\, which use locking to prevent crashes and race conditions during bulk operations, alongside a \BlockingListEnumerator\ for safe iteration. These collections support dynamic grouping (by name, size, date, path, etc.) via \GroupingHelper\ and \GroupedCollection\, and provide robust sorting logic through \SortingHelper\, ensuring that file lists remain responsive and stable even when modified concurrently.
src/Files.App/Utils/Storage/Collection · high confidence
Preview popup action now uses async provider service
The LaunchPreviewPopupAction now retrieves the preview provider via an asynchronous call to IPreviewPopupService.GetProviderAsync() instead of direct instantiation or synchronous lookup. This change ensures that the preview popup launch and switch operations handle provider resolution asynchronously, improving responsiveness and preventing potential blocking on the UI thread when the preview provider is not immediately available.
src/Files.App/Actions/Content/PreviewPopup · high confidence
Progressive cloud drive detection and sync status indicators
Cloud drives are now detected progressively so that a slow provider (such as Google Drive's virtual drive) no longer delays the sidebar or app startup. The cloud drives manager now registers each provider as it is detected and updates the sidebar in real time. Additionally, a new sync-status system (enum and UI helper) provides specific status icons and labels for files and folders, including states like online, offline, pinned, excluded, and syncing.
src/Files.App/Utils/Cloud · high confidence
Progressive cloud drive detection improves startup performance
The cloud provider detection logic has been updated to yield results progressively as each provider finishes initializing, rather than waiting for all providers to complete before returning the full list. This ensures that a slow or unresponsive cloud provider (such as Google Drive) no longer delays the availability of other detected cloud drives during application startup.
src/Files.App/Utils/Cloud/Detector · high confidence
Properties window receives a complete ViewModel architecture overhaul
The Properties window's view models have been restructured into a new modular architecture. A new \BasePropertiesPage\ now acts as the central navigation hub, instantiating specific property pages (General, Details, Security, Customization, Compatibility, Hashes, Signatures) based on the selected item type. This change introduces dedicated view models for each tab: \SecurityViewModel\ and \SecurityAdvancedViewModel\ for managing Access Control Lists, \CustomizationViewModel\ for file/folder icon editing, \CompatibilityViewModel\ for Windows compatibility settings, \HashesViewModel\ for calculating and comparing file hashes, and \SignaturesViewModel\ for displaying digital signatures. This refactoring consolidates the logic previously scattered across the properties window into distinct, maintainable components.
src/Files.App/ViewModels/Properties · high confidence
Redesigned Modern Shell Page with swipe navigation and filter headers
The ModernShellPage view has been completely rewritten to introduce a new visual design and interaction model. Users can now navigate history using swipe gestures on the left and right edges of the file pane, indicated by dedicated Back and Forward icons. The layout now includes a dedicated Search Header and a Filter Header, allowing users to see and modify search queries and file filters directly within the main view. Additionally, the page supports configurable folder background images, which are displayed behind the file content with adjustable alignment, opacity, and fit settings.
src/Files.App/Views/Shells · high confidence
Redesigned navigation, toolbar, and status bar UI components
The Files application introduces a comprehensive redesign of its core interface controls. The NavigationToolbar now features a new address bar style, animated navigation icons, and overflow flyouts for back/forward history with thumbnail previews. The Toolbar has been restyled with a rounded card appearance, dynamic overflow support, and updated command buttons for selection and sorting. The StatusBar now includes a responsive layout that collapses into a compact status button on smaller windows, supports Git branch display with pull/push actions, and integrates a segmented control for ZIP encoding selection. Additionally, new user controls have been added to improve visual feedback: DataGridHeader provides animated sort indicators, FileIcon handles custom and system file icons, FolderEmptyIndicator displays contextual empty states, and LocationUnavailableIndicator shows standardized error messages for missing paths.
src/Files.App/UserControls · high confidence
Refactor 'Open in new pane' to use RichCommands
The 'Open in new pane' functionality has been refactored to use the new RichCommands system, introducing specific action classes for the Home and Sidebar contexts. This change ensures the command is only available when multi-pane is supported but not yet active, and it correctly handles right-clicked items on the Home page (including folder tags) and Sidebar locations, while preventing execution on empty drives.
src/Files.App/Actions/Navigation/OpenInNewPane · high confidence
Refactor settings serialization to use AOT-friendly System.Text.Json
The application's settings serialization layer has been refactored to support Ahead-of-Time (AOT) compilation. This change introduces a new \AppJsonSerializerContext\ that explicitly registers types used in settings (such as \PaneNavigationArguments\, \TaggedFile\, and \LayoutPreferences\) and replaces the previous serialization approach with \System.Text.Json\-based interfaces (\IJsonSettingsSerializer\, \IJsonSettingsDatabase\). This ensures that settings like sort preferences and layout configurations are serialized correctly in AOT environments, addressing issues where changes might not persist or apply properly.
src/Files.App/Utils/Serialization · high confidence
Refactored 'Open in New Tab' into context-specific actions
The 'Open in New Tab' functionality has been split into distinct action classes to better handle different UI contexts. The base action now supports opening multiple selected folders in new tabs, while specific implementations handle right-click scenarios on the Home page (OpenInNewTabFromHomeAction) and the Sidebar (OpenInNewTabFromSidebarAction). This change ensures the command is only available when appropriate (e.g., not globally accessible from Home/Sidebar contexts) and correctly resolves shortcut targets.
src/Files.App/Actions/Navigation/OpenInNewTab · high confidence
Refactored 'Open in New Window' into context-specific actions
The 'Open in New Window' functionality has been split into distinct action classes to handle different user contexts. The main action now opens selected folders in new windows via a custom URI scheme, while new specific actions allow opening items from the Home page context menu and the Sidebar context menu, each with their own execution logic and availability rules.
src/Files.App/Actions/Navigation/OpenInNewWindow · high confidence
Refactored Copy and Cut actions to use a shared base class
The Copy and Cut file operations have been refactored to share a common base class (BaseTransferItemAction), which centralizes the execution logic and selection state management. This change simplifies the UI operation layer for these actions, ensuring consistent behavior and reducing code duplication while preserving existing functionality for copying and moving selected items.
src/Files.App/Actions/FileSystem/Transfer · high confidence
Refactored Status Center with improved progress tracking and speed graphing
The Status Center implementation has been refactored to provide more granular and accurate progress reporting for file operations. A new helper class centralizes the creation of status cards for copy, move, and recycle operations, ensuring consistent handling of source/destination paths and operation states. The underlying item model now supports a speed graph via a collection of vector values, allowing users to visualize transfer speeds in real-time. Additionally, the progress model has been enhanced to track processed items and sizes with interval-sampled speed calculations, improving the responsiveness and accuracy of the UI during long-running tasks.
src/Files.App/Utils/StatusCenter · high confidence
Refactored Win32 helpers to use CsWin32 and consolidate P/Invoke definitions
The Win32 helper layer has been restructured to replace manual DllImport declarations with generated code from the CsWin32 source generator (Windows.Win32 namespace). This change consolidates scattered interop definitions into a unified \Win32PInvoke\ partial class and splits the main \Win32Helper\ into focused files (Process, Shell, Storage, WindowManagement). For users, this improves reliability and performance of core file operations, including launching applications with correct arguments and working directories, resolving shell folder paths, managing window focus, and retrieving file icons and overlays.
src/Files.App/Helpers/Win32 · high confidence
Refactored app services and introduced smooth scrolling toggle
The app's service layer has been reorganized into dedicated, new service classes (AppDialogService, AppLocalizationService, AppResourcesService, AppThemeModeService, AppThreadingService, and FileTagsService) to improve structure and maintainability. Additionally, users can now disable smooth scrolling via a new setting, which is handled by the AppResourcesService to toggle scroll inertia in real-time.
src/Files.App/Services/App · high confidence
Refactored archive compression actions to use a new service-based architecture
The archive compression functionality in the Files app has been refactored to use a new \IStorageArchiveService\ and a set of dedicated action classes (\CompressIntoArchiveAction\, \CompressIntoZipAction\, \CompressIntoSevenZipAction\) that inherit from a new \BaseCompressArchiveAction\. This change introduces a more structured approach to handling compression tasks, where the base action class manages common logic such as determining the destination directory and file name, while specific actions handle format-specific details. The \CompressIntoArchiveAction\ now presents a dialog for user input, allowing for more flexible compression options, whereas \CompressIntoZipAction\ and \CompressIntoSevenZipAction\ perform direct compression with default settings. This refactoring improves code maintainability and prepares the system for future enhancements in archive handling.
src/Files.App/Actions/Content/Archives/Compress · high confidence
Refactored archive extraction into a modular action system with encoding and smart-extract support
The archive extraction logic in the Files app has been restructured into a set of distinct, composable actions (Decompress, Decompress Here, Decompress Here Smart, and Decompress to Child Folder) built on a new BaseDecompressArchiveAction. This change introduces several user-facing capabilities: users can now select a specific text encoding when extracting ZIP files, and the app can automatically detect the encoding for archives where it is undetermined. Additionally, the 'Extract Here Smart' option has been implemented to automatically create a subfolder for the extracted contents if the archive contains multiple top-level items, preventing file clutter. The extraction dialog also remembers and allows selection of previous extraction locations, and the system now correctly handles archives with reserved item names and encrypted files.
src/Files.App/Actions/Content/Archives/Decompress · high confidence
Refactored command management with grouping and custom keybinding support
The command system has been restructured to support organized command groups (such as Extract, Set As, New Item, Open With, and Edit Tags) and improved handling of custom key bindings. The new CommandGroupManager defines these groups with specific icons, access keys, and categories, while the CommandManager now dynamically applies user-defined key bindings from settings and automatically resolves conflicts by restoring defaults when duplicates are detected. Additionally, a ModifiableCommandManager provides context-aware command variations, such as enabling Shift+Delete for permanent deletion or Shift+Paste for pasting into selection.
src/Files.App/Data/Commands/Manager · high confidence
Refactored file system dialog into a structured ViewModel hierarchy
The file system dialog logic has been restructured into a dedicated ViewModel hierarchy within the \FileSystemDialog\ namespace. This introduces a base \BaseFileSystemDialogItemViewModel\ and specific implementations like \FileSystemDialogConflictItemViewModel\ to manage conflict resolution states (such as custom names and resolve options) and \FileSystemDialogDefaultItemViewModel\ for standard items. The main \FileSystemDialogViewModel\ now orchestrates these items, handling aggregated conflict resolution options, persisting user preferences for conflict handling, and managing dialog modes for copy, move, and delete operations.
src/Files.App/ViewModels/Dialogs/FileSystemDialog · high confidence
Refactored layout view model and enhanced drag-and-drop behavior
The layout view models have been refactored, introducing a new BaseLayoutViewModel that centralizes core interaction logic such as file creation, pointer events, and mouse-wheel size adjustments. Drag-and-drop handling has been improved with specific fixes for race conditions, null payload guards, and support for cloning Git repositories via drag. Additionally, the system now correctly handles dropping items from external sources like 7-Zip and Edge, and prevents invalid self-drops on sidebar items.
src/Files.App/ViewModels/Layouts · high confidence
Refactored properties window view models into a new class hierarchy
The properties window logic has been restructured into a new set of view models located in src/Files.App/ViewModels/Properties/Items. A new BaseProperties abstract class provides shared functionality for property retrieval and folder size calculation. Specific implementations now handle distinct item types: FileProperties and CombinedFileProperties manage single and multiple file metadata (including GPS address resolution and multi-file aggregation), FolderProperties handles folder sizes and recycle bin stats, DriveProperties manages drive capacity and sync status, and LibraryProperties displays library locations and sizes. The refactoring introduces an IFileProperties interface to standardize metadata operations (GetSystemFilePropertiesAsync, SyncPropertyChangesAsync, ClearPropertiesAsync) and adds support for editing file attributes like Read-Only, Hidden, and Compressed status directly from the properties window.
src/Files.App/ViewModels/Properties/Items · high confidence
Refactored settings storage into a modular service architecture
The application's settings management has been restructured from a monolithic model into a set of specialized, modular services (such as AppearanceSettingsService, FoldersSettingsService, and LayoutSettingsService) that handle specific configuration domains. This change introduces a new UserSettingsService that aggregates these modules and implements a custom export process that automatically excludes volatile session data (like open tabs and path history) to ensure exported settings are clean and portable. Additionally, the FoldersSettingsService now includes an automatic migration routine that converts legacy single-click open preferences into the new mode-based settings, ensuring existing user configurations are preserved during the upgrade.
src/Files.App/Services/Settings · high confidence
Refactored storage control helpers into a dedicated utility class
The logic for calculating modulus, interpolating thickness and angles, and converting between values and percentages has been extracted into a new \StorageControlsHelpers\ class. This refactoring centralizes the mathematical operations used by \StorageRing\ and \StorageBar\, improving code maintainability without changing the visual behavior of the storage indicators.
src/Files.App.Controls/Storage · high confidence
Rewritten shell utilities using Windows.Win32 interop
The shell interaction layer in src/Files.App/Utils/Shell has been completely rewritten to replace the previous Vanara library with the Windows.Win32 source-generated interop. This change introduces new implementations for context menus (including a worker pool for performance), file operations, preview handlers, and launch helpers, providing a more robust and maintainable foundation for shell integration.
src/Files.App/Utils/Shell · high confidence
Settings interface migrated to Community Toolkit controls and new page structure
The Settings UI has been rebuilt using Community Toolkit WinUI controls (SettingsCard, SettingsExpander) and reorganized into distinct pages (About, Actions, Advanced, Appearance, DevTools, Folders, General). This change replaces the previous custom settings dialog with a modern, page-based navigation experience and updates the visual style of all settings options.
src/Files.App/Views/Settings · high confidence
Share action now displays dynamic item count in description
The Share action in the Files app now includes a localized description that dynamically updates to show the number of selected items (e.g., "Share 1 item" or "Share 5 items"). This change improves user clarity by explicitly indicating how many files or folders will be included in the share operation, leveraging the centralized Strings class for localization.
src/Files.App/Actions/Content/Share · high confidence
Shelf pane selection state exposed via context interface
The Shelf pane now exposes its selection state through a dedicated \IShelfContext\ interface and implementation. This allows other parts of the application to react to changes in the shelf's selected items and determine whether any items are currently selected, enabling better integration with UI elements that depend on shelf selection status.
src/Files.App/Data/Contexts/Shelf · high confidence
Sidebar control refactored with drag-and-drop, tree-view support, and new display modes
The sidebar control has been rebuilt to support hierarchical tree views, drag-and-drop reordering, and three display modes (Expanded, Compact, Minimal). Users can now drag sidebar items to reorder them or nest them as children, with visual indicators showing drop positions. The sidebar adapts to different contexts: Expanded mode shows full text and hierarchy, Compact mode shows only icons, and Minimal mode hides the pane until opened. The control also includes improved accessibility via UI Automation peers, better selection handling across virtualized items, and support for lazy-loading child items.
src/Files.App.Controls/Sidebar · high confidence
Source generator utilities refactored and expanded
The source generator's utility layer has been significantly restructured to support more complex code generation. New helper classes and data structures have been added, including \EquatableArray\ for value-based equality of immutable arrays, \HashCode\ as a polyfill for xxHash32-based hashing, and data models like \ParameterTypeNamePair\, \ParserItem\, and \VTableFunctionInfo\ to handle detailed metadata for generated code. The \SourceGeneratorHelper\ now provides expanded methods for generating constructors, properties, and fields, including support for COM vtable function generation and specific attribute handling for generated code. Additionally, a \UsingCollector\ syntax walker has been introduced to automatically gather namespace imports from source trees.
src/Files.Core.SourceGenerator/Utilities · high confidence
UI layer refactoring and new visual features
This update introduces several user-facing changes and structural improvements to the UI layer. Users can now select a 'Thin acrylic' system backdrop for the window background, and sidebar section icons automatically adapt to high-contrast accessibility settings. The 'Create new item' dialog has been improved with better UX and default naming, and newly created files are automatically added to the Recent Files list. Additionally, the app now supports pasting items as shortcuts and always displays file extensions during renaming. Under the hood, the UI helpers have been refactored to use \InputNonClientPointerSource\ for drag regions, and various crash fixes (such as those related to window closing and dialog states) improve stability.
src/Files.App/Helpers/UI · high confidence
Updated Afrikaans, Arabic, Belarusian, Bulgarian, Catalan, Czech, and Danish translations
The localized string resources for Afrikaans, Arabic, Belarusian, Bulgarian, Catalan, Czech, and Danish have been updated. These changes include translations for new interface elements such as the command palette placeholder text, search settings, and various file operation labels, ensuring the application displays correctly in these languages.
src/Files.App/Strings · high confidence
Widget visibility logic now respects individual user settings
The WidgetsHelpers utility now checks specific user preferences in the General Settings to determine whether individual widgets (Quick Access, Drives, Network Locations, File Tags, and Recent Files) are enabled. If a widget is disabled in settings, it is automatically removed from the Home view, ensuring that only user-selected widgets are displayed.
src/Files.App/Utils/Widgets · high confidence
Widgets now use a shared base ViewModel with unified context menus
The Home page widgets (Drives, Quick Access, Recent Files, File Tags, and Network Locations) now share a common BaseWidgetViewModel that centralizes dependency injection and context menu construction. This refactoring standardizes how right-click menus are built across all widgets, ensuring consistent behavior for actions like opening in new tabs, pinning to the sidebar, and accessing properties, while also improving performance by reducing UI dispatcher blocking during widget refreshes.
src/Files.App/ViewModels/UserControls/Widgets · high confidence
Window context exposes admin and drag-and-drop state
The application now exposes whether it is running with elevated privileges and whether drag-and-drop operations are permitted through the window context. This allows UI components to adjust their behavior, such as disabling drag-and-drop interactions when the application is running as an administrator.
src/Files.App/Data/Contexts/Window · high confidence
Test coverage
Added Files.App.UITests test application scaffolding; Added UI test pages for BreadcrumbBar, Omnibar, Storage controls, ThemedIcon, and Toolbar; Added Windows UI interaction tests using Appium; Added interaction test helpers for accessibility scanning and UI automation; Added interaction tests for core file operations and UI components.
Dependencies
Centralized dependency management and project structure reorganization
The project has adopted Central Package Versions (CPV) via a new Directory.Packages.props file, which now centrally defines versions for all NuGet packages including Windows App SDK 2.5.1, CommunityToolkit.Mvvm 8.4.2, and Sentry 6.11.0. This change is accompanied by a structural reorganization of the solution, introducing new projects such as Files.App.Controls, Files.App.CsWin32, Files.App.BackgroundTasks, and Files.App.Storage, while updating existing projects like Files.App and Files.Core.Storage to reference these new components and utilize the centralized versioning.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 58 → 55 (-2.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 57 → 58 (+0.5)
- Architecture 77 → 69 (-8.6)
- Maturity 56 → 64 (+8.4)
- Readiness 57 → 50 (-7.4)
- Security 68 → 61 (-7.2)
- Performance 61 → 60 (-1.0)
Resolved (63)
- BulkConcurrentObservableCollection.AddItemsToGroup (cognitive 17) (src/Files.App/Utils/Storage/Collection/BulkConcurrentObservableCollection.cs)
- CachedTask.GetAsync (cognitive 17) (src/Files.App.Server/Initialization/CachedTask.cs)
- ContextMenu.EnumMenuItems (cognitive 40) (src/Files.App/Utils/Shell/ContextMenu.cs)
- ContextMenu.EnumMenuItems (cyclomatic 16) (src/Files.App/Utils/Shell/ContextMenu.cs)
- Coverage not measured — no coverage collector is wired up
- DriveItem.UpdatePropertiesAsync (cognitive 18) (src/Files.App/Data/Items/DriveItem.cs)
- Duplicated block (12 lines × 3) (src/Files.App/Services/App/AppUpdateNoneService.cs)
- Duplicated block (18 lines × 2) (src/Files.App/Utils/FileTags/FileTagsDatabase.cs)
- Duplicated block (28 lines × 2) (src/Files.App/Services/App/AppUpdateSideloadService.cs)
- Duplicated block (5 lines × 2) (src/Files.App/Helpers/Win32/Win32Helper.Storage.cs)
- Duplicated block (6 lines × 2) (src/Files.App/Helpers/Navigation/NavigationHelpers.cs)
- Duplicated block (6 lines × 2) (src/Files.App/ViewModels/MainPageViewModel.cs)
- Duplicated block (9 lines × 2) (src/Files.App.Server/Cloud/CloudDrivesDetector.cs)
- Edited copy of a member (22 corresponding lines) (src/Files.App/Utils/FileTags/FileTagsDatabase.cs)
- EmptyCatchBlock (src/Files.App.Server/Initialization/ShellNewMenuHelper.cs)
- EmptyCatchBlock (src/Files.App/App.xaml.cs)
- EmptyCatchBlock (src/Files.App/Data/Items/DriveItem.cs)
- EmptyCatchBlock (src/Files.App/Helpers/Win32/Win32Helper.Storage.cs)
- EmptyCatchBlock (src/Files.App/Services/App/AppUpdateSideloadService.cs)
- EmptyCatchBlock (src/Files.App/Services/App/AppUpdateSideloadService.cs)
- …and 43 more
New (121)
- App.ConnectServerAsync (cognitive 16) (src/Files.App/App.Server.cs)
- BaseLayoutPage.OpenItemContextFlyoutAsync (cognitive 16) (src/Files.App/Views/Layouts/BaseLayoutPage.cs)
- CachedTask.GetAsync (cognitive 18) (src/Files.App.Server/Caching/CachedTask.cs)
- CatalogWatchers.RefreshRecycleBinWatcher (cognitive 24) (src/Files.App.Server/Catalogs/CatalogWatchers.cs)
- Change coupling: LayoutPreferencesDatabase.cs ↔ FileTagsDatabase.cs (src/Files.App/Helpers/Layout/LayoutPreferencesDatabase.cs)
- ClassicContextMenuBackend.EnumMenuItems (cognitive 40) (src/Files.App.Server/Shell/ClassicContextMenuBackend.cs)
- ClassicContextMenuBackend.EnumMenuItems (cyclomatic 16) (src/Files.App.Server/Shell/ClassicContextMenuBackend.cs)
- CloudContextMenuCommands.GetCommands (cognitive 23) (src/Files.App.Server/Shell/CloudContextMenuCommands.cs)
- CloudContextMenuCommands.GetCommands (cyclomatic 20) (src/Files.App.Server/Shell/CloudContextMenuCommands.cs)
- DirectoryChangeMonitor.Configure (cognitive 19) (src/Files.App.Server/Caching/DirectoryChangeMonitor.cs)
- DirectoryChangeMonitor.Configure (cyclomatic 17) (src/Files.App.Server/Caching/DirectoryChangeMonitor.cs)
- Documentation: no build, run or usage example (.github/README.md)
- DriveCatalog.LoadAsync (cyclomatic 19) (src/Files.App.Server/Catalogs/DriveCatalog.cs)
- DrivesViewModel.UpdateDrivesAsync (cognitive 18) (src/Files.App/Data/Models/DrivesViewModel.cs)
- Duplicated block (10 lines × 2) (src/Files.App.Server/Shell/ContextMenuItem.cs)
- Duplicated block (16–24 lines × 2) (src/Files.App/Helpers/Navigation/NavigationHelpers.cs)
- Duplicated block (18 lines × 2) (src/Files.Storage/Windows/Tags/FileTagRegistryStore.cs)
- Duplicated block (5 lines × 5) (src/Files.App/Views/Settings/ActionsPage.xaml.cs)
- Duplicated block (7 lines × 2) (src/Files.Storage/Windows/Interop/IFileExplorerAppExtension.cs)
- Duplicated block (8 lines × 2) (src/Files.App/Views/Layouts/BaseLayoutPage.cs)
- …and 101 more
Changes since last survey
- 26 commits — 24 feature/other, 2 fixes
By area
- src/Files.App — 14 commits
- (root) — 7 commits
- src/Files.App.Server — 2 commits
- src/Files.Storage — 2 commits
- src/Files.App.Controls — 1 commit
Notable commits
- fix: Fix: Fixed issue where pasting text in the Omnibar would sometimes close it (#19124)
- fix: Fix: Fixed issue where tooltips covered over caption buttons
- change: Build: v4.3.2
- change: Bump MSTest.TestAdapter and MSTest.TestFramework (#19073)
- change: Bump Microsoft.Testing.Extensions.TrxReport from 2.5.1 to 2.5.2 (#19072)
- change: Bump Microsoft.Windows.CsWin32 from 0.3.363 to 0.3.369 (#19107)
- change: Bump Microsoft.Windows.SDK.BuildTools from 10.0.28000.2705 to 10.0.28000.2957 (#19080)
- change: Bump PolySharp from 1.16.0 to 1.17.0 (#19119)
- change: Bump the windows-app-sdk group with 1 update (#19095)
- change: Code Quality: Added logs to make startup failure visible (#19102)
- change: Code Quality: Adopted Satori GC (#19112)
- change: Code Quality: Moved location catalogs and live notifications to the server (#19078)
- change: Code Quality: Moved shell services to server (#19077)
- change: Code Quality: Optimize package size (#19105)
- change: Code Quality: Prepared shared server infrastructure (#19054)
- change: Code Quality: Removed line
- change: Code Quality: Resolve warnings (#19060)
- change: Code Quality: Shared shell helpers between the app and server (#19051)
- change: Code Quality: Shared tag registry storage (#19053)
- change: Code Quality: Show sidebar tooltips only when text is hidden
- …and 6 more
Architecture
- Containers 0 added · 0 removed · contexts 1 added · 0 removed · edges 1 added · 0 removed
Added bounded contexts (1)
- Files.App.Controls
Added dependency edges (1)
- Files.App → Files.App.Controls
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
files-community/Files was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 10 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 3a9ea87782ac6feec9f7c61e6530903d156870a5 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.4+preprod-464a0040a931.