Skip to content

基于Vite+Vue3+Ts+Vant4+Tailwind CSS+Axios+rem适配+Font Awesome的H5移动端项目模板

License

Notifications You must be signed in to change notification settings

EnigmaGuest/vvts-h5

Repository files navigation

vite vue3 pinia Ts vant4 tailwindcss axios rem适配 fontawesome的H5移动端项目模板

这是一个基于vite+vue3+pinia+Ts+vant4+tailwindcss+axios+rem适配+fontawesome的H5移动端项目模板。

特性

  • 使用Vite作为项目构建工具,提供快速的开发环境和生产优化
  • 使用Vue3作为主要框架,享受其更好的性能和新功能
  • 使用TypeScript进行开发,提供更好的代码提示和错误检查
  • 集成Vant4作为UI组件库,拥有丰富的移动端组件
  • 使用Tailwind CSS作为样式框架,提供快速构建和自定义样式
  • 集成Axios作为HTTP库,方便进行API请求和数据交互
  • 使用rem适配方案,实现移动端页面的响应式布局
  • 集成FontAwesome作为图标库,拥有丰富的图标资源
  • 写路由如同uni-app的page.json

使用方法

1. 克隆项目模板

git clone git@github.com:EnigmaGuest/vvts-h5.git
cd vvts-h5

2. 安装依赖

npm install

3. 运行开发环境

npm run dev

4. 构建生产版本

npm run build

5. 更多配置

项目模板的配置文件位于src/config/index.ts,你可以根据自己的需求进行相应的修改。

目录结构

├── .gitignore                   # Git忽略文件配置
├── index.html                   # 入口HTML文件
├── package.json                 # 项目配置文件
├── build                        # 打包以及编译用到的插件
├── README.md                    # 项目介绍文件
├── src                          # 源代码目录
│   ├── assets                   # 静态资源目录
│   ├── components               # 公共组件目录
│   ├── config                   # 配置文件目录
│   ├── main.ts                  # 项目入口文件
│   ├── layouts                  # 布局组件
│   ├── hooks                    # 组合式的函数hooks(状态从函数里面产生)
│   ├── store                    # piana状态管理
│   ├── router                   # vue路由
│   ├── service                  # 网络请求
│   ├── styles                   # 样式文件目录
│   ├── tab-bar                  # 底部导航栏配置
│   ├── typings                  # TS类型声明文件(*.d.ts)
│   ├── utils                    # 全局工具函数
│   └── views                    # 视图目录
└── vite.config.js               # Vite配置文件
└── tailwind.config.js           # tailwind配置文件
└── postcss.config.js            # postcss配置文件

路由使用

// 路由统一配置再router/index.ts中
// 和vueRouter基本相同,唯一不同的是meta
// 详细查看typings/route.d.ts
let pageRoutes: PageRoute[] = [
    {
        path: "/",
        redirect: "/home"
    },
    {
        name: "home",
        path: "/home",
        component: () => import("../views/HomeView.vue"),
        meta: {title: "首页", navigationStyle: "default", backgroundColor: "#fff", textColor: "dark"}
    },
    {
        name: "about",
        path: "/about",
        component: () => import("../views/AboutView.vue"),
        meta: {title: "关于", navigationStyle: "default", backgroundColor: "#fff", textColor: "dark"}
    }
]

底部导航使用

// 底部导航栏统一配置再tab-bar/index.ts中
// 需要注意的是,底部导航栏的页面必须在pageRoutes中注册
// path必须再pageRoutes中注册
export const tabBarRoutes: TabBarRoute[] = [
    {
        path: "/home",
        text: "首页",
        icon: "solar:home",
    },
    {
        path: "/about",
        text: "关于",
        icon: "solar:account",
    }
]

开发进度

  • 基本项目结构 vue全家桶
  • 集成Axios
  • 集成Vant
  • 路由管理,一键配置顶部导航栏和底部导航栏
  • 集成Tailwind CSS
  • 集成Font Awesome
  • 集成rem适配方案
  • 页面模版

项目截图

home.png icon.png echarts.png

贡献

如果你对该项目有任何建议或改进,请随时提出。同时欢迎提交Pull Request,一起使该项目变得更好。

许可证

该项目基于MIT许可证进行分发和使用,更多信息请参阅LICENSE文件。

About

基于Vite+Vue3+Ts+Vant4+Tailwind CSS+Axios+rem适配+Font Awesome的H5移动端项目模板

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published