# uni-start

**Repository Path**: jdy2002/uni-start

## Basic Information

- **Project Name**: uni-start
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-29
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uni-start

一个现代化的 UniApp 启动模板，旨在提供最佳的开发体验。

## ✨ 特性

- ⚡️ **Vue 3, Vite, pnpm, esbuild** - 极速的开发体验
- 🎨 **UnoCSS** - 高性能且灵活的原子化 CSS 引擎
- 📦 **组件自动导入** - 使用 `unplugin-auto-import` 和 `unplugin-vue-components` 自动导入 API 和组件
- 🛠️ **TypeScript** - 全量 TypeScript 支持
- 🍍 **Pinia** - 直观、类型安全的状态管理
- 💾 **Pinia Plugin Persistedstate** - 持久化存储 Pinia 状态
- 📡 **Alova** - 轻量级请求策略库
- 📄 **基于文件的路由** - 使用 `vite-plugin-uni-pages` 自动生成路由
- 🧩 **布局系统** - 使用 `vite-plugin-uni-layouts` 管理页面布局
- 🔍 **ESLint** - 代码规范与格式化
- 📲 **多端支持** - 支持微信小程序、H5、App 等多种平台

## 🛠️ 技术栈

- [Vue 3](https://vuejs.org/)
- [UniApp](https://uniapp.dcloud.net.cn/)
- [Vite](https://vitejs.dev/)
- [UnoCSS](https://unocss.dev/)
- [Pinia](https://pinia.vuejs.org/)
- [Alova](https://alova.js.org/)
- [uni-helper](https://github.com/uni-helper) 全家桶

## 🚀 快速开始

### 环境要求

- Node.js (推荐最新 LTS 版本)
- pnpm (推荐最新版本)

### 安装

```bash
# 安装依赖
pnpm install
```

### 开发

```bash
# 启动开发服务器
pnpm dev

# 开启特定平台开发 (例如微信小程序)
pnpm dev:mp-weixin
```

### 构建

```bash
# 构建生产版本
pnpm build

# 构建特定平台 (例如微信小程序)
pnpm build:mp-weixin
```

### 代码检查

```bash
# 运行 ESLint
pnpm lint

# 自动修复 ESLint 问题
pnpm lint:fix

# 运行类型检查
pnpm type-check
```

## 📂 目录结构

```
src/
├── api/            # API 接口
├── components/     # 公共组件
├── composables/    # 组合式函数
├── enums/          # 枚举
├── layouts/        # 页面布局
├── pages/          # 页面视图
├── stores/         # 状态管理 (Pinia)
├── types/          # 类型定义
├── utils/          # 工具函数
├── App.vue         # 应用入口
├── main.ts         # Vue 入口文件
├── manifest.json   # 应用配置
├── pages.json      # 页面配置 (由 vite-plugin-uni-pages 生成)
└── uni.scss        # UniApp 全局样式
```

## 📄 License

[MIT](./LICENSE) License © 2024-PRESENT