mvframe-nuxt

Nuxt full-stack framework package inspired by mvframe.

This package is intentionally separate from the existing mvframe Vue/Vite library. It keeps mvframe stable while providing a Nuxt module path for full-stack app work: auto-registered UI components, composables, runtime config, and Nitro server handlers.

Install

yarn add mvframe-nuxt

export default defineNuxtConfig({
  modules: ["mvframe-nuxt"],
  mvframe: {
    config: {
      name: "My App",
      lang: "en_us",
      mode: "dark",
      theme: "glass",
      baseURL: "https://api.example.com",
    },
    server: {
      enabled: true,
      prefix: "/api/mvframe",
      proxy: {
        enabled: false,
        target: "",
        headers: {},
      },
    },
  },
});

Runtime Surface

• Components: MvPage, MvCard, MvTable, MvBtnGroup, MvList, MvNote, MvLoading, MvIcon
• Composables: useMvConfig, useMvRq, useMvGet, useMvPost, useMvNotify
• Server routes: /api/mvframe/health, /api/mvframe/config, /api/mvframe/proxy/**
• Theme defaults: mode: "dark" and theme: "glass"; the client plugin applies html.dark.mv-theme-glass.

Local Development

yarn install
yarn dev

The built-in demo lives in demo/ and mounts the local module from src/module.ts. yarn dev starts it at http://127.0.0.1:3600/.

The smaller playground from the initial scaffold remains available:

yarn dev:playground

Roadmap

• Port more mvframe components into Nuxt runtime components.
• Add schema-backed API handlers for auth, menu, dictionary, and mock data.
• Add a Nuxt-native request layer that maps mvframe Content-HI business codes.
• Decide whether to depend on mvframe directly or keep this package as a standalone Nuxt rewrite.