diff --git a/.github/workflows/check.yml b/.github/workflows/check.yml
index 8d5e078..b098b66 100644
--- a/.github/workflows/check.yml
+++ b/.github/workflows/check.yml
@@ -12,7 +12,7 @@ jobs:
strategy:
fail-fast: false
matrix:
- project: [docs-starter, versioning]
+ project: [docs-starter, i18n, versioning]
steps:
- name: Checkout repository
uses: actions/checkout@v4
diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
index 6418886..ca6fc1e 100644
--- a/.github/workflows/preview-docs.yml
+++ b/.github/workflows/preview-docs.yml
@@ -11,7 +11,7 @@ jobs:
strategy:
fail-fast: false
matrix:
- project: [docs-starter, versioning]
+ project: [docs-starter, i18n, versioning]
steps:
- name: Checkout repository
uses: actions/checkout@v4
diff --git a/.github/workflows/publish-docs.yml b/.github/workflows/publish-docs.yml
index 11f752e..75d1b59 100644
--- a/.github/workflows/publish-docs.yml
+++ b/.github/workflows/publish-docs.yml
@@ -12,7 +12,7 @@ jobs:
strategy:
fail-fast: false
matrix:
- project: [docs-starter, versioning]
+ project: [docs-starter, i18n, versioning]
steps:
- name: Checkout repository
uses: actions/checkout@v4
diff --git a/README.md b/README.md
index 8a20ea0..fe50428 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,7 @@ Example Fern docs projects. Each top-level folder is a self-contained example wi
| Example | Description | Live demo |
| --- | --- | --- |
| [`docs-starter`](./docs-starter) | Minimal starter project | [docs-starter.docs.buildwithfern.com](https://docs-starter.docs.buildwithfern.com) |
+| [`i18n`](./i18n) | Multi-language docs with English + Japanese translations | [i18n.docs.buildwithfern.com](https://i18n.docs.buildwithfern.com) |
| [`versioning`](./docs-versioned) | Versioned site with a version dropdown and a shared page | [versioning.docs.buildwithfern.com](https://versioning.docs.buildwithfern.com) |
## Use an example
diff --git a/docs-starter/fern/fern.config.json b/docs-starter/fern/fern.config.json
index ec7b212..63d358c 100644
--- a/docs-starter/fern/fern.config.json
+++ b/docs-starter/fern/fern.config.json
@@ -1,4 +1,4 @@
{
"organization": "fern-docs-examples",
- "version": "4.35.0"
+ "version": "4.97.0"
}
diff --git a/i18n/fern/docs.yml b/i18n/fern/docs.yml
new file mode 100644
index 0000000..30db5c4
--- /dev/null
+++ b/i18n/fern/docs.yml
@@ -0,0 +1,22 @@
+# yaml-language-server: $schema=https://schema.buildwithfern.dev/docs-yml.json
+
+instances:
+ - url: i18n.docs.buildwithfern.com
+
+title: Fern Docs i18n Example
+
+logo:
+ light: images/logo-light.svg
+ dark: images/logo-dark.svg
+ height: 32
+
+translations:
+ - lang: en
+ - lang: fr
+ - lang: ja
+
+navigation:
+ - page: Introduction
+ path: pages/introduction.mdx
+ - page: Getting Started
+ path: pages/getting-started.mdx
diff --git a/i18n/fern/fern.config.json b/i18n/fern/fern.config.json
new file mode 100644
index 0000000..63d358c
--- /dev/null
+++ b/i18n/fern/fern.config.json
@@ -0,0 +1,4 @@
+{
+ "organization": "fern-docs-examples",
+ "version": "4.97.0"
+}
diff --git a/i18n/fern/images/logo-dark.svg b/i18n/fern/images/logo-dark.svg
new file mode 100644
index 0000000..144e0e3
--- /dev/null
+++ b/i18n/fern/images/logo-dark.svg
@@ -0,0 +1,9 @@
+
diff --git a/i18n/fern/images/logo-light.svg b/i18n/fern/images/logo-light.svg
new file mode 100644
index 0000000..7cf2ee2
--- /dev/null
+++ b/i18n/fern/images/logo-light.svg
@@ -0,0 +1,14 @@
+
diff --git a/i18n/fern/pages/getting-started.mdx b/i18n/fern/pages/getting-started.mdx
new file mode 100644
index 0000000..ecd728a
--- /dev/null
+++ b/i18n/fern/pages/getting-started.mdx
@@ -0,0 +1,23 @@
+# Getting Started
+
+Follow these steps to get up and running quickly.
+
+## Step 1: Install
+
+```bash
+npm install @fern-api/fern-cli -g
+```
+
+## Step 2: Initialize
+
+```bash
+fern init
+```
+
+## Step 3: Generate
+
+```bash
+fern generate
+```
+
+You're all set! Check the output directory for your generated files.
diff --git a/i18n/fern/pages/introduction.mdx b/i18n/fern/pages/introduction.mdx
new file mode 100644
index 0000000..3ed4bf1
--- /dev/null
+++ b/i18n/fern/pages/introduction.mdx
@@ -0,0 +1,11 @@
+# Introduction
+
+Welcome to the i18n docs example. This project demonstrates multi-language support using Fern's translations feature.
+
+## What is this?
+
+This is a minimal documentation site that uses English as the default language with Japanese and French as translated locales.
+
+## How it works
+
+The default pages live in the `pages/` directory. Translated versions live in `translations//pages/`, mirroring the same file paths.
diff --git a/i18n/fern/translations/fr/pages/getting-started.mdx b/i18n/fern/translations/fr/pages/getting-started.mdx
new file mode 100644
index 0000000..9b4b425
--- /dev/null
+++ b/i18n/fern/translations/fr/pages/getting-started.mdx
@@ -0,0 +1,27 @@
+---
+sidebar-title: Démarrage
+---
+
+# Bien démarrer
+
+Suivez ces étapes pour commencer rapidement.
+
+## Étape 1 : Installer
+
+```bash
+npm install @fern-api/fern-cli -g
+```
+
+## Étape 2 : Initialiser
+
+```bash
+fern init
+```
+
+## Étape 3 : Générer
+
+```bash
+fern generate
+```
+
+C'est prêt ! Vérifiez le dossier de sortie pour voir les fichiers générés.
diff --git a/i18n/fern/translations/fr/pages/introduction.mdx b/i18n/fern/translations/fr/pages/introduction.mdx
new file mode 100644
index 0000000..6ccc21c
--- /dev/null
+++ b/i18n/fern/translations/fr/pages/introduction.mdx
@@ -0,0 +1,15 @@
+---
+sidebar-title: Introduction
+---
+
+# Introduction
+
+Bienvenue dans cet exemple de documentation i18n. Ce projet montre la prise en charge multilingue avec la fonctionnalité de traduction de Fern.
+
+## De quoi s'agit-il ?
+
+Il s'agit d'un site de documentation minimal avec l'anglais comme langue par défaut, et le japonais ainsi que le français comme langues traduites.
+
+## Comment cela fonctionne
+
+Les pages par défaut se trouvent dans le dossier `pages/`. Les versions traduites se trouvent dans `translations//pages/`, en reprenant les mêmes chemins de fichiers.
diff --git a/i18n/fern/translations/ja/pages/getting-started.mdx b/i18n/fern/translations/ja/pages/getting-started.mdx
new file mode 100644
index 0000000..85bbc61
--- /dev/null
+++ b/i18n/fern/translations/ja/pages/getting-started.mdx
@@ -0,0 +1,27 @@
+---
+sidebar-title: はじめ方
+---
+
+# はじめ方
+
+以下の手順に従って、すぐに使い始めましょう。
+
+## ステップ1: インストール
+
+```bash
+npm install @fern-api/fern-cli -g
+```
+
+## ステップ2: 初期化
+
+```bash
+fern init
+```
+
+## ステップ3: 生成
+
+```bash
+fern generate
+```
+
+完了です！生成されたファイルは出力ディレクトリで確認できます。
diff --git a/i18n/fern/translations/ja/pages/introduction.mdx b/i18n/fern/translations/ja/pages/introduction.mdx
new file mode 100644
index 0000000..c9147e0
--- /dev/null
+++ b/i18n/fern/translations/ja/pages/introduction.mdx
@@ -0,0 +1,15 @@
+---
+sidebar-title: はじめに
+---
+
+# はじめに
+
+i18nドキュメントサンプルへようこそ。このプロジェクトは、Fernの翻訳機能を使用した多言語サポートのデモです。
+
+## これは何ですか？
+
+これは、デフォルト言語を英語とし、日本語とフランス語の翻訳ロケールを持つ、国際化（i18n）を示す最小限のドキュメントサイトです。
+
+## 仕組み
+
+デフォルトのページは `pages/` ディレクトリにあります。翻訳版は `translations//pages/` に同じファイルパスで配置されます。
diff --git a/versioning/fern/fern.config.json b/versioning/fern/fern.config.json
index ec7b212..63d358c 100644
--- a/versioning/fern/fern.config.json
+++ b/versioning/fern/fern.config.json
@@ -1,4 +1,4 @@
{
"organization": "fern-docs-examples",
- "version": "4.35.0"
+ "version": "4.97.0"
}