Create Mapp

快速创建移动应用项目的脚手架工具，基于 ICS Mobile Framework 构建。

快速开始

使用你喜欢的包管理器创建新项目：

NPM

npm create mapp@latest

Yarn

yarn create mapp

PNPM

pnpm create mapp

Bun

bun create mapp

Deno

deno init --npm mapp

然后按照提示操作即可！

指定项目名称和模板

你也可以通过命令行选项直接指定项目名称和要使用的模板：

# npm 7+，需要额外的双横线：
npm create mapp@latest my-app -- --template vue-mui-ts

# yarn
yarn create mapp my-app --template vue-mui-ts

# pnpm
pnpm create mapp my-app --template vue-mui-ts

# bun
bun create mapp my-app --template vue-mui-ts

# deno
deno init --npm mapp my-app --template vue-mui-ts

命令行选项

用法: create-mapp [选项]... [目录]

选项:
  -h, --help                            显示帮助信息
  -t, --template NAME                   使用指定的模板
  -i, --immediate                       立即安装依赖并启动开发服务器
  --interactive / --no-interactive      强制使用交互式/非交互式模式

可用模板

目前支持以下模板：

| 模板名称 | 描述 | 技术栈 | |---------|------|--------| | vue-mui-ts | Vue3 + TypeScript + MUI 组件库 | Vue 3 + TypeScript + Vite + ICS MUI | | vue-app-ts | Vue3 + TypeScript 基础项目 | Vue 3 + TypeScript + Vite |

功能特性

• 🚀 快速创建 - 一条命令快速搭建项目骨架
• 📦 多种模板 - 提供多种预设模板供选择
• 🎨 交互式体验 - 友好的中文交互式命令行界面
• ⚡️ 即时启动 - 支持创建后立即安装依赖并启动开发服务器
• 🛠️ 灵活配置 - 支持覆盖已有文件或忽略冲突
• 📱 移动优先 - 专为移动应用开发优化

示例

交互式创建

pnpm create mapp

这将启动交互式模式，引导你完成以下步骤：

1. 输入项目名称
2. 处理目录冲突（如果存在）
3. 输入包名称（package.json）
4. 选择框架
5. 选择变体（TypeScript/JavaScript）
6. 选择是否立即安装依赖并启动

快速创建（非交互式）

# 创建一个名为 my-app 的 Vue3 + MUI 项目，立即安装依赖并启动
pnpm create mapp my-app --template vue-mui-ts --immediate

# 创建项目但不立即安装
pnpm create mapp my-app --template vue-app-ts

覆盖已有目录

pnpm create mapp my-app --overwrite

项目结构

创建的项目包含以下基本结构：

my-app/
├── src/              # 源代码目录
├── public/           # 静态资源目录
├── index.html        # HTML 入口文件
├── package.json      # 项目配置文件
├── vite.config.ts    # Vite 配置文件
├── tsconfig.json     # TypeScript 配置文件
└── README.md         # 项目说明文档

开发要求

• Node.js: ^20.19.0 || >=22.12.0
• 包管理器: npm、yarn、pnpm、bun 或 deno

与 create-vite 的区别

create-mapp 基于 create-vite 实现，但针对移动应用开发场景进行了定制：

• 专注于移动应用开发框架和模板
• 集成了 ICS Mobile Framework 相关依赖
• 提供了适合移动应用的项目结构
• 支持中文交互界面，更适合国内团队使用

许可证

ISC

相关链接

• ICS Mobile Framework
• Vite
• Vue.js