![\"@kolirt/vue-modal\"](\"https://raw.githubusercontent.com/kolirt/vue-modal/master/docs/public/logo.png\"){kind=logo}
\n\n \n
\n Open modals from any function, stack them as needed, and style them however you want.
\n No template boilerplate, no manual state — just call and await.\n
\n ![\"npm](\"https://img.shields.io/npm/v/@kolirt/vue-modal.svg?style=flat-square\")
\n ![\"npm](\"https://img.shields.io/npm/dm/@kolirt/vue-modal.svg?style=flat-square\")
\n ![\"license\"](\"https://img.shields.io/npm/l/@kolirt/vue-modal.svg?style=flat-square\")
\n ![\"Vue](\"https://img.shields.io/static/v1?label=Made%20with&message=VueJS&color=limegreen&style=flat-square&logo=vue.js\")
\n 📚 Documentation ·\n 🎮 Playground ·\n 🍳 Recipes\n
\n\n---\n\n## What you get\n\n`@kolirt/vue-modal` is a lightweight, headless modal package for Vue 3. It lets you open, stack, and control dialogs imperatively from any function — without registering modal components in templates or wiring open/close state by hand.\n\n- **Open from JS/TS** — trigger modals from any function and await the user's response. A single call returns a typed promise with full TypeScript inference for props and result.\n- **Less template boilerplate** — skip placing every modal in your templates and wiring open/close state by hand. Register one mount point and trigger any modal from code with a single call.\n- **Cascading modals** — open multiple modals one after another while preserving their state and context. Layer a confirmation on top of a form without losing the form's data.\n- **Highly customizable** — headless primitives with no imposed styles. Bring your own CSS, transitions, and animations — compose modals that fit any design system.\n- **Modal groups** — isolate flows with named groups — the main app stack, confirm dialogs, side panels — each rendering in its own mount point with its own queue.\n- **Async components** — open any Vue component, including async ones loaded on demand. Heavy modals stay out of your initial bundle and resolve through the same promise.\n\n## 🤖 For AI agents\n\nUsing an AI coding agent? See [`AGENTS.md`](./AGENTS.md) for a complete,\nde-styled reference plus a critical-rules checklist. The two most common agent\nmistakes are a missing `![\"Buy](\"https://cdn.buymeacoffee.com/buttons/v2/arial-yellow.png\")
\n\n\n## License\n\n[MIT](https://github.com/kolirt/vue-modal/blob/master/LICENSE)\n\n## Other packages\n\nCheck out my other projects on my [GitHub profile](https://github.com/kolirt).\n","readmeFilename":"README.md"}