Skip to content
/ mobvue Public template

📱 A crafted mobile template / vue mobile / vue h5 / vue vant / vue web app / 移动端最佳实践

License

Notifications You must be signed in to change notification settings

un-pany/mobvue

Repository files navigation

logo

Mobile + Vue = MobVue

github release github stars gitee stars

English | 中文

Introduction

MobVue is a well-crafted mobile web app template, built with popular technologies such as Vue3, Vite, TypeScript, and Vant

Notifications

Note

Powered by love! All source code is free and open-source. If you find it helpful, feel free to give a star to support!

Tip

Paid services are officially launched! If you don’t want to do it yourself but want to remove TS or other modules, try the lazy package! Click to check it out

Usage

Recommended Environment
  • Latest version of Visual Studio Code
  • Install the recommended plugins in the .vscode/extensions.json file
  • node 20.x or 22+
  • pnpm 9.x or 10+
Local Development
# Install dependencies
pnpm i

# Start the development server
pnpm dev
Build
# Build for the staging environment
pnpm build:staging

# Build for the production environment
pnpm build
Local Preview
# Execute the build command first to generate the dist directory, then run the preview command
pnpm preview
Code Check
# Code linting and formatting
pnpm lint

# Unit tests
pnpm test
Commit Guidelines

feat New feature

fix Bug fix

perf Performance improvement

refactor Code refactoring

docs Documentation and comments

types Type-related changes

test Unit tests related

ci Continuous integration, workflows

revert Revert changes

chore Chores (update dependencies, modify configurations, etc)

Links

Online Preview: github-pages

Documentation and Tutorials: link

Backend Management System: v3-admin-vite

Chinese Repository: gitee

Chat Group: check how to join

Donations: buy a coffee for the author

Releases & Changelog: releases

Features

🔥 Latest Syntax, Configuration, Dependencies

📍 Pure Level 1 Route Design - Clear and Cache-Friendly

📱 Mobile Adaptation px2vw - Also Wide-Screen Friendly

🌐 Browser Compatibility @vitejs/plugin-legacy + autoprefixer + browserslist - Compatible with multiple browsers and lower versions

🧩 Layout System - Configurable

🔒 Permission Control Page Level, Button Level

🌗 Theme Mode Dark Mode

🫧 Embrace Atomic CSS

🔧 Components and API Auto Import on Demand

🔎 Husky + lint-staged + ESLint - Code Standardization

💪🏻 Still TypeScript - Strict Mode with No any

👀 More Features - Route Cache, Defensive Watermark, Grayscale and Colorblind Mode, SVG Loader, VConsole, White Screen Loading Animation, Unit Tests

Tech Stack

Vue3: Vue3 + script setup with the latest Vue3 Composition API

Vant: A lightweight, customizable Vue UI library for mobile web apps

Pinia: The legendary Vuex5

Vite: Really fast

Vue Router: The routing system

TypeScript: A superset of JavaScript

pnpm: A faster, disk-space-saving package manager

ESlint: Code linting and formatting

Axios: Sends network requests

UnoCSS: A high-performance, flexible atomic CSS engine

Project Preview Image

preview

License

MIT License © 2025-PRESENT pany