@ionic/vue

@ionic/vue

Ionic Framework integration for Vue 3 apps.

Building

• Install dependencies in @ionic/core:

cd core && npm install

• Build @ionic/core. This will generate Vue component bindings in the packages/vue directory:

npm run build

• Install dependencies in @ionic/vue:

cd packages/vue && npm install

• Build @ionic/vue:

npm run build

• Install dependencies in @ionic/vue-router:

cd packages/vue-router && npm install

• Build @ionic/vue-router:

npm run build

Tests

• E2E Tests are found in the packages/vue/test/base/tests directory and use Cypress.
• When making changes to @ionic/vue or @ionic/vue-router you can run npm run sync in the test-app directory to ensure that the test application is using your built changes. Be sure to build in the vue and vue-router directories first.
• Tests can be run in headless mode by running npm run cypress.
• If you want to open the Cypress test runner, you can run node_modules/.bin/cypress open.
• Bug fix and feature PRs should have new tests verifying the PR functionality.

Contributing

See our Contributing Guide.

Need Help?

Post your question on the Ionic Forum.

Changelog

8.6.0 (2025-06-04)

Bug Fixes

• input-otp: correctly handle autofill by splitting the values into all inputs (#30444) (b77447b)
• scroll-assist: allow focus on input's siblings (#30409) (2dea607)

Features

• datetime: add animation to adjacent days selection (#30298) (e140b90)
• datetime: add showAdjacentDays to display days from the previous and next months (#30262) (b67259e)
• input-otp: add new input-otp component (#30386) (4d6a067)
• toggle: add iOS 18 haptic feedback (#29945) (796e007)