UXTO CLI

UXTO UniApp 项目脚手架工具 - 支持 iOS、Android、鸿蒙多平台。

快速开始

使用 npx (推荐)

无需安装，直接创建项目：

# 创建项目
npx @atooyu/uxto-cli create my-app

# 或简写
npx uxto create my-app

全局安装

# 使用 pnpm
pnpm add -g @atooyu/uxto-cli

# 或使用 npm
npm install -g @atooyu/uxto-cli

# 创建项目
uxto create my-app

命令

创建项目

# 交互式创建
uxto create

# 直接指定项目名称
uxto create my-app

# 使用 init 别名
uxto init my-app

发布组件到 NPM

# 发布组件
uxto publish

# 指定发布范围 (公开包)
uxto publish --access public

# 指定标签 (如 beta, next)
uxto publish --tag beta

# 指定 registry
uxto publish --registry https://registry.npmjs.org/

# 模拟发布 (不实际执行)
uxto publish --dry-run

登录 NPM

uxto login

查看版本

uxto -v
uxto --version

查看更新记录

uxto changelog

生成的项目特性

• 基于 UniApp + Vue3 + TypeScript 构建
• 支持 iOS、Android、鸿蒙、H5、小程序多平台
• 集成 Pinia 状态管理
• 集成 UXTO 组件库 (@atooyu/uxto-ui)
• 内置 u-tabbar 底部导航组件
• 支持暗黑模式和灰色模式主题切换

开发命令

创建项目后：

pnpm install        # 安装依赖
pnpm dev:h5         # 运行 H5
pnpm dev:app        # 运行 App (iOS/Android)
pnpm dev:harmony    # 运行鸿蒙
pnpm dev:mp-weixin  # 运行微信小程序

项目结构

生成的项目结构：

my-app/
├── src/
│   ├── pages/          # 页面
│   │   ├── index/      # 首页
│   │   ├── components/ # 组件示例
│   │   ├── api/        # API 示例
│   │   ├── store/      # 状态管理
│   │   ├── utils/      # 工具类
│   │   └── tabbar/     # 底部导航示例
│   ├── stores/         # Pinia Store
│   │   ├── counter.ts
│   │   ├── user.ts
│   │   ├── cart.ts
│   │   └── theme.ts    # 主题状态 (暗黑/灰色模式)
│   ├── utils/          # 工具类
│   ├── assets/         # 静态资源
│   │   └── styles/     # 全局样式
│   ├── App.vue
│   ├── main.ts
│   └── pages.json
├── package.json
├── vite.config.js
└── tsconfig.json

使用 UXTO 组件库

生成的项目已集成 @atooyu/uxto-ui 组件库，可以直接使用：

<template>
  <!-- 底部导航 -->
  <u-tabbar
    v-model="activeTab"
    center-brand="U"
    center-label="UXTO"
    :left-tab="{ label: '首页', icon: '⌂', value: 'home' }"
    :center-tab="{ label: 'UXTO', icon: 'U', value: 'uxto' }"
    :right-tab="{ label: '我的', icon: '◉', value: 'mine' }"
    @tab-change="onTabChange"
  />

  <!-- 开关 -->
  <u-switch v-model="enabled" />

  <!-- 其他组件... -->
</template>

发布组件流程

1. 登录 NPM

uxto login

2. 确保组件已构建

# 在 uxto-ui 目录
npm run build:all

3. 发布

uxto publish --access public

相关项目

• uxto-ui - UXTO 组件库
• uxto-fronted - UXTO 前端脚手架模板 (CLI 模板来源)
  • template - 项目模板
  • example - 示例项目

CLI 通过 @atooyu/uxto-fronted 包获取模板，无需本地 template 目录。

License

MIT