inertia-vue-development

Inertia Vue Development

When to Apply

Activate this skill when:

• Creating or modifying Vue page components for Inertia
• Working with forms in Vue (using router.post)
• Implementing client-side navigation with <Link> or router
• Building Vue-specific features with the Inertia protocol

Documentation

Use search-docs for detailed Inertia v1 Vue patterns and documentation.

Basic Usage

Page Components Location

Vue page components should be placed in the resources/js/Pages directory.

Page Component Structure

Important: Vue components must have a single root element.

<code-snippet name="Basic Vue Page Component" lang="vue"> <script setup> defineProps({ users: Array }) </script> <template> <div> <h1>Users</h1> <ul> <li v-for="user in users" :key="user.id"> {{ user.name }} </li> </ul> </div> </template> </code-snippet>

Client-Side Navigation

Basic Link Component

Use <Link> for client-side navigation instead of traditional <a> tags:

<code-snippet name="Inertia Vue Navigation" lang="vue"> <script setup> import { Link } from '@inertiajs/vue3' </script> <template> <div> <Link href="/">Home</Link> <Link href="/users">Users</Link> <Link :href="`/users/${user.id}`">View User</Link> </div> </template> </code-snippet>

Link With Method

<code-snippet name="Link With POST Method" lang="vue"> <script setup> import { Link } from '@inertiajs/vue3' </script> <template> <Link href="/logout" method="post" as="button"> Logout </Link> </template> </code-snippet>

Programmatic Navigation

<code-snippet name="Router Visit" lang="vue"> <script setup> import { router } from '@inertiajs/vue3' function handleClick() { router.visit('/users') } // Or with options function createUser() { router.visit('/users', { method: 'post', data: { name: 'John' }, onSuccess: () => console.log('Success!'), }) } </script> </code-snippet>

Form Handling

Using router.post

<code-snippet name="Form with router.post" lang="vue"> <script setup> import { router } from '@inertiajs/vue3' import { reactive, ref } from 'vue' const form = reactive({ name: '', email: '', }) const processing = ref(false) function handleSubmit() { processing.value = true router.post('/users', form, { onFinish: () => processing.value = false, }) } </script> <template> <form @submit.prevent="handleSubmit"> <input type="text" v-model="form.name" /> <input type="email" v-model="form.email" /> <button type="submit" :disabled="processing"> Create User </button> </form> </template> </code-snippet>

Inertia v1 Limitations

Inertia v1 does not support these v2 features:

• <Form> component
• Deferred props
• Prefetching
• Polling
• Infinite scrolling with WhenVisible
• Merging props

Do not use these features in v1 projects.

Server-Side Patterns

Server-side patterns (Inertia::render, props, middleware) are covered in inertia-laravel guidelines.

Common Pitfalls

• Using traditional <a> links instead of Inertia's <Link> component (breaks SPA behavior)
• Using multiple root elements in Vue components (while Vue 3 supports this, a single root is recommended for Inertia v1 compatibility)
• Trying to use Inertia v2 features (deferred props, <Form> component, etc.) in v1 projects
• Using <form> without preventing default submission (use @submit.prevent)
• Not handling loading states during form submission