README.md

August 21, 2025 · View on GitHub

📖中文文档 || 📖English Docs | README(en) || 论坛/社区 || DeepWiki || zread

鲁班 H5

可视化搭建,拖拽生成移动端页面

Mobile Page Builder&Generator with Drag&Drop

PRs Welcome Docs Release Gitter GitHub issues GitHub stars 码云

目录

鲁班H5是什么?

  1. 鲁班H5是基于Vue2.0开发、通过拖拽快速生成页面的平台
  2. 类似 易企秀Maka百度 H5 等平台

Demo

在线访问地址

源码文档教程社区
GitHub中文文档视频-快速开始(哔哩哔哩)论坛/社区(官方推荐)
Gitee (国内镜像)English Docs自定义组件教程(WIP)Gitter
README(En)核心实现原理中文社区/论坛(腾讯吐个槽)

🔗生态

后端集成官方组件库支撑/辅助组件自定义组件RoadMap
Strapi.js (官方后端API)轮播图图片库自定义组件开发脚手架RoadMap/开发计划
SpringBoot2-JPA普通按钮文本对齐自定义组件开发教程
SpringBoot2-Mybatis-plus视频教程(WIP)

快速体验

以下方式,任选其中一种即可

一、一键脚本(推荐!)

git clone https://github.com/ly525/luban-h5 && cd luban-h5
# 安装依赖,构建前后端(安装依赖会耗时略长,请耐心等待)
# 如果您遇到 sqlite3、node-gpy 等安装报错问题,请您执行 ./deploy/mirror.sh 配置npm 镜像为阿里云镜像(特别是为了解决二进制包安装问题)
./luban-h5.sh init

# 启动项目访问 http://localhost:1337 即可
./luban-h5.sh start

# ./luban-h5.sh stop

二、本地安装了 Node、Yarn

git clone https://github.com/ly525/luban-h5
cd luban-h5 # 项目根目录

# 后端
cd back-end/h5-api && yarn && yarn dev

# 前端
# 新开一个终端,在项目根目录执行如下命令
cd front-end/h5 && yarn && yarn build:engine && yarn dev

# 启动项目访问 http://localhost:1337 即可

交流群

钉钉群微信公众号微信

请备注:鲁班H5交流

更多细节请阅读在线文档

Features

  1. 编辑器

    • 参考线
    • 吸附线、组件对齐
    • 拖拽改变组件形状
    • 元素: 复制(画布)
    • 元素: 删除(画布)
    • 元素: 编辑(画布)
    • 页面:新增
    • 页面:复制
    • 页面:删除
    • 快速预览
    • 撤销、重做
  2. 组件系统

    • 文字
    • 普通按钮
    • 表单按钮
    • 表单输入框
    • 普通图片
    • 背景图
    • 背景音乐
    • 视频(Iframe形式)
  3. 增强功能

    • 上传 PSD,一键转换为 H5(已经调研,可以实现)
    • 图片库
    • 第三方无版权图片搜索
    • 自定义脚本(已经调研,可以实现)
  4. 后端 API

    • 创建、保存、更新作品
    • 表单数据收集
    • 表单数据展示
    • 在线预览
    • 二维码预览

技术栈(当前)

  1. 前端:Vue.js
  2. 后端:Strapi
  3. 存储:Sqlite

如何贡献

所有合理的改动、优化、修正,新的组件,或者文档的修正、更新 相关的提交都会被接受

捐赠作者

如果你觉得这个项目对你有用或者有所启发,可以请作者喝杯果汁:

微信捐赠支付宝捐赠