用途:这是从零到生产构建 Blink 全栈应用的总体指南,每一节都指向更深入的技能文档,可作为所有 Blink 技能的入口索引。
前置条件:先安装并认证 Blink CLI:npm install -g @blinkdotnew/cli,然后 blink login。blink login 会打开浏览器创建工作区 API Key,凭据保存在本地。
主要步骤:一、项目初始化,在应用目录执行 bun add @blinkdotnew/sdk,或使用 MCP 工具 blink_project_create 和 blink_project_keys。二、SDK 初始化,用 createClient 传入 projectId 与 publishableKey,auth 设为 managed 模式;环境变量前缀按框架选择 NEXT_PUBLIC_、VITE_、EXPO_PUBLIC_,并建议提供回退值以免 SDK 静默失败导致应用挂起。三、认证,可用 blink.auth.login() 走托管模式,或用 signInWithEmail 走无头模式自建 UI。四、数据库,通过 blink db query 建表,并用 blink.db.<表名>.list 等接口查询。五、后端(Pro+),在 backend/index.ts 写 Hono 服务,用 blink backend deploy 部署。六、部署,先 npm run build,再 blink deploy <project_id> ./dist --prod,站点会立即上线于 https://{project_slug}.blinkpowered.com;注意不要调用 blink_hosting_activate,它会用 Blink AI 模板覆盖外部构建的文件。七、保存项目上下文,按实际值写 AGENTS.md 与内容为 @AGENTS.md 的 CLAUDE.md,不要用占位符。八、自定义域名,用 blink domains add 与 blink domains verify。
关键规则:SDK 代码统一用 camelCase,会自动转成 snake_case;SQLite 布尔值返回 "0"/"1" 字符串,需 Number(val) > 0;ID 一律为字符串;多数 SDK 模块需要先配置认证。
适用框架:前端支持 React (Vite)、Next.js(静态导出)、Vue、Svelte、Astro、Expo React Native 及原生 HTML/CSS/JS;后端仅支持 TypeScript/JavaScript,运行在 CF Workers 上的 Hono。
限制:资料未提供具体价格、配额与更多错误处理细节。