如何创建我的第一个项目？

项目是存放所有翻译内容的容器。每个应用或网站都有其独立的项目。

第一步：注册或登录

前往 app.better-i18n.com 并用您的账号登录。如果还没有账号，可以免费注册。

第二步：创建新项目

1. 在控制台点击 "新建项目"
2. 输入项目名称（如"我的网站"）
3. 选择源语言 — 即您编写代码时使用的语言（通常是英语）
4. 添加目标语言 — 您希望翻译到的语言
5. 点击创建

第三步：记录项目标识符

每个项目都有一个 org/project 格式的唯一标识符，如 acme/dashboard。您可以在项目设置中找到它。以下场景需要用到它：

• SDK 配置（project: "acme/dashboard"）
• CLI 配置（better-i18n.config.ts）
• API 调用

第四步：获取 API 密钥

进入设置 → API 密钥并创建新密钥。您需要两种类型：

密钥类型	用途	使用场景
公钥	只读，CDN 访问	前端 SDK、客户端代码
私钥	完全访问	CLI、CI/CD、服务端

安全提示： 切勿在客户端代码中暴露您的私钥。公钥可安全用于浏览器。

第五步：配置 SDK

将您的项目 ID 和公钥添加到 framework SDK：

// 示例：Next.js
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

# 示例：.env 文件
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=pk_...

下一步

• 添加您的第一批翻译键
• 配置 CLI
• 发布翻译