Pocket Stack

Appearance

快速开始 ​

使用skill开始 ​

建议使用 pocketstack skill 创建新的PocketStack项目。

例如，在agent（如Codex或Trea Work）中输入提示词：

在{指定目录下}初始化一个PocketStack项目，并运行开发环境

Agent会自动执行从克隆项目到启动开发环境的所有步骤。

使用pocketstack skill初始化项目

也按以下步骤手动开始：

手动开始 ​

1. 克隆项目并初始化环境变量配置文件 ​

bash
git clone https://github.com/citywill/pocket-stack <项目目录名>
cd <项目目录名>
cp .env.example .env

项目目录名由用户指定，若用户未提供则默认为 pocket-stack。

2. 安装后端 (PocketBase) ​

将 PocketBase 可执行文件下载到项目根目录：

  • 前往 PocketBase Releases 下载对应平台的可执行文件
  • Windows: pocketbase.exe
  • macOS/Linux: pocketbase

将下载的文件放置在项目根目录 .pocketbase/ 下。

3. 安装依赖 ​

bash
npm install
# 或使用 pnpm
pnpm install

4. 启动开发环境 ​

bash
npm run dev
# 或使用 pnpm
pnpm dev

该命令会同时启动 PocketBase 后端和 Vite 前端开发服务器。

5. 配置PocketBase ​

在浏览器中访问 http://127.0.0.1:8090/_/ 创建管理员账号并配置集合（开发环境建议使用默认账号密码 admin@example.com/admin12345）。

6. 初始化模块 ​

在浏览器访问 http://localhost:5173，使用superuser账号登录，访问模块管理功能，即可初始化模块。