# unipro

**Repository Path**: coderych/unipro

## Basic Information

- **Project Name**: unipro
- **Description**: `unipro` 是一个基于 [uni-app](https://uniapp.dcloud.net.cn/) + [Vite](https://vitejs.dev/) 的多端应用开发脚手架，支持 App（iOS/Android）、各类小程序（微信/支付宝/百度/字节等）、H5、快应用等平台。集成了现代前端工程化能力，助力高效开发、统一风格、快速迭代。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-06-19
- **Last Updated**: 2025-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# unipro

## 项目简介

`unipro` 是一个基于 [uni-app](https://uniapp.dcloud.net.cn/) + [Vite](https://vitejs.dev/) 的多端应用开发脚手架，支持 App（iOS/Android）、各类小程序（微信/支付宝/百度/字节等）、H5、快应用等平台。集成了现代前端工程化能力，助力高效开发、统一风格、快速迭代。

## 主要特性

- ⚡️ 基于 Vite 构建，极速开发体验
- 🛠 支持多端（App、小程序、H5、快应用）一套代码多端运行
- 🗂 页面自动生成与路由配置（`@uni-helper/vite-plugin-uni-pages`）
- 🧩 组件自动引入（`@uni-helper/vite-plugin-uni-components`）
- 🏗 支持多布局系统（如 home、default）
- 📝 TypeScript 全面支持
- 📦 Pinia 状态管理
- 🎨 集成 Sard-uniapp UI 组件库
- 🧩 Unocss 原子化 CSS
- 🔌 支持自动导入（vue、pinia、uni-app API）
- 🧰 丰富的开发脚本，支持多端本地/打包一键运行
- 🧑‍💻 代码风格统一，集成 Eslint、EditorConfig

## 目录结构

```
unipro/
├── build/                # 构建相关脚本
├── src/                  # 源码目录
│   ├── api/              # 接口请求
│   ├── components/       # 公共组件
│   ├── layouts/          # 页面布局
│   ├── pages/            # 页面文件
│   ├── stores/           # 状态管理
│   ├── styles/           # 样式文件
│   ├── utils/            # 工具函数
│   └── App.vue           # 应用入口
├── types/                # 类型定义
├── pages.config.ts       # 页面配置（自动生成）
├── manifest.config.ts    # manifest 配置（自动生成）
├── uno.config.ts         # Unocss 配置
├── vite.config.ts        # Vite 配置
├── tsconfig.json         # TypeScript 配置
├── package.json          # 项目依赖与脚本
└── README.md             # 项目说明
```

## 快速开始

### 安装依赖

建议使用 pnpm（也可用 npm/yarn）：

```bash
pnpm install
```

### 本地开发

支持多端开发，常用命令如下：

```bash
# H5 本地开发
pnpm dev:h5

# App 本地开发
pnpm dev:app

# 微信小程序开发
pnpm dev:mp-weixin

# 支持更多平台，详见 package.json scripts
```

### 打包构建

```bash
# H5 构建
pnpm build:h5

# App 构建
pnpm build:app

# 微信小程序构建
pnpm build:mp-weixin

# 其它平台同理
```

## 主要依赖

- `@dcloudio/uni-app`：多端框架
- `vite`：新一代前端构建工具
- `@uni-helper/vite-plugin-uni-pages`：页面自动生成
- `@uni-helper/vite-plugin-uni-manifest`：manifest 配置自动生成
- `@uni-helper/vite-plugin-uni-components`：组件自动引入
- `@uni-helper/vite-plugin-uni-layouts`：多布局支持
- `pinia`：状态管理
- `sard-uniapp`：UI 组件库
- `unocss`：原子化 CSS
- `typescript`：类型系统

## 约定式开发

- 页面、路由、manifest 配置均自动生成，无需手动维护
- 组件自动引入，无需 import
- 支持多布局（如首页、我的页面用 home 布局，协议页用 default 布局）
- 支持全局样式、主题变量自定义

## 代码规范

- 使用 TypeScript 进行类型约束
- 统一使用 Eslint 进行代码风格检查
- 推荐使用 VSCode + Volar 插件开发

## 贡献指南

1. Fork 本仓库
2. 新建分支进行开发
3. 提交 PR

## 常见问题

- 依赖安装失败：请优先使用 pnpm，或切换 npm 源为淘宝镜像
- 运行报错：请确保 Node.js 版本 >= 16，pnpm >= 7

## License

MIT