vue-development-guides
Best practices and architectural patterns for Vue 3 and Nuxt 3 projects.
- Emphasizes core principles: predictable state with single source of truth, explicit data flow (props down, events up), and small focused components
- Requires Composition API with
<script setup lang="ts">as the default, and mandates following detailed guides for reactivity, SFC structure, and component organization - Provides a checklist-driven approach covering component splitting, composable extraction, and data flow patterns including props, emits, v-model, and provide/inject
- Includes references for state management, reactivity best practices, and SFC conventions to ensure consistency across Vue and Nuxt applications
Vue.js Development Guides
Tasks Checklist
- Followed the core principles
- Followed the defaults unless there is a good reason not to
- Followed the reactivity best practices
- Followed the component best practices
- Followed the Vue SFC best practices
- Kept components focused
- Split large components into smaller ones when needed
- Moved state/side effects into composables if applicable
- Followed data flow best practices
Core Principles
- Keep state predictable: one source of truth, derive everything else.
- Make data flow explicit: Props down, Events up for most cases.
More from hyf0/vue-skills
vue-best-practices
MUST be used for Vue.js tasks. Strongly recommends Composition API with `<script setup>` and TypeScript as the standard approach. Covers Vue 3, SSR, Volar, vue-tsc. Load for any Vue, .vue files, Vue Router, Pinia, or Vite with Vue work. ALWAYS use Composition API unless the project explicitly requires Options API.
21.4Kvue-debug-guides
Vue 3 debugging and error handling for runtime errors, warnings, async failures, and SSR/hydration issues. Use when diagnosing or fixing Vue issues.
13.1Kvue-pinia-best-practices
Pinia stores, state management patterns, store setup, and reactivity with stores.
1.9Kvue-router-best-practices
Vue Router 4 patterns, navigation guards, route params, and route-component lifecycle interactions.
1.8Kcreate-adaptable-composable
Create a library-grade Vue composable that accepts maybe-reactive inputs (MaybeRef / MaybeRefOrGetter) so callers can pass a plain value, ref, or getter. Normalize inputs with toValue()/toRef() inside reactive effects (watch/watchEffect) to keep behavior predictable and reactive. Use this skill when user asks for creating adaptable or reusable composables.
1.7Kvue-testing-best-practices
Use for Vue.js testing. Covers Vitest, Vue Test Utils, component testing, mocking, testing patterns, and Playwright for E2E testing.
1.5K