Skip to content

badhope/Aboard

 
 

Repository files navigation

Aboard

Aboard

一个面向课堂、演示与触控大屏场景的轻量网页白板。它尽量保持部署简单、上手直接、功能实用,适合“打开即用”和继续二次开发两种使用方式。

摘要

大一小登的AI-Agent项目,目标是想做一个功能简单、部署简单,使用极其简单且符合直觉的白板,主要是为国内的初高中一体机教学使用设计

由于本人实际开发能力薄弱,所以本项目大量运用了AI-Agent技术(就是调用GitHub Agent功能来帮助我开发和高效推进功能的实现),所以代码可能没有“人味”,也可能存在相当多不合理的bug和开发方式望大佬您轻喷

您可以在下面的Demo链接中快速体验本项目,也可以前往我的博客看看我做这个项目的前因后果。

如果大佬您觉得好的话,请给我点个star🌟吧~~~大学生真的很需要这个

特色概览

  • 常用白板能力齐全:画笔、形状、橡皮、背景、插图、插字、选择编辑。
  • 课堂辅助功能完整:时间显示、计时器、随机点名、计分板、教具等。
  • 体验偏向真实教学场景:分页画布、自动保存恢复、PWA、多语言、配置导入导出。
  • 高倍率缩放时会自动切换到 SVG 矢量预览,让文字、图片、笔迹与形状在放大查看时更清晰。
  • 默认缩放上限已提升到 1000%,需要更高倍率时仍可开启“允许无限放大”。
  • 响应式与触控做了专门优化。
graph LR
    A[Aboard Project]
    A --> D[在线Demo]
    A --> E[博客文章]
    
    click D "https://aboard.pp.ua" "在线演示"
    click E "https://66619.eu.org/article/aboard" "技术文章"
Loading

当前分支和部署版本

graph LR
    A[Aboard Project]
    A --> B[main分支]
    A --> C[dev/preview分支]
    A --> D[dev/stable分支]
    A --> E[copilot/xxx分支]
    B --> F[branch Demo/主版本]
    C --> G[branch Demo/最新测试版]
    D --> H[branch Demo/稳定测试版]
    E --> I[PR中Vercel提供临时链接]

    click F "https://aboard.pp.ua" "主"
    click G "https://dev-aboard.619.pp.ua" "最新测试"
    click H "https://dev.aboard.pp.ua" "最新测试"
Loading

功能预览

主界面
功能:主界面
时间与计时功能
功能:时间与计时功能
设置面板
功能:设置面板
教具功能
功能:教具功能
其他工具
功能:其他工具
公告功能
功能:公告功能

快速开始

  • 在线体验:https://aboard.pp.ua
  • 本地运行:npm startnode server.js
  • 访问地址:http://localhost:8080
  • 注意:不要直接双击 index.html,部分多语言、帮助与版本检查功能依赖 HTTP 环境。

文档导航

响应式与触控说明

  • 项目默认按触控优先设计,主要交互按钮尽量维持不少于 44px 的可触达面积。
  • 在 1366×768、1920×1080、2K、4K 以及浏览器缩放后的窗口中,工具栏、历史栏、浮动面板、编辑叠加控件都会优先保证可见与可操作。
  • 对于特别小的图片、文字框、选区或笔迹对象,控件会自动重排,必要时缩小但保留最小下限,尽量避免漂到对象外太远。
  • 如果你继续二开,建议优先复用现有响应式变量、媒体查询和 data-i18n-* 机制,不要再写固定像素的绝对布局。

仓库结构

  • index.html:主界面与静态结构。
  • js/main.js:应用主控制器与事件编排。
  • js/modules/:时间、计时器、教具、设置、存储、PWA、i18n 等模块。
  • css/style.csscss/modules/:主样式与分模块样式。
  • server.js / sw.js:本地服务、版本接口与离线缓存。

部署

部署到 Vercel

Deploy with Vercel

部署到 GitHub Pages

  1. Fork 本仓库到你的 GitHub 账号
  2. 进入仓库设置 (Settings)
  3. 在 Pages 选项中,选择 Source 为 main 分支
  4. 点击 Save,等待部署完成
  5. 访问 https://你的用户名.github.io/Aboard

部署到 Cloudflare Pages

Deploy to Cloudflare Pages

🌟 致谢

感谢所有贡献者和使用者!如果这个项目对您有帮助,欢迎给个Star⭐,这样就对我很有帮助了

Star History

Star History Chart


Made with ❤️ for educators and creators

About

一个简约的web白板,更适合老师体质 | Just a board.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 84.2%
  • CSS 8.4%
  • HTML 7.4%