gabriel-x-duarte/responsive_window

This is a Flutter package, meaning a reusable code library for apps built with Google's Flutter framework, which is used to build apps for phones, web, and desktop from one codebase. Its job is to let any part of an app easily find out how big the app window currently is, and react to that. Rather than trying to detect what physical device someone is using, this library looks at the actual pixel width and height of the app window and sorts it into one of five size categories: compact, medium, expanded, large, and extra large. These category names and their width cutoffs are based on Google's own Material Design 3 guidelines, so a narrow phone screen or a resized desktop window would both count as compact if they are narrow enough, while a wide tablet or desktop window would land in one of the larger categories. To use it, a developer wraps their app's root widget with a component called ResponsiveWindow, then anywhere else in the app they can read the current window information through a simple call on the build context. From there they get the window's width, height, its size category, and whether it is currently landscape, portrait, or square shaped. There are also convenience checks like isAtLeast and isAtMost to test whether the current category falls within a certain range, which is handy for decisions like showing a sidebar only on wider screens. The package also includes a helper called ResponsiveWindowValue that lets a developer pick different values, such as padding amounts, column counts, or even different whole widgets, depending on which size category the window currently falls into, with sensible fallback behavior if a value is not specified for every category. The library only depends on Flutter's own widgets, not Material Design widgets specifically, and it is explicitly scoped to reading window size only, not to configuring native desktop window behavior. It is published on pub.dev, the standard package registry for Dart and Flutter projects, and supports Android, iOS, Web, macOS, Windows, and Linux.