Engineering
nuxt avatar

nuxt

Nuxt framework disambiguation layer for optimizing project development, routing to the correct Nuxt pack, Vue guidance, or module-specific logic.

Introduction

This skill acts as a central decision engine for Nuxt-based project maintenance, specifically designed for the nuxt-convex monorepo. It manages the complex landscape of framework-level decisions, helping developers avoid generic or anti-pattern implementation choices by routing tasks to the most appropriate abstraction layer. Whether the task involves server-side rendering (SSR), page metadata, layout transitions, or deep module integration, this skill ensures that the Nuxt-native way is applied before falling back to manual Vue logic or custom HTML structures.

  • Streamlined routing to specialized Nuxt packs for SSR, data fetching, and page-meta configuration.

  • Automated enforcement of Nuxt-native abstractions over raw Vue or manual DOM manipulation.

  • Context-aware routing for module authoring, including hook management and runtime extension scaffolding.

  • Specific guidance for integrating Convex-related real-time features within a Nuxt environment, balancing server-side security and client-side reactivity.

  • Intelligent fallback mechanisms that prioritize Nuxt Content and Nuxt UI primitives for standard UI surfaces.

  • Always inspect the component, route, or module surface before beginning implementation.

  • Follow the hierarchical precedence: Repository-global rules > Nuxt packs > Vue Best Practices > Module delta-rules.

  • Use useFetch or useAsyncData for route-driven data to prevent hydration mismatches.

  • Prefer definePageMeta and useSeoMeta for routing and document-head management.

  • Isolate browser-only APIs and environment variables behind Nuxt-compliant boundaries (ClientOnly, server-side config).

  • The skill assumes full ownership of the playground subtree; users must explicitly trigger scope changes for external repository files.

Repository Stats

Stars
19
Forks
1
Open Issues
0
Language
TypeScript
Default Branch
main
Sync Status
Idle
Last Synced
May 3, 2026, 10:56 PM
View on GitHub