QWindow v3.0.0

Highlights

QWindow v3.0.0 is the stable Vue 3 / Quasar 2 release of the floating-window component and app extension.

• Modernizes the package for Vue 3, Quasar 2, Quasar CLI Vite, and ESM-first bundler usage.
• Uses Vue 3 Teleport for floating windows, targeting #q-app with a body fallback.
• Reworks internals around explicit window state, geometry, restore state, stacking, interaction, and responsive behavior composables.
• Adds/keeps public control methods for show/hide, float/embed, pin/unpin, maximize/minimize/restore, fullscreen behavior, and position reads.
• Ships updated Q-Press docs, generated API drift checks, examples, upgrade notes, and SSG/search output.
• Aligns the app extension with @quasar/app-vite@3.0.0 stable and Quasar UI ^2.21.1.

Compatibility

• Requires Vue 3 and Quasar 2.
• Requires Quasar CLI Vite projects using @quasar/app-vite >= 3.0.0 for the app extension.
• Requires Node 22.13+ for this repository's development and verification tooling.
• Legacy Vue 2 / Quasar 1 and app-webpack projects should stay on the older line until migrated.

Verification

• pnpm deep
• pnpm verify
• UI package pack inspection: quasar-quasar-ui-qwindow-3.0.0.tgz
• App extension pack inspection: quasar-quasar-app-extension-qwindow-3.0.0.tgz

Install

quasar ext add @quasar/qwindow

Manual UI package installs can use:

pnpm add @quasar/quasar-ui-qwindow

Upgrade Notes

• Replace legacy source-file imports with the package entrypoint and dist/index.css.
• QWindow v3 publishes ESM and UMD builds; CommonJS entrypoints are no longer published.
• Vue 3 apps should use v-model / update:model-value; the legacy input event remains for compatibility.
• Review custom titlebar controls, drag/resize behavior, Teleport assumptions, and SSR-sensitive DOM usage when upgrading older layouts.

Donations

QWindow is an open-source project. If it helps your work, sponsorship keeps the maintenance loop moving:

• GitHub Sponsors: https://github.com/sponsors/hawkeye64
• PayPal: https://paypal.me/hawkeye64

Full Changelog

v3.0.0-rc.2...v3.0.0

v3.0.0-rc.2

Target branch: v3-beta

QWindow v3.0.0-rc.2

What's Changed

Highlights

• Added a formal public control surface for QWindow with documented template-ref methods for visibility, embedded/floating mode, pinning, minimize/maximize, fullscreen, restore, and position reads.
• Refactored QWindow internals around explicit state, geometry, restore snapshots, stacking, and pointer interaction composables so the browser-window behavior is easier to reason about and test.
• Added controlled v-model:* state for embedded, pinned, maximized, minimized, and fullscreen modes while preserving the legacy visibility input event for compatibility.
• Added focusable window shell accessibility with aria-label, aria-role, and conservative Escape restore behavior for fullscreen, maximized, and minimized states.
• Adopted Q-Press API generation so the public API JSON now comes from TypeScript/JSDoc instead of stale hand-authored JSON.

Fixes

• 196805f Added a menu-icon prop for the built-in titlebar actions menu button, resolving #24 for non-Material icon sets without requiring a custom titlebar.
• 991face Fixed restore behavior after maximize -> fullscreen -> leave fullscreen by separating fullscreen restore snapshots from maximize/minimize restore state.
• 991face Fixed custom titlebar controls accidentally triggering titlebar drag or double-click maximize by ignoring interactive titlebar targets.
• 991face Fixed QWindow method typings so generated API method signatures include params and return types where available.
• 71ad5d9 Removed the confusing Hide action from the Basic example menu so users do not lose the starter window without an obvious recovery path.
• 38d835c Preserved fenced-code rendering in release notes.
• ca345a8 Added docs header media-query breakpoints for the Q-Press shell.

Docs and examples

• Added Advanced docs for programmatic control, template-ref methods, accessibility, and native-style titlebar behavior.
• Added native macOS and Windows examples that can float, dock back into the page, and maximize/restore through custom chrome.
• Clarified upgrade-guide guidance for custom titlebar controls, embedded/floating state, and ARIA labels/roles.
• Added the release-note template used for this release series.
• Added Q-Press site search and refreshed social preview metadata/assets.
• Updated md-plugins/Q-Press runtime files and dependency alignment through 0.1.0-rc.15.

