このテンプレートについて
このテンプレートは、プロ向けの開発者ツールのような見た目と使い心地を備えた、クライアントサイドで動くJSONフォーマッターです。バックエンドもアカウントも初期設定も不要で、すぐに使い始められます。
技術的な部分はすでに用意されています。CodeMirror 6によるシンタックスハイライト付きの編集、括弧の対応表示、行番号、6つの出力タブ、lz-stringによるURL共有、localStorageへの自動保存。ツールの設定に時間を取られることなく、データを扱う作業に集中できます。
含まれるもの:/に配置された1画面完結のツールで、分割ペインのレイアウトを採用しています(デスクトップでは左にエディター、右にタブ付きの出力を表示し、モバイルでは縦に並べて表示)。入力エディターは、貼り付け、アップロード、あらかじめ読み込まれたサンプルドキュメントに対応しています。出力パネルには6つのタブがあります。「整形」(インデント幅2・3・4スペースで見やすく整形)、「圧縮」(削減されたバイト数の表示付き)、「XML」「CSV」「YAML」、そして「問題」です。すべてのタブに「コピー」と「ダウンロード」のボタンがあります。「共有」を使うとドキュメントがURLハッシュに圧縮されるため、リンクを開けばまったく同じ状態が復元されます。
広告が表示され利用状況が追跡されるWeb上のJSONフォーマッターをブックマークしたり、めったに開かないデスクトップアプリをインストールしたりするのと比べて、このテンプレートなら自分で管理できる、すっきりとしたプライベートな作業環境が手に入ります。データがブラウザの外に送られることはありません。登録の壁も、機能制限もありません。
APIレスポンスのデバッグ
生のAPIレスポンスをエディターに貼り付けて「整形」をクリックすれば、構造がひと目でわかります。おかしな点があれば「検証」を押しましょう。「問題」タブに、エラーのある行と列、期待されるトークンが正確に表示されます。「行へ移動」をクリックすると、エディターがエラー箇所まで直接スクロールします。「何かがおかしい」から「原因が見つかった」まで、数分ではなく数秒でたどり着けます。
設定ファイルの準備
サービス間でJSONの設定ファイルをやり取りするチームには、統一されたフォーマットが欠かせません。インデント幅を設定して「整形」をクリックし、結果をダウンロードするだけです。トークンストリーム方式の再出力処理により64ビット整数がそのまま保持されるため、数値の精度が知らないうちに失われることはありません。安心して同僚にファイルを渡したり、バージョン管理にコミットしたりできます。
データ形式の変換
「XML」「YAML」「CSV」タブに切り替えれば、別のツールをインストールしなくてもJSONを変換できます。CSVでは、オブジェクトの配列がドット記法のヘッダー付きの行に展開されます。YAMLとXMLへの変換では、エスケープや引用符の処理が自動で行われます。正しい拡張子で出力をダウンロードして、次の作業に進みましょう。
チームとのJSONスニペット共有
「共有」をクリックすると、ドキュメント全体がURLに圧縮されます。そのリンクをSlackで送ったり、GitHubのイシューに貼ったり、ブックマークしたりできます。受け取った人はリンクを開くだけで、共有されたドキュメントをそのまま確認でき、アカウントも必要ありません。エンコード後に50 KBを超えるドキュメントの場合は、代わりにダウンロードするよう案内が表示されます。
はじめ方
1. このテンプレートをリミックスする
Lovableでこのテンプレートを開き、「リミックス」をクリックします。JSONフォーマッター一式が、すぐに自分のプロジェクトで動き出します。このテンプレートが合わなければ、別のテンプレートをリミックスすればよいので、作業が無駄になることはありません。
2. ブランドに合わせてカスタマイズする
ページタイトルを変更し、アイコンを差し替え、アズール系のカラーをブランドに合わせて調整しましょう。テーマ機能には、エディター用のシンタックステーマが最初から6種類用意されています。利用者の好みに合うものを選ぶか、CSSカスタムプロパティを編集して独自のカラーパレットを作成できます。
3. コンテンツを追加する
サンプルのJSONを、ユーザーにとって意味のあるドキュメントに置き換えましょう。特定のAPI向けのツールを作るなら、代表的なレスポンスをあらかじめ読み込んでおくと、初めて訪れた人にも関連性のある内容を見せられます。検索で見つけてもらいやすくするため、index.htmlのメタタイトルとディスクリプションも更新しておきましょう。
4. ツールを連携する
このテンプレートは意図的にクライアントのみで動く設計ですが、機能を拡張することもできます。アナリティクスを追加すれば、利用傾向を把握できます。ドキュメントの保存やユーザーアカウントが必要なら、Supabaseのバックエンドを接続しましょう。iframeでツールを埋め込んだり、APIリファレンスのページからリンクしたりして、既存のドキュメントサイトと統合することもできます。
5. 公開する
Lovableからワンクリックで公開できます。数分後には、JSONフォーマッターが公開URLで利用できるようになります。エンジニアリングチームに共有したり、開発者向けドキュメントからリンクしたり、単体のユーティリティとして公開したりしましょう。訪れた人は誰でも、表示された瞬間から動作するツールを使えます。
まとめ
このJSONフォーマッターテンプレートは、プライベートで高速、アカウント不要のJSONツールを自分のドメインで提供したい開発者や創業者に最適です。広告なしで整形でき、登録なしで検証でき、デスクトップソフトをインストールせずに変換できます。
今日このテンプレートをリミックスすれば、その日の午後のうちに自社ブランドのJSONフォーマッターを公開できます。チームは外部サイトを行き来する手間から解放され、開発者向けドキュメントには便利なツールが加わり、ユーザーは時間とデータを大切にしてくれるユーティリティを手にできます。
機能・できること
整形表示(プリティプリント)
トークン列からJSONを2・3・4スペースのインデントで再出力します。64ビット整数をそのまま保持するため、数値の精度が知らないうちに失われることはありません。
ワンクリックでミニファイ
空白をすべて取り除き、バイト削減量をリアルタイムで表示します。コピーする前に、出力がどれだけ小さくなったかを正確に把握できます。
キャレット表示による検証
JSONを解析し、行・列・期待されるトークンの情報でエラー箇所を正確に示します。「Jump to line」をクリックすると、エディタが問題の箇所までスクロールします。
XML・CSV・YAMLへの変換
タブを切り替えるだけで、別のツールをインストールすることなくJSONをXML、YAML、CSVに変換できます。各フォーマットは正しいファイル拡張子でダウンロードできます。
URLハッシュによるドキュメント共有
lz-stringでドキュメントを圧縮してURLに埋め込みます。リンクを送れば、受け取った相手はまったく同じJSONを表示でき、アカウントもバックエンドも必要ありません。
localStorageへの自動保存
キー入力のたびにドキュメントをブラウザに保存します。タブを閉じて後から戻っても、作業は中断したところからそのまま続けられます。
ファイルのアップロードとダウンロード
ローカルのJSONファイルをドラッグ&ドロップまたはファイル選択でアップロードできます。どの出力タブも、.json、.xml、.csv、.yaml、.txt形式で、一定の規則に沿ったファイル名でダウンロードできます。
CodeMirror 6エディタ
CodeMirror 6による本格的なシンタックスハイライト、行番号、括弧の対応表示、元に戻す履歴を備えています。本格的なIDEのような使い心地で、ブラウザ上で動作します。
クライアント完結のプライバシー
データがブラウザの外に出ることはありません。サーバーも、アクセス解析も、トラッキングもなく、ツールは完全にクライアント側で動作し、実行時のネットワークリクエストはゼロです。


