Documentation

快速开始

VibeAny 快速上手指南

VibeAny 是一个现代化的 AI 开发脚手架,基于 Next.js 构建,内置用户系统、AI 能力、支付与管理后台,帮助你更快把想法上线。

前提条件(开始前,先准备好这些)

1. Node.js

Node.js 是一个运行时环境,用来在本地执行 JavaScript 代码。 如果未安装, mac 用户可以使用 brew 安装:

brew install node

或者请前往 Node.js 官方网站 下载 LTS 版本。

安装成功后使用该命令行工具查看版本号,如果显示版本号,则安装成功(建议版本在v20.19.0以上):

node --version

2. Git

Git 是版本控制工具,用来跟踪代码历史、协作开发。

mac 用户可以安装 xcode,( git 是 xcode 的一部分,安装 xcode 会自动安装 git)

或者前往 Git 官方网站 下载。

git --version

3. 软件包管理器(Package Manager)

用来安装依赖。我们推荐 pnpm,也可以使用 npmbunyarn

# 使用 npm 安装 pnpm
npm install -g pnpm
# 查看版本号
pnpm -v

小贴士:如果您需要一个好用的终端界面,可以尝试使用Warp终端,它支持多标签页、主题切换、命令补全等特性,可以让你更高效地使用终端。

开始动手(3 步)

1. 克隆项目

将仓库代码下载到本地。你可以把 vibe-any 换成任意文件夹名。

不想用 Git?可以直接下载 ZIP:

下载 ZIP

git clone https://github.com/待修改/vibe-any.git
cd vibe-any

2. 安装依赖

选择一个包管理器执行安装。以下四种命令任选其一:

pnpm install

3. 设置环境变量

.env 用来存放项目运行所需的变量(例如数据库、第三方服务密钥)。先复制示例文件,再按注释填写。

cp .env.example .env

小贴士:常见变量包括 DATABASE_URL、OAuth(GitHub/Google)配置、以及支付相关密钥。详见文档《环境变量》。

目录