Compatibility updates

• App extension compatibility: @quasar/app-vite >= 3.0.0-rc.3
• QWindow v3 remains Vite-only; webpack-based Quasar apps are not supported.
• Tooling/release requirements: Node.js >= 22.13 and pnpm >= 11.5.0.
• Release-prep dependency updates include pnpm@11.9.0, autoprefixer@10.5.2, rolldown@1.1.3, and @types/node@26.0.1.

Validation

• Local pnpm verify passed.
• UI and App Extension pack checks passed:
  • /tmp/quasar-quasar-ui-qwindow-3.0.0-rc.2.tgz
  • /tmp/quasar-quasar-app-extension-qwindow-3.0.0-rc.2.tgz
• GitHub Actions Run Vitest passed on 196805f.

Changelog

Changes since v3.0.0-rc.1:

• 196805f fix(ui): allow custom QWindow menu icon
• d1d30cd docs: format QWindow control table
• f735970 chore: prepare QWindow rc.2 release
• 71ad5d9 docs: document QWindow control patterns
• 991face feat(ui): expose QWindow state controls
• 4369894 feat: adopt Q-Press API generation
• f003da6 chore(docs): update md-plugins to 0.1.0-rc.14
• a6deccf chore: update md-plugins and dependencies
• aebe665 chore: update dependencies
• 632ba3a chore: update md-plugins and dependencies
• 028fb00 chore: cache-bust social preview metadata
• fb9c1a9 chore: update md-plugins docs tooling
• d451c27 docs: refresh social preview image
• 38d835c fix(docs): preserve release note code fences
• 1ded225 chore(docs): use #q-app defineConfig import
• ca345a8 fix(docs): add header mq breakpoints
• d231361 feat(docs): add site search
• 2191010 docs: add release template
• e9017f8 chore: update md-plugins and deps
• f11d4a5 chore: update md-plugins to rc.7
• 088142f chore: update md-plugins rc.6 and formatting

Installing

Use the normal package names. This RC is published through the latest npm tag.

$ pnpm add @quasar/quasar-ui-qwindow
# or
$ yarn add @quasar/quasar-ui-qwindow
# or
$ npm install @quasar/quasar-ui-qwindow
# or
$ bun add @quasar/quasar-ui-qwindow
# or
$ quasar ext add @quasar/qwindow

Documentation

QWindow documentation is hosted by Netlify. Visit the documentation for installation guidance, refreshed examples, and updated v3 setup instructions.

Donations

If QWindow is useful in your workflow and you want to support ongoing maintenance:

• GitHub Sponsors: https://github.com/sponsors/hawkeye64
• PayPal: https://paypal.me/hawkeye64

Full Changelog: v3.0.0-rc.1...v3.0.0-rc.2

v3.0.0-rc.1

Target branch: v3-beta

QWindow v3.0.0-rc.1

What's Changed

Highlights

• Added useQWindowResponsiveProps so apps and docs examples can derive responsive QWindow dimensions and safer start positions.
• Improved UMD and CodePen support so examples load published bundles, generated globals, and module imports more reliably.
• Fixed floating QWindow placement when opening on pages that are already scrolled.
• Expanded the resize handles examples to show edge, corner, colored, rounded, and hidden-gripper configurations.
• Updated the QWindow release baseline to @quasar/app-vite@3.0.0-rc.3 and md-plugins rc.4.

Fixes

• f339a24 Fixed floating windows not becoming visible until the page scrolled by initializing scroll position before first placement.
• 0e25d0f Preserved rounded bottom corners on floating QWindow body content.
• 1371904 Kept QWindow CodePen examples pointed at the published UMD bundle instead of workspace-only source paths.
• a9214ba Propagated CodePen module import support into the docs examples pipeline.
• 6fff1a8 Hardened the UMD smoke test loader so missing bundles are reported clearly.
• 0f82c21 Silenced UMD smoke test favicon 404 noise.
• 6ce9e60 Added cache-busting for UMD test assets.
• 029396d Styled the QWindow UMD smoke-test panel so it renders as an intentional component check.
• 9c9a6f9 Fixed the embedded example toggle state.
• 69940a4 Improved resize handles demo behavior and presentation.
• f6f8ee2 Fixed resize demo start coordinates so top and top-right resizing no longer grows unexpectedly.

Docs and examples

