CloudBase Web 前端开发规范v1.0.0

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 为 CloudBase 生态下的 Web 前端项目提供完整开发规范，涵盖现代前端工程化实践与平台特有集成要求。它指导如何以 Vite 等工具搭建项目结构，通过 @cloudbase/js-sdk 接入数据库、云函数及认证服务，并正确部署至 CloudBase 静态托管。核心约束包括：强制使用 SDK 内置认证而非云函数实现登录、采用 hash 路由解决静态托管刷新 404 问题、构建输出配置相对路径以适配 CDN 未知路径环境。适用于需要快速交付可部署前端页面、或已有项目需接入 CloudBase 后端能力的场景。

技能包含

• SKILL.md（本文件）：技能主说明，含触发条件、项目结构约定、构建与部署流程、SDK 集成规范及常见错误规避

核心能力

• 项目结构规范：约定 src/ 源码目录、dist/ 构建输出、cloudfunctions/ 云函数目录，统一团队协作标准
• 现代构建配置：以 Vite 为默认推荐，要求先执行 npm install 再构建，确保依赖完整性
• 静态托管部署：支持本地预览（npx live-server）与 CloudBase CDN 部署，默认子目录部署、返回 Markdown 链接格式地址
• Web SDK 集成：通过 npm 或官方 CDN 引入 @cloudbase/js-sdk，同步初始化模式，复用单一 app/auth 实例
• 认证安全约束：强制使用 SDK 内置短信登录、匿名登录、自定义登录等能力，严禁在云函数中实现登录逻辑
• 路由与路径适配：默认 hash 路由规避刷新 404；publicPath 等配置必须使用相对路径，解决 CDN 资源加载异常

应用场景