bestuni 1.0.0 → 2.0.0

package/.env

@@ -0,0 +1,7 @@
+# 环境变量
+
+# API 基础地址
+VITE_API_BASE_URL=
+
+# 应用标题
+VITE_APP_TITLE=SMT UniApp

package/.env.development

@@ -0,0 +1,4 @@
+# 开发环境
+
+VITE_API_BASE_URL=http://localhost:3000/api
+VITE_APP_TITLE=SMT UniApp (Dev)

package/.env.production

@@ -0,0 +1,4 @@
+# 生产环境
+
+VITE_API_BASE_URL=https://api.example.com
+VITE_APP_TITLE=SMT UniApp

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sumintong
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,131 @@
+# BestUni
+
+<p align="left">
+    <img src="https://img.shields.io/npm/v/bestuni.svg" alt="npm version">
+    <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+    <img src="https://img.shields.io/badge/vue-3.x-green.svg" alt="Vue">
+    <img src="https://img.shields.io/badge/uniapp-compatible-green.svg" alt="UniApp">
+</p>
+
+**BestUni** - 基于 **Vue 3 + TypeScript + Vite** 的 UniApp 快速启动模板。
+
+## ✨ 特性
+
+- 🚀 **Vue 3 + TypeScript** - 使用最新的 Vue 3 组合式 API
+- 📦 **Vite 5** - 极速冷启动与热更新
+- 🗃 **Pinia** - 状态管理 + 持久化存储
+- 🔐 **请求封装** - Token 自动注入、错误统一处理
+- 📱 **多端支持** - H5、微信小程序、支付宝小程序、App
+- 🎨 **主题定制** - 支持亮色/暗黑模式切换
+
+## 📦 安装
+
+```bash
+# 克隆模板
+npx degit sumintong/bestuni my-app
+
+# 或直接下载
+npm init bestuni my-app
+```
+
+## 📂 目录结构
+
+```
+src/
+├── composables/       # 组合式函数
+├── layouts/           # 布局组件
+├── pages/             # 页面目录
+│   ├── index/         # 首页
+│   └── mine/          # 我的
+├── stores/            # Pinia 状态管理
+│   ├── app.ts         # 应用状态
+│   ├── user.ts        # 用户状态
+│   └── index.ts
+├── styles/            # 全局样式
+│   ├── variables.scss # SCSS 变量
+│   └── index.scss     # 样式入口
+├── utils/             # 工具函数
+│   ├── request.ts     # 请求封装
+│   ├── router.ts      # 路由工具
+│   └── index.ts
+├── static/            # 静态资源
+├── App.vue            # 根组件
+├── main.ts            # 入口文件
+├── manifest.json      # 应用配置
+├── pages.json         # 页面配置
+└── uni.scss           # 全局样式变量
+```
+
+## 🚀 快速开始
+
+### 安装依赖
+
+```bash
+pnpm install
+```
+
+### 运行项目
+
+```bash
+# H5
+pnpm dev
+
+# 微信小程序
+pnpm dev:mp-weixin
+
+# App
+pnpm dev:app
+```
+
+### 打包发布
+
+```bash
+# H5
+pnpm build:h5
+
+# 微信小程序
+pnpm build:mp-weixin
+
+# App
+pnpm build:app
+```
+
+## 🗃 状态管理
+
+使用 Pinia 进行状态管理，已配置持久化存储：
+
+```typescript
+import { useUserStore } from '@/stores'
+
+const userStore = useUserStore()
+
+// 登录
+await userStore.login({ token: 'xxx', userInfo: { ... } })
+
+// 登出
+userStore.logout()
+```
+
+## 🔐 请求封装
+
+```typescript
+import { request, get, post } from '@/utils'
+
+// 基础请求
+const res = await request({ url: '/api/user', method: 'GET' })
+
+// 快捷方法
+const data = await get('/api/user')
+const result = await post('/api/login', { username: 'admin' })
+```
+
+## 🔗 相关链接
+
+- [UniApp 官网](https://uniapp.dcloud.net.cn/)
+- [Vue 3 文档](https://cn.vuejs.org/)
+- [Pinia 文档](https://pinia.vuejs.org/zh/)
+- [Vite 文档](https://cn.vitejs.dev/)
+
+## 📄 License
+
+MIT License © 2026 sumintong

package/package.json

@@ -1,15 +1,70 @@
-{
-  "name": "bestuni",
-  "version": "1.0.0",
-  "bin": {
-    "bestUNI": "./index.js"
-  },
-  "description": "",
-  "main": "index.js",
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  }
+{
+    "name": "bestuni",
+    "version": "2.0.0",
+    "description": "基于 Vue3 + TypeScript + Vite + UnoCSS 的 UniApp 快速启动模板，内置高颜值 UI 组件库",
+    "author": "sumintong",
+    "license": "MIT",
+    "keywords": [
+        "uniapp",
+        "vue3",
+        "typescript",
+        "vite",
+        "unocss",
+        "ui",
+        "template",
+        "mobile",
+        "wechat",
+        "miniprogram"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/sumintong/bestuni"
+    },
+    "homepage": "https://github.com/sumintong/bestuni#readme",
+    "scripts": {
+        "dev": "uni",
+        "dev:h5": "uni",
+        "dev:mp-weixin": "uni -p mp-weixin",
+        "dev:mp-alipay": "uni -p mp-alipay",
+        "dev:app": "uni -p app",
+        "build": "uni build",
+        "build:h5": "uni build",
+        "build:mp-weixin": "uni build -p mp-weixin",
+        "build:app": "uni build -p app",
+        "type-check": "vue-tsc --noEmit"
+    },
+    "files": [
+        "src",
+        "*.json",
+        "*.ts",
+        ".env*",
+        "README.md"
+    ],
+    "dependencies": {
+        "@dcloudio/uni-app": "3.0.0-4080420251103001",
+        "@dcloudio/uni-app-plus": "3.0.0-4080420251103001",
+        "@dcloudio/uni-components": "3.0.0-4080420251103001",
+        "@dcloudio/uni-h5": "3.0.0-4080420251103001",
+        "@dcloudio/uni-mp-weixin": "3.0.0-4080420251103001",
+        "@dcloudio/uni-mp-alipay": "3.0.0-4080420251103001",
+        "@sumintong/smt-ui": "^0.0.1",
+        "vue": "^3.4.21",
+        "pinia": "^2.1.7",
+        "pinia-plugin-persistedstate": "^3.2.1"
+    },
+    "devDependencies": {
+        "@dcloudio/types": "^3.4.8",
+        "@dcloudio/uni-cli-shared": "3.0.0-4080420251103001",
+        "@dcloudio/vite-plugin-uni": "3.0.0-4080420251103001",
+        "@iconify-json/carbon": "^1.1.0",
+        "@types/node": "^20.0.0",
+        "@unocss/preset-icons": "^0.58.0",
+        "typescript": "^5.0.0",
+        "unocss": "^0.58.0",
+        "unplugin-auto-import": "^0.17.0",
+        "unplugin-vue-components": "^0.26.0",
+        "vite": "^5.2.8",
+        "vue-tsc": "^2.0.0",
+        "sass": "^1.60.0"
+    }
 }

package/src/App.vue

@@ -0,0 +1,32 @@
+<template>
+  <mt-config-provider :theme="theme" :dark="isDark">
+    <slot />
+  </mt-config-provider>
+</template>
+
+<script setup lang="ts">
+const appStore = useAppStore()
+
+const isDark = computed(() => appStore.theme === 'dark')
+
+const theme = computed(() => ({
+  primaryColor: '#1989fa',
+  successColor: '#07c160',
+  warningColor: '#ff976a',
+  dangerColor: '#fa5151'
+}))
+
+onLaunch(() => {
+  console.log('App Launch')
+  appStore.initSystemInfo()
+})
+</script>
+
+<style lang="scss">
+/* 引入 UnoCSS 基础样式 */
+@import 'uno.css';
+/* 引入 UI 库样式 */
+@import '@sumintong/smt-ui/src/index.scss';
+/* 引入项目全局样式 */
+@import '@/styles/index.scss';
+</style>

package/src/env.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="vite/client" />
+/// <reference types="@dcloudio/types" />
+
+declare module '*.vue' {
+    import type { DefineComponent } from 'vue'
+    const component: DefineComponent<{}, {}, any>
+    export default component
+}
+
+interface ImportMetaEnv {
+    readonly VITE_API_BASE_URL: string
+    readonly VITE_APP_TITLE: string
+}
+
+interface ImportMeta {
+    readonly env: ImportMetaEnv
+}

package/src/main.ts

@@ -0,0 +1,17 @@
+import { createSSRApp } from 'vue'
+import { createPinia } from 'pinia'
+import piniaPluginPersistedstate from 'pinia-plugin-persistedstate'
+import App from './App.vue'
+
+export function createApp() {
+    const app = createSSRApp(App)
+
+    // 创建 Pinia 实例
+    const pinia = createPinia()
+    pinia.use(piniaPluginPersistedstate)
+    app.use(pinia)
+
+    return {
+        app
+    }
+}

package/src/manifest.json

@@ -0,0 +1,58 @@
+{
+    "name": "SMT UniApp",
+    "appid": "",
+    "description": "基于 Vue3 + TypeScript + @sumintong/smt-ui 的 UniApp 快速启动模板",
+    "versionName": "1.0.0",
+    "versionCode": "100",
+    "transformPx": false,
+    "h5": {
+        "title": "SMT UniApp",
+        "router": {
+            "mode": "hash",
+            "base": "./"
+        },
+        "optimization": {
+            "treeShaking": {
+                "enable": true
+            }
+        }
+    },
+    "mp-weixin": {
+        "appid": "",
+        "setting": {
+            "urlCheck": false,
+            "es6": true,
+            "minified": true
+        },
+        "usingComponents": true,
+        "optimization": {
+            "subPackages": true
+        }
+    },
+    "mp-alipay": {
+        "usingComponents": true
+    },
+    "app-plus": {
+        "usingComponents": true,
+        "nvueCompiler": "uni-app",
+        "compilerVersion": 3,
+        "splashscreen": {
+            "alwaysShowBeforeRender": true,
+            "waiting": true,
+            "autoclose": true,
+            "delay": 0
+        },
+        "modules": {},
+        "distribute": {
+            "android": {
+                "permissions": [
+                    "<uses-permission android:name=\"android.permission.INTERNET\"/>"
+                ]
+            },
+            "ios": {}
+        }
+    },
+    "uniStatistics": {
+        "enable": false
+    }
+}

package/src/pages/index/index.vue

@@ -0,0 +1,79 @@
+<template>
+  <view class="min-h-100vh pb-10">
+    <!-- 欢迎区域 -->
+    <view class="pt-20 pb-15 px-4 text-center bg-gradient-to-br from-primary to-[#6dd5fa] text-white">
+      <view class="text-14 font-bold mb-4">BestUni</view>
+      <view class="text-3 opacity-90">基于 Vue3 + TS + Vite + UnoCSS + SMT-UI</view>
+    </view>
+
+    <!-- 功能展示 -->
+    <view class="p-4">
+      <view class="text-4 font-bold mb-4 text-[#323233]">🧩 组件展示</view>
+      
+      <view class="card !m-0 !mb-4">
+        <view class="text-3.5 font-500 mb-4 text-[#323233]">Button 按钮 (Auto Import)</view>
+        <view class="flex flex-wrap gap-2">
+          <mt-button type="primary" size="small">主要按钮</mt-button>
+          <mt-button type="success" size="small">成功按钮</mt-button>
+          <mt-button type="warning" size="small">警告按钮</mt-button>
+          <mt-button type="danger" size="small">危险按钮</mt-button>
+        </view>
+      </view>
+
+      <view class="card !m-0 !mb-4">
+        <view class="text-3.5 font-500 mb-4 text-[#323233]">Cell 单元格</view>
+        <mt-cell-group inset>
+          <mt-cell title="自动路由" label="基于文件系统" is-link />
+          <mt-cell title="暗黑模式" label="支持一键切换" is-link />
+        </mt-cell-group>
+      </view>
+
+      <view class="card !m-0 !mb-4">
+        <view class="text-3.5 font-500 mb-4 text-[#323233]">UnoCSS 演示</view>
+        <view class="flex items-center gap-4">
+          <view class="w-12 h-12 bg-primary rd-full flex-center text-white">Uni</view>
+          <view class="w-12 h-12 bg-success rd-2 flex-center text-white">Vue</view>
+          <view class="w-12 h-12 bg-warning rd-lt-2 rd-rb-2 flex-center text-white">Vite</view>
+        </view>
+        <view class="mt-4 p-2 bg-gray-1 rd text-2.5 text-secondary">
+          上面三个方块使用了 UnoCSS 的原子化类名构建。
+        </view>
+      </view>
+    </view>
+
+    <!-- 主题切换 -->
+    <view class="card flex-between !mb-4">
+      <text class="text-3.5">当前模式: {{ isDark ? '深色' : '浅色' }}</text>
+      <mt-switch :model-value="isDark" @update:model-value="toggleTheme" />
+    </view>
+
+    <view class="px-4">
+      <mt-button @click="handleRequest" block type="primary" plain>测试接口请求</mt-button>
+    </view>
+  </view>
+</template>
+
+<script setup lang="ts">
+const appStore = useAppStore()
+
+const isDark = computed(() => appStore.isDark)
+
+const toggleTheme = () => {
+  appStore.toggleTheme()
+}
+
+const handleRequest = async () => {
+  try {
+    // 使用自动导入的 get 方法
+    const res = await get('/test')
+    console.log('请求结果:', res)
+    uni.showToast({ title: '请求成功', icon: 'success' })
+  } catch (err) {
+    uni.showToast({ title: '请求示例失败(未配接口)', icon: 'none' })
+  }
+}
+</script>
+
+<style lang="scss" scoped>
+// UnoCSS 处理了大部分样式，此处仅保留必要逻辑
+</style>

package/src/pages/mine/index.vue

@@ -0,0 +1,82 @@
+<template>
+  <view class="min-h-100vh bg-[#f7f8fa]">
+    <!-- 用户信息 -->
+    <view class="flex items-center p-8 bg-gradient-to-br from-primary to-[#6dd5fa] text-white">
+      <view class="mr-6">
+        <mt-avatar
+          :src="userInfo?.avatar || ''"
+          size="large"
+          round
+          custom-class="border-2 border-white/50"
+        >
+          {{ userInfo?.nickname?.charAt(0) || '游' }}
+        </mt-avatar>
+      </view>
+      <view class="flex-1">
+        <view class="text-4.5 font-bold mb-1">{{ userInfo?.nickname || '未登录用户' }}</view>
+        <view class="text-3 opacity-80">{{ isLoggedIn ? '已通过认证' : '点击头像登录体验更多功能' }}</view>
+      </view>
+    </view>
+
+    <!-- 功能列表 -->
+    <view class="mt-4">
+      <mt-cell-group inset title="账户设置">
+        <mt-cell title="个人资料" icon="user-o" is-link />
+        <mt-cell title="通知设置" icon="bell" is-link />
+        <mt-cell title="清除缓存" icon="delete-o" is-link @click="handleClearCache" />
+      </mt-cell-group>
+    </view>
+
+    <view class="mt-4">
+      <mt-cell-group inset title="关于">
+        <mt-cell title="版本信息" value="v2.1.0" icon="info-o" />
+        <mt-cell title="开源声明" icon="github-o" is-link />
+        <mt-cell title="加入我们" icon="friends-o" is-link />
+      </mt-cell-group>
+    </view>
+
+    <view v-if="isLoggedIn" class="mt-8 px-4">
+      <mt-button type="danger" block round @click="handleLogout">退出登录</mt-button>
+    </view>
+    
+    <view class="mt-10 pb-10 text-center text-2.5 text-gray-4">
+      BestUni & SMT-Design © 2026
+    </view>
+  </view>
+</template>
+
+<script setup lang="ts">
+const userStore = useUserStore()
+
+// 利用自动导入的 computed 和 stores
+const userInfo = computed(() => userStore.userInfo)
+const isLoggedIn = computed(() => userStore.isLoggedIn)
+
+const handleClearCache = () => {
+  uni.showModal({
+    title: '提示',
+    content: '确定要清除所有本地数据吗？',
+    success: (res) => {
+      if (res.confirm) {
+        uni.clearStorageSync()
+        uni.showToast({ title: '清理完成', icon: 'success' })
+      }
+    }
+  })
+}
+
+const handleLogout = () => {
+  uni.showModal({
+    title: '确认退出',
+    content: '退出后需要重新验证身份',
+    success: (res) => {
+      if (res.confirm) {
+        userStore.logout()
+      }
+    }
+  })
+}
+</script>
+
+<style lang="scss" scoped>
+</style>

package/src/pages.json

@@ -0,0 +1,44 @@
+{
+    "pages": [
+        {
+            "path": "pages/index/index",
+            "style": {
+                "navigationBarTitleText": "首页"
+            }
+        },
+        {
+            "path": "pages/mine/index",
+            "style": {
+                "navigationBarTitleText": "我的"
+            }
+        }
+    ],
+    "tabBar": {
+        "color": "#999999",
+        "selectedColor": "#1989fa",
+        "backgroundColor": "#ffffff",
+        "borderStyle": "black",
+        "list": [
+            {
+                "pagePath": "pages/index/index",
+                "text": "首页"
+            },
+            {
+                "pagePath": "pages/mine/index",
+                "text": "我的"
+            }
+        ]
+    },
+    "easycom": {
+        "autoscan": true,
+        "custom": {
+            "^mt-(.*)": "@sumintong/smt-ui/src/components/$1/$1.vue"
+        }
+    },
+    "globalStyle": {
+        "navigationBarTextStyle": "black",
+        "navigationBarTitleText": "SMT UniApp",
+        "navigationBarBackgroundColor": "#ffffff",
+        "backgroundColor": "#f5f5f5"
+    }
+}

package/src/stores/app.ts

@@ -0,0 +1,60 @@
+import { defineStore } from 'pinia'
+import { ref, computed } from 'vue'
+
+export const useAppStore = defineStore('app', () => {
+    // 主题模式
+    const theme = ref<'light' | 'dark'>('light')
+
+    // 系统信息
+    const systemInfo = ref<UniApp.GetSystemInfoResult | null>(null)
+
+    // 是否暗黑模式
+    const isDark = computed(() => theme.value === 'dark')
+
+    // 切换主题
+    const toggleTheme = () => {
+        theme.value = theme.value === 'light' ? 'dark' : 'light'
+    }
+
+    // 设置主题
+    const setTheme = (value: 'light' | 'dark') => {
+        theme.value = value
+    }
+
+    // 初始化系统信息
+    const initSystemInfo = () => {
+        uni.getSystemInfo({
+            success: (res) => {
+                systemInfo.value = res
+            }
+        })
+    }
+
+    // 安全区域
+    const safeAreaInsets = computed(() => {
+        if (!systemInfo.value) return { top: 0, bottom: 0 }
+        return {
+            top: systemInfo.value.safeAreaInsets?.top || 0,
+            bottom: systemInfo.value.safeAreaInsets?.bottom || 0
+        }
+    })
+
+    return {
+        theme,
+        systemInfo,
+        isDark,
+        safeAreaInsets,
+        toggleTheme,
+        setTheme,
+        initSystemInfo
+    }
+}, {
+    persist: {
+        key: 'smt-app',
+        storage: {
+            getItem: (key) => uni.getStorageSync(key),
+            setItem: (key, value) => uni.setStorageSync(key, value)
+        },
+        pick: ['theme']
+    }
+})

package/src/stores/index.ts

@@ -0,0 +1,2 @@
+export { useAppStore } from './app'
+export { useUserStore } from './user'