• Added responsive window props documentation and examples.
• Simplified the scroll-with-window demo and clarified viewport-relative versus document-relative positioning.
• Added FAQ guidance for calculating start-x and start-y with and without scroll-with-window.
• Removed the duplicate API heading from the generated docs page.
• Removed legacy UMD smoke-test instructions from the test page.
• Added per-preset Try me! actions to the resize handles demo so each example is immediately discoverable.

Compatibility updates

• App extension compatibility: @quasar/app-vite >= 3.0.0-rc.3
• QWindow v3 remains Vite-only; webpack-based Quasar apps are not supported.
• Tooling/release requirements: Node.js >= 22.13 and pnpm >= 11.5.0.

Changelog

Changes since v3.0.0-rc.0:

• d74651d docs: clarify QWindow scroll positioning
• f339a24 fix: initialize QWindow scroll position
• f6f8ee2 docs: fix resize demo start coordinates
• 4798518 docs: put resize demo actions on preset cards
• d799988 docs: remove duplicate API heading
• 69940a4 fix: improve resize handles demo
• 1ca3cfe docs: expand resize handles demo
• ef2b31f docs: simplify scroll with window example
• 9c9a6f9 docs: fix embedded toggle state
• 0e25d0f fix(ui): preserve rounded window body corners
• a6d3f61 chore: prep QWindow rc.1 release dependencies
• 1371904 fix(docs): keep QWindow CodePens on published UMD
• a8d0059 feat(ui): add responsive QWindow props composable
• 029396d fix(ui): style the QWindow UMD smoke panel
• 6ce9e60 fix(ui): cache-bust UMD test assets
• a3c3c55 chore(ui): remove legacy UMD test notes
• 0f82c21 fix(ui): silence UMD smoke test favicon 404s
• 6fff1a8 fix(ui): harden UMD smoke test loading
• 0286ca4 refactor(ui): use Composition API in UMD tests
• a9214ba fix(docs): propagate CodePen module import support
• 5c13cdf chore: update md-plugins rc.4 deps
• 7e2f9bc chore: update app-vite rc.3 deps
• d08b8b9 Refresh UMD smoke test setup
• 35ccbda chore: update dependencies
• f68a9d4 chore: update Quasar RC dependencies

Installing

Use the normal package names. This RC is published through the latest npm tag.

$ pnpm add @quasar/quasar-ui-qwindow
# or
$ yarn add @quasar/quasar-ui-qwindow
# or
$ npm install @quasar/quasar-ui-qwindow
# or
$ bun add @quasar/quasar-ui-qwindow
# or
$ quasar ext add @quasar/qwindow

Documentation

QWindow documentation is hosted by Netlify. Visit the documentation for installation guidance, refreshed examples, and updated v3 setup instructions.

Donations

QWindow is an open-source MIT licensed project that has been made possible due to the generous contributions by sponsors and backers. If you are interested in supporting this project, please consider:

• Becoming a sponsor on Github
• One-off donation via PayPal

Full Changelog: v3.0.0-rc.0...v3.0.0-rc.1

v3.0.0-rc.0

Target branch: v3-beta

QWindow v3.0.0-rc.0

What's Changed

Highlights

• Promoted QWindow v3 to the RC release line for publication on the latest npm tag.
• Updated the Quasar baseline to quasar@^2.20.0 and @quasar/app-vite@3.0.0-rc.1.
• Aligned the docs site with the latest md-plugins/Q-Press RC releases, including SSG support and release-note link rendering fixes.
• Moved Q-Press docs build-time packages into devDependencies so generated docs dependencies do not inflate runtime dependency lists.
• Added latest-tag publish scripts and refreshed package metadata for the RC workflow.

Docs and examples

• Refreshed the landing page visuals and restored theme-token driven light/dark behavior.
• Added social preview metadata and a QWindow social preview image for link sharing.
• Standardized the README structure and install instructions across the workspace.
• Removed beta-only install guidance now that this RC is published through latest.
• Updated the docs footer, support links, and release note rendering.

Compatibility updates

• App extension compatibility: @quasar/app-vite >= 3.0.0-rc.1
• QWindow v3 remains Vite-only; webpack-based Quasar apps are not supported.
• Tooling/release requirements: Node.js >= 22.13 and pnpm >= 11.5.0.

Changelog

Changes since v3.0.0-beta.2:

