快速开始

环境要求

在开始之前,请确保你的开发环境满足以下要求:

  • Node.js: 版本 18 或更高版本
  • 包管理器: npm、yarn、pnpm 或 bun

创建 BubblesJS 项目

使用 create-bubbles 脚手架工具来创建一个新项目:

npm
yarn
pnpm
bun
npm create bubbles@latest my-project

选择模板

运行命令后,会出现交互式提示,让你选择:

  1. 框架选择: React 或 Vue
  2. 构建工具: Rsbuild(推荐)或 Rolldown(实验性)
  3. 代码检查: Biome 或 Oxc
  4. 项目名称: 输入你的项目名称

启动开发服务器

创建完成后,进入项目目录并启动开发服务器:

cd my-project
npm
yarn
pnpm
bun
# 安装依赖
npm install

# 启动开发服务器
npm run dev

现在你可以在浏览器中访问 http://localhost:3000 查看你的应用!

项目结构

创建的项目包含以下核心文件和目录:

my-project/ ├── src/ # 源代码目录 │ ├── App.tsx # 主应用组件 │ └── main.tsx # 应用入口 ├── public/ # 静态资源 ├── package.json # 项目配置 └── rsbuild.config.ts # 构建配置

下一步

  • 📖 查看 包管理 了解可用的工具包
  • 🎨 查看 模板 了解不同的项目模板
  • 🛠️ 查看 API 了解详细的 API 文档