AI Pages 支持多种主流前端框架与构建工具，多数情况下无需额外配置即可完成部署。

前端 #

Create React App #

Create React App 是 React 官方脚手架，零配置快速创建 React 应用。
默认构建设置如下：
构建命令：react-scripts build
输出目录：build

Vue CLI #

Vue CLI 是 Vue.js 官方脚手架工具，提供完整的项目搭建与构建能力。
默认构建设置如下：
构建命令：vue-cli-service build
输出目录：dist

Vite #

Vite 是新一代前端构建工具，基于原生 ESM 提供极速开发体验。
默认构建设置如下：
构建命令：npm run build
输出目录：dist

Angular #

Angular 是 Google 出品的企业级前端框架，提供完整的 TypeScript 开发体验。
默认构建设置如下：
构建命令：ng build
输出目录：dist

VitePress #

VitePress 是基于 Vite 和 Vue 的静态站点生成器，专为文档站点设计。
默认构建设置如下：
构建命令：vitepress build docs
输出目录：docs/.vitepress/dist

VuePress #

VuePress 是 Vue 驱动的静态站点生成器，内置 Markdown 扩展与主题系统。
默认构建设置如下：
构建命令：vuepress build src
输出目录：src/.vuepress/dist

Docusaurus #

Docusaurus 是 Meta 出品的文档网站框架，提供了良好的默认样式和功能。
默认构建设置如下：
构建命令：npm run build
输出目录：build

Hexo #

Hexo 是基于 Node.js 的博客框架，支持丰富的主题与插件扩展。
默认构建设置如下：
构建命令：hexo generate
输出目录：public

后端 #

Pages 支持 Function 函数开发和 Node 第三方框架如 Express/Koa。

Express #

Express 是最流行的 Node.js Web 框架，提供简洁灵活的中间件与路由机制。将 Express 应用实例作为默认导出，IGA Pages 会根据文件在 api/ 目录中的位置自动确定路由挂载点。文件名须使用 `[[default]].js` 格式，确保所有子路径转发至 Express 处理。

// api/[[express]].js
import express from "express";

const app = express();
app.use(express.json());

// 路由路径基于文件系统位置，对应路由为/api/users
app.get("/users", (req, res) => res.json({ users: [] }));
app.post("/users", (req, res) => res.status(201).json({ user: req.body }));
app.get("/users/:id", (req, res) => res.json({ user: req.params.id }));

export default app; // 不要调用 app.listen()

本地开发后端接口需要先安装 IGA Pages CLI，然后使用 iga pages dev 启动开发服务器。

npm install -g @iga-pages/cli
iga pages dev

Koa #

Koa 是由 Express 原班人马打造的下一代 Node.js Web 框架，基于 async/await 提供更优雅的中间件写法。同样需要使用 [[default]].js 文件名，并直接导出 Koa 应用实例。

// api/[[default]].js
import Koa from "koa";
import Router from "@koa/router";
import bodyParser from "koa-bodyparser";

const app = new Koa();
const router = new Router();

app.use(bodyParser());

router.get("/users", (ctx) => {
  ctx.body = { users: [] };
});
router.post("/data", (ctx) => {
  ctx.status = 201;
  ctx.body = { data: ctx.request.body };
});

app.use(router.routes());
app.use(router.allowedMethods());

export default app; // 不要调用 app.listen()

全栈 #

Next.js #

Next.js 是一个基于 React 的全栈框架，支持服务端渲染（SSR）与静态导出（Static Export），适合构建高性能的现代 Web 应用。IGA Pages 支持 Next.js 14 及以上版本。