• 5fdb1b0 chore: trigger v3-beta Netlify redeploy
• a16da84 chore: update Quasar app-vite to beta.38
• 77afc9b feat: refresh documentation footer
• 1561c41 chore: polish QWindow landing visuals
• 0329146 refine landing preview label
• 2386888 link urls in release notes
• 1391d95 chore: update md-plugins docs ssg
• cc838f9 chore: update app-vite beta.39 and deps
• 0f8ee69 chore: update app-vite beta.40
• a45d5fb chore: update md-plugins beta.24
• 8d9014a docs: fix support link rendering
• 144082e docs: remove landing theme fallback block
• 2a6908e chore: remove stale formatter directive
• 2bc9e04 chore: align app extension with app-vite beta.41
• ccec13f fix: restore landing page theme tokens
• 4d83ef6 chore: update app-vite beta.42
• 349bedb fix(docs): render strong text in api descriptions
• df9b89b chore(docs): update md-plugins beta.25
• ffc1e0a fix(docs): refresh md-plugins lockfile checksums
• 3cab85c chore(deps): update md-plugins beta.26
• 29693a9 chore: add latest publish script
• 69b7105 docs(qwindow): Add social preview image
• bef4e59 docs: add social preview metadata
• c5648cd build: rebuild package before packing
• 683e41b chore: update app-vite beta and dependencies
• 28f0017 chore: update md-plugins dependencies
• 5f5de94 chore: update app-vite and md-plugins
• 4b9b986 chore: refresh lockfile for CI
• d530129 chore: format docs package metadata
• 94f132a chore: update md-plugins to beta.29
• 3fb47d4 chore: dedupe pnpm release-age excludes
• 4faca07 chore: sort pnpm release-age excludes
• 2b9703c chore: update Quasar RC dependencies
• 9a17bd6 docs: standardize README structure section
• 7e1e533 chore: update md-plugins to rc.0
• bfd0217 chore: keep vite ssg plugin as dev dependency
• 5aec29c chore: move docs build deps to dev dependencies
• 4ad7390 chore: update md-plugins to rc.1
• 10316ce chore: update md-plugins to rc.2
• 8d278e3 chore: prepare QWindow rc.0 release

Installing

Use the normal package names. This RC is published through the latest npm tag.

$ pnpm add @quasar/quasar-ui-qwindow
# or
$ yarn add @quasar/quasar-ui-qwindow
# or
$ npm install @quasar/quasar-ui-qwindow
# or
$ bun add @quasar/quasar-ui-qwindow
# or
$ quasar ext add @quasar/qwindow

Documentation

QWindow documentation is hosted by Netlify. Visit the documentation for installation guidance, refreshed examples, and updated v3 setup instructions.

Donations

QWindow is an open-source MIT licensed project that has been made possible due to the generous contributions by sponsors and backers. If you are interested in supporting this project, please consider:

• Becoming a sponsor on Github
• One-off donation via PayPal

Full Changelog: v3.0.0-beta.2...v3.0.0-rc.0

v3.0.0-beta.2

Target branch: v3-beta

QWindow v3.0.0-beta.2

What's Changed

Highlights

• Compiled the app extension runtime and bumped the beta line for the compiled runtime path.
• Prepared and published the 3.0.0-beta.2 release updates.
• Synced docs and workspace updates for the current beta toolchain.
• Updated app-vite baseline to beta.35 and aligned app-extension peer target to beta.36.

Docs and examples

• Made the landing page theme-aware.
• Fixed docs 404 page theming.
• Clarified Quasar CLI wording and removed stale markdown plugin declarations.
• Added API inspection and stylesheet config docs, plus package-manager command tabs.
• Updated md-plugins/qPress integration and docs readability updates.

Compatibility updates

• App extension compatibility: @quasar/app-vite >= 3.0.0-beta.36
• QWindow v3 remains Vite-only; webpack-based Quasar apps are not supported.
• Tooling/release requirements: node >= 22.13 and pnpm >= 11.5.0

Changelog

Changes since v3.0.0-beta.0:

