diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts
index 324f9d8..ca6c7c0 100644
--- a/docs/.vitepress/config.mts
+++ b/docs/.vitepress/config.mts
@@ -73,4 +73,23 @@ export default defineConfig({
copyright: 'Copyright © 2024 Ryo Kawamata'
},
},
+
+ locales: {
+ root: {
+ label: 'English',
+ lang: 'en'
+ },
+ ja: {
+ label: '日本語',
+ lang: 'ja',
+ link: '/ja/',
+ themeConfig: {
+ nav: [
+ { text: "Home", link: "/" },
+ { text: "使い方", link: "/ja/get-started" },
+ { text: "トラブルシューティング", link: "/ja/troubleshooting" },
+ ],
+ }
+ }
+ }
});
diff --git a/docs/ja/get-started.md b/docs/ja/get-started.md
new file mode 100644
index 0000000..9a242b8
--- /dev/null
+++ b/docs/ja/get-started.md
@@ -0,0 +1,84 @@
+# はじめに
+
+スカイフォローブリッジは、あなたの𝕏（Twitter）接続をBlueskyで見つけてフォローするのを助けます。
+
+
+
+このビデオはEdgeバージョンを示しています。最新のChromeバージョンと最近のFirefoxバージョンでは動作が異なる場合があります。Chromeのビデオチュートリアルは近日公開予定です。
+
+## インストール
+
+スカイフォローブリッジは以下で利用可能です：
+
+- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko)（推奨）
+- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/)
+- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb)
+
+::: tip
+Chrome Web Storeバージョンを使用することをお勧めします。常に最新の状態です。他のストアバージョンは更新が遅れる場合があります。
+:::
+
+## 使用方法
+
+### 1. 𝕏（Twitter）に移動
+
+𝕏の以下のページにアクセスしてください：
+- あなたのフォロー中のページ: `x.com//following`
+- ブロックしたユーザーのページ: `x.com/settings/blocked/all`
+- 公開リストのメンバーのページ: `x.com/i/lists//members`
+
+
+
+### 2. スカイフォローブリッジを起動
+
+`Alt + B`を押すか、ブラウザツールバーの拡張機能アイコンをクリックします。
+
+::: tip
+Firefoxユーザーの場合、`Alt + B`が機能しないことがあります。その場合は、ブラウザツールバーの拡張機能アイコンをクリックしてください。
+
+https://support.mozilla.org/en-US/kb/extensions-button
+:::
+
+
+
+### 3. Blueskyにサインイン
+
+あなたのBlueskyハンドル（またはメール）と[アプリパスワード](https://bsky.app/settings/app-passwords)を入力してください。
+
+::: tip
+ログインエラーが発生した場合は、[トラブルシューティングガイド](/ja/troubleshooting)を参照してください。
+:::
+
+
+
+### 4. 検索を開始
+
+「Find Bluesky users」をクリックしてスキャンを開始します。拡張機能はBluesky APIをチェックして一致するBlueskyプロファイルを検索します。
+
+
+
+### 5. 結果を確認
+
+「Show results」をクリックして、Blueskyで見つかった可能性のある一致を確認します。
+
+
+
+これにより、検出されたすべてのBlueskyユーザーを表示するオプションページが開きます。
+
+
+
+### 6. ユーザーをフォロー
+
+接続したいユーザーの横にある「Follow」ボタンをクリックします。
+
+
+
+または、「Follow all」ボタンを使用して、検出されたすべてのユーザーを一度にフォローします。
+
+
+
+::: warning
+マッチングプロセスは完璧ではなく、時折誤った一致を提案することがあります。フォローする前に必ずプロフィールを確認してください。
+:::
+
+以上です！Blueskyでのコミュニティとのつながりを楽しんでください 🎉
diff --git a/docs/ja/index.md b/docs/ja/index.md
new file mode 100644
index 0000000..8c930b4
--- /dev/null
+++ b/docs/ja/index.md
@@ -0,0 +1,32 @@
+---
+layout: home
+
+hero:
+ name: "Sky Follow Bridge"
+ text: "Connect your social networks"
+ tagline: Seamlessly migrate your social connections from 𝕏 to Bluesky
+ actions:
+ - theme: brand
+ text: 使い方
+ link: /ja/get-started
+ - theme: alt
+ text: トラブルシューティング
+ link: /ja/troubleshooting
+ image:
+ src: /images/logo.png
+ alt: Sky Follow Bridge cover image
+
+features:
+ - icon: 🔍
+ title: 自動プロフィールマッチング
+ details: 𝕏のフォローに似たBlueskyユーザーを自動的に検出します。
+ - icon: 🚀
+ title: 一括フォロー機能
+ details: 「すべてフォロー」ボタンで複数のユーザーを一度にフォローして時間を節約。
+ - icon: 📋
+ title: 複数リストのサポート
+ details: フォロー、フォロワー、ブロックユーザーリスト、さらには公開𝕏リストにも対応。
+ - icon: 🌐
+ title: クロスブラウザ対応
+ details: Chrome、Firefox、Microsoft Edgeで利用可能。
+---
diff --git a/docs/ja/troubleshooting.md b/docs/ja/troubleshooting.md
new file mode 100644
index 0000000..17c4c3c
--- /dev/null
+++ b/docs/ja/troubleshooting.md
@@ -0,0 +1,122 @@
+# トラブルシューティングガイド
+
+## 認証エラー
+
+### ログインの問題
+
+**エラーメッセージ:**
+Error: Invalid identifier or password
+
+**チェックリスト:**
+1. ユーザー名とパスワードの入力
+ - 余分なスペースがないか確認
+ - コピー＆ペーストする場合、余分な文字が含まれていないか確認
+
+2. ユーザー名の形式
+ - 正しい形式: `your-username.bsky.social`
+ - よくある間違い: `your-username`（.bsky.socialが欠落）
+
+3. パスワード情報
+ - 通常のパスワードではなく、[AppPassword](https://bsky.app/settings/app-passwords)を使用することを強くお勧めします
+ - アプリパスワードの形式: `xxxx-xxxx-xxxx-xxxx`（19文字）
+
+::: tip 役立つヒント
+AppPasswordを設定の「パスワード名」と混同しないでください。
+新しいAppPasswordを作成する方法:
+1. [AppPasswordセクションに移動](https://bsky.app/settings/app-passwords)
+2. 「AppPasswordを追加」をクリック
+3. 「AppPasswordを作成」をクリック
+4. 生成された19文字のパスワードをコピー
+:::
+
+---
+
+### 二要素認証の問題
+
+**エラーメッセージ:**
+Error: Two-factor authentication required
+
+**解決策:**
+1. 認証コードが記載されたメールを確認
+2. 2FA入力フィールドにコードを入力
+3. 再度ログインを試みる
+
+::: warning
+Firefox版は2FAに対応していません。Firefox版では2FAを無効にしてください。
+:::
+
+## レート制限エラー
+
+**エラーメッセージ:**
+Error: Rate limit error
+
+**解決策:**
+1. Bluesky APIには以下の制限があります（[公式ドキュメント](https://docs.bsky.app/docs/advanced-guides/rate-limits)）:
+ - 1時間あたり最大5,000ポイント（約1,666の新しいアクション）
+ - 1日あたり最大35,000ポイント
+ - アクションごとのポイント:
+ - 作成: 3ポイント
+ - 更新: 2ポイント
+ - 削除: 1ポイント
+2. 制限に達した場合、制限がリセットされるまで待つ
+3. 「Restart」ボタンをクリックして再試行
+
+::: warning
+Firefoxで公開されているバージョンは、レート制限エラーに頻繁に遭遇します。エラーが発生した場合は、Chromeで試してください。
+:::
+
+::: tip
+通常の使用ではほとんどのユーザーがこれらの制限に達することはありません。ただし、多くのユーザーを短時間でフォローしたり、多くの投稿にいいねをしたりする場合は注意してください。
+:::
+
+## ページエラー
+
+### 無効なページ
+
+**エラーメッセージ:**
+Error: Invalid page. please open the 𝕏 following or blocking or list page.
+
+**解決策:**
+この拡張機能は以下の𝕏（Twitter）ページでのみ使用してください：
+- フォロー中のページ ([x.com/following](https://x.com/following))
+- ブロック中のページ ([x.com/settings/blocked/all](https://x.com/settings/blocked/all))
+- リストメンバーのページ (`x.com/i/lists//members`)
+
+または、拡張機能ページで拡張機能の権限を確認してください。
+サイトの権限は以下のように設定されている必要があります：
+
+
+
+## スキャンの問題
+
+### スキャンが途中で停止
+
+スキャンがページの下部に到達する前に停止する
+
+**解決策:**
+1. 「Resume」をクリックして続行
+2. スキャンはページの下部に到達すると自動的に停止します
+3. いつでも「Stop and show results」をクリックできます
+
+### ユーザーが見つからない
+
+スキャン後にBlueskyユーザーが検出されない
+
+**解決策:**
+1. 正しくログインしていることを確認
+2. 再度スキャンを試みる - 一部のユーザーは最初のパスで検出されない場合があります
+3. 𝕏ユーザーがプロフィールにBlueskyアカウントをリンクしているか確認
+
+## その他の問題
+
+予期しないエラーが発生した場合：
+
+1. ページをリロード
+2. 操作を再試行
+3. 問題が解決しない場合は、以下のいずれかを行う：
+ - [問題を作成](https://github.com/kawamataryo/sky-follower-bridge/issues)：
+ - 正確なエラーメッセージ
+ - 実行しようとした操作
+ - ブラウザの種類とバージョン
+ - 関連するスクリーンショット
+ - または、Blueskyで[@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social)に言及