Movk Nuxt

快速开始

Movk Nuxt 是一个模块化的 Nuxt 4 工程套件，提供 Schema 驱动表单、API 集成、独立组件和通用工具函数

介绍

Movk Nuxt 是一个为 Nuxt 4 设计的模块化工程套件 (Modular Engineering Suite)。它采用分层架构设计，旨在通过高度抽象的自动化系统（如 AutoForm、API System）解决重复性工作，同时提供高质量的独立组件（如 DatePicker）和组合式函数以满足定制化需求。

构建在 Nuxt UI 之上，Movk Nuxt 遵循相同的设计原则：美观、可访问、开发者友好。

遵循渐进式采用原则——你可以只用它的日期处理工具，也可以只用它的 UI 组件，或者使用全自动化的 AutoForm 和 API System。

核心特性

模块化设计

按需使用。你可以只使用 UI 组件、日期工具函数，或者启用全套自动化系统。

自动化系统

AutoForm 通过 Schema 定义自动生成完整表单界面，API System 提供统一的请求和认证管理。

独立组件库

内置 DatePicker、WithCopy、StarRating 等 10+ 个通用 UI 组件，开箱即用。

通用工具函数

useDateFormatter、useApiFetch、useApiAuth 等高质量 composables，即使不使用自动化系统也可独立使用。

架构分层

Movk Nuxt 采用清晰的分层架构：

架构层级

Core Systems - AutoForm（Schema 驱动表单）
API System - useApiFetch、useApiAuth、useUploadWithProgress、useDownloadWithProgress（API 请求与认证）
Standalone Components - DatePicker、StarRating、WithCopy 等独立 UI 组件
Composables - useDateFormatter、useAutoForm 等通用组合式函数
Foundation - 基于 Nuxt UI、Zod v4、VueUse

核心模块

AutoForm - Schema 驱动的表单系统

基于 Zod Schema 的「定义即渲染」表单解决方案，支持 15+ 种控件类型、布局系统、依赖联动等高级特性。

深入了解 AutoForm 的核心概念和使用方法

API System - 统一的请求与认证

提供完整的 API 请求和认证方案，与 nuxt-auth-utils 无缝集成：

useApiFetch - 基于 useFetch 封装，支持自动认证、业务状态码检查、Toast 提示
useApiAuth - 登录、登出、Session 管理
useUploadWithProgress / useDownloadWithProgress - 带进度监控的文件上传下载

了解 API System 的使用方法

独立组件 - 开箱即用

无需依赖 AutoForm，可直接使用的高质量 UI 组件：

DatePicker - 基于国际化标准的日期选择器（单选/范围/多选）
WithCopy / WithClear / WithPasswordToggle - 输入增强组件
StarRating / ColorChooser - 交互组件

浏览所有可用组件

通用工具函数

useDateFormatter - 强大的日期格式化、解析、范围处理工具
useAutoForm - AutoForm 的核心逻辑封装

查看所有 Composables

开发路线图

已发布

✅ AutoForm - Schema 驱动的表单系统
✅ API System - API 请求封装和认证管理（useApiFetch、useApiAuth、useUploadWithProgress、useDownloadWithProgress）
✅ 独立组件库 - DatePicker、StarRating、WithCopy 等组件

安装

在 Nuxt 4 项目中安装和配置 Movk Nuxt 模块