• 8fd8e0c chore: prepare 3.0.0-beta.2 release
• e881f34 chore: sync docs and beta.36 workspace updates
• d80b448 docs: make landing page theme-aware
• aa05ede fix: theme docs 404 page
• ec480d4 chore: remove stale markdown plugin declarations
• 85908ef docs: clarify Quasar CLI wording
• e2458c9 chore: update app-vite beta.35
• aa90d5c chore: bump beta for compiled ae runtime
• 520ab56 chore: compile app extension runtime
• 84deb53 chore: enable no-undef lint rule
• 33d710c docs: document API inspection command
• ddaece0 docs: document stylesheet config option
• 001f21e docs: tab package manager commands
• 2e779fc chore(docs): update md-plugins to beta 21
• 026aec8 fix(docs): keep code block lines left aligned
• 70e70b2 docs: update md-plugins integration
• 3b3bb1b chore: update qpress templates to beta 19
• 415d560 chore: add check all script
• ce08c8f docs: use sass color module in qpress styles
• 128ac9b docs: use newspaper qpress theme
• 5bee0f2 docs: make faq pages scannable
• c7c9c5a fix: indent release note lists
• e068ca1 chore: update release dependencies

Installing

Use the @beta tag while QWindow v3 remains in beta.

$ pnpm add @quasar/quasar-ui-qwindow@beta
# or
$ yarn add @quasar/quasar-ui-qwindow@beta
# or
$ npm install @quasar/quasar-ui-qwindow@beta
# or
$ bun add @quasar/quasar-ui-qwindow@beta
# or
$ quasar ext add @quasar/qwindow@beta

Remove the @beta tag once QWindow v3 is promoted to stable.

Documentation

QWindow documentation is hosted by Netlify. Visit the documentation for installation guidance, refreshed examples, and updated v3 beta setup instructions.

Donations

QWindow is an open-source MIT licensed project that has been made possible due to the generous contributions by sponsors and backers. If you are interested in supporting this project, please consider:

• Becoming a sponsor on Github
• One-off donation via PayPal

Full Changelog: v3.0.0-beta.0...v3.0.0-beta.2

v3.0.0-beta.0

Target branch: v3-beta

QWindow v3.0.0-beta.0

What's Changed

Features

• migrated QWindow to the v3 beta workspace structure with separate UI, app-extension, and docs packages
• added a v3 upgrade guide and refreshed install/docs content for the beta line
• added SSR render coverage and smoke-test oriented verification for the monorepo workflow

Fixes

• added QWindow-specific bar/window polish with tightened build summary sorting and release history wiring
• removed autoprefixer alignment warnings and renamed the release history component for the docs site

Build and tooling

• published the UI package with ESM-only package exports
• added stronger typecheck coverage for UI build scripts
• aligned the app-vite peer dependency floor and refreshed docs/build/release tooling
• added verify workflow coverage and updated md-plugins/release dependencies for the beta stack

Migration notes

• QWindow v3 is the first beta release for the Quasar CLI Vite 3 line
• the app extension is Vite-only and requires @quasar/app-vite >= 3.0.0-beta.30
• webpack-based Quasar apps are not supported on the v3 beta line
• development and release workflows require node >= 22.13 and pnpm >= 11.4.0

Installing

Use the @beta tag while QWindow v3 remains in beta.

$ pnpm add @quasar/quasar-ui-qwindow@beta
# or
$ yarn add @quasar/quasar-ui-qwindow@beta
# or
$ npm install @quasar/quasar-ui-qwindow@beta
# or
$ bun add @quasar/quasar-ui-qwindow@beta
# or
$ quasar ext add @quasar/qwindow@beta

Remove the @beta tag once QWindow v3 is promoted to stable.

Documentation

QWindow documentation is hosted by Netlify. Visit the documentation for installation guidance, refreshed examples, and updated v3 beta setup instructions.

Donations

QWindow is an open-source MIT licensed project that has been made possible due to the generous contributions by sponsors and backers. If you are interested in supporting this project, please consider:

• Becoming a sponsor on Github
• One-off donation via PayPal

Full Changelog: 1.0.0-beta.7...v3.0.0-beta.0

1.0.0-beta.7

• fix(ui): Scrolling breaks interaction (#21)

1.0.0-beta.6

• fix: issue with content-style property as string
• fix: issue using ESC to cancel a drag
• fix: QWindow selection selects all windows if stacked upon one another instead of only the first one (#20)

v1.0.0-beta.5

• fix: QWindow attaches to other window after selection upon dragging (#19)

This a critical fix. Please upgrade right away.

v1.0.0-beta.4

• fix(QWindow): SASS syntax error: ui/src/css/QWindow.sass (#18)
• feat(build): new typescript definitions
• fix(css): incorrect css applied to dark mode