Vue NativeVue Native
Guide
Components
Composables
Navigation
  • iOS
  • Android
  • macOS
GitHub
Guide
Components
Composables
Navigation
  • iOS
  • Android
  • macOS
GitHub
  • Getting Started

    • Introduction
    • Installation
    • Your First App
    • Project Structure
  • Core Concepts

    • Components
    • Styling
    • Navigation
    • Native Modules
    • Native Code Blocks
    • Hot Reload
  • Advanced

    • Error Handling
    • Accessibility
    • TypeScript
    • Performance
    • Shared Element Transitions
    • Testing
    • Security
    • Debugging
    • Teleport
    • Forms and v-model
  • Integration Guides

    • State Management
    • Deep Linking & Universal Links
    • State Persistence
    • Push Notifications
    • Error Reporting & Monitoring
  • Tooling

    • Managed Workflow
    • VS Code Extension
    • Neovim Plugin
  • Building & Releasing

    • Building for Release
    • Deployment & App Store Submission
  • Reference

    • Migration & Upgrade Guide
    • Known Limitations & Platform Differences
    • Troubleshooting

Introduction

Vue Native lets you build real native iOS, Android, and macOS apps with Vue 3.

Unlike hybrid frameworks that render HTML in a WebView, Vue Native drives native UI components directly — UIKit on iOS, AppKit on macOS, and Android Views on Android. Your Vue components produce actual native views with native performance and look.

How it works

Vue Component (SFC)
      ↓  Vue custom renderer  (createRenderer)
  NativeBridge (TypeScript)
      ↓  JSON batch via queueMicrotask
      ├── iOS:     Swift → UIKit   → Yoga layout
      ├── macOS:   Swift → AppKit  → Yoga layout
      └── Android: Kotlin → Android Views → FlexboxLayout

The JavaScript engine runs your Vue app:

  • iOS — JavaScriptCore (built into the OS, zero download overhead)
  • macOS — JavaScriptCore (built into the OS, zero download overhead)
  • Android — V8 via J2V8

Key features

  • Vue 3 Composition API — ref, computed, watch, <script setup> all work as expected
  • Real native UI — No DOM, no WebView, no HTML
  • Cross-platform — One Vue codebase, iOS, Android, and macOS
  • 30+ built-in components — VView, VText, VButton, VInput, VList, and more
  • Native modules — Haptics, AsyncStorage, Camera, Geolocation, and more
  • Custom native code — Write Swift/Kotlin directly in Vue SFCs with <native> blocks
  • Navigation — Stack navigation via @thelacanians/vue-native-navigation
  • Hot reload — Edit Vue files, see changes instantly
  • TypeScript — Full type coverage

Next steps

  • Installation →
  • Your first app →
  • Native code blocks → - Write custom Swift/Kotlin code
Edit this page
Last Updated: 3/4/26, 7:12 PM
Contributors: Abdul Hamid, Claude Opus 4.6, Qwen-Coder
Next
Installation