概要
テンプレートは、他の人が出発点として開けるように共有された PicoPixel ファイルです。画面をゼロから作る代わりに、あなたのレイアウト、ウィジェット、スタイルがすでに入った状態から始められます。
テンプレートは GitHub 経由で提出します。.picopixel ファイル、表示したい画像、テンプレートを説明する README を含む公開リポジトリを作ります。承認されると、テンプレートはコミュニティの テンプレートギャラリー に表示され、誰でも閲覧して利用でき、あなたのクレジットも付きます。
このガイドでは、リポジトリの準備、提出フォームの記入、付与する権利、承認されやすくするためのポイントを説明します。
始める前に
提出前に 2 つ準備してください。
- GitHub アカウント。 テンプレートを GitHub リポジトリに置く必要があります。アカウントがない場合は、先に作成してください。
- 完成したデザイン。 提出前に
.picopixelファイルが完成していることを確認してください。PicoPixel アプリから書き出し、リポジトリに追加できる状態にします。
提出フォームにアクセスするには PicoPixel アプリにサインインしている必要があります。PicoPixel アプリ を開き、まだの場合は Google または GitHub でサインインしてください。
GitHub リポジトリを設定する
テンプレート投稿用に新しい公開 GitHub リポジトリを作成します。リポジトリには 3 つのものを含めます。
1. .picopixel ファイル
.picopixel 形式のデザインファイルをリポジトリのルートに置きます。利用者がダウンロードして開くファイルなので、投稿する最終版であることを確認してください。
2. 紹介画像
ギャラリーでテンプレートと一緒に表示したい画像を追加します。ダウンロード前にデザインがどう見えるか分かるようにするためです。
- 画像はリポジトリのルート、または
images/のようなフォルダーに置きます。 - 一般的な形式を使います：
.png、.jpg、.webp。 - デザインが動いているスクリーンショットを少なくとも 1 枚含めます。複数の角度や画面があればさらに良いです。
- 画像は適切なサイズにします。詳細が見える大きさで、不要に巨大にはしないでください。
3. README
リポジトリのルートに README.md を書きます。これはギャラリーでテンプレートの説明として使われるので、テンプレートの公開ページとして扱ってください。
わかりやすい README には次を含めるとよいです。
- テンプレートの概要 — デザインの概要と用途。
- 対象の解像度とハードウェア — 対象のボードやディスプレイ。利用者が自分の環境に合うか判断できます。
- 含まれるもの — 画面、ウィジェット、主な機能の一覧。例：「ホーム画面と設定画面の 2 画面。スライダー、スイッチ、時計ウィジェットを含む」
- Credits — 共有許可のある第三者アセットを使った場合、その名前と出典。
ギャラリーで初めてテンプレートを見た人を想像してください。「何のテンプレートか」「自分の用途に合うか」が伝わる README にしましょう。
簡単な記載例です：
# Weather Dashboard Template
A clean two-screen weather dashboard designed for 320×240 TFT displays.
## What's included
- **Home screen** — current temperature, humidity, and a 3-day forecast row
- **Settings screen** — unit toggle (°C/°F), update interval slider, and Wi-Fi status
## Built for
- 320×240 resolution
- ILI9341 or similar TFT displays
## Credits
Weather icons from [Meteocons](https://bas.dev/work/meteocons) (MIT license).フォームに記入する
リポジトリの準備ができたら、提出フォームへ進みます。
- PicoPixel アプリ を開いてサインインします。
- 左サイドバー下部のアカウントをクリックし、Your account を選びます。
- アカウント設定のサイドバーで Submit Template を開きます。
フォームには 3 つのフィールドがあります。
- GitHub Repo Link — 公開 GitHub リポジトリの URL（例：
https://github.com/yourname/my-template）。審査担当チームがアクセスできるよう、リポジトリは公開設定にする必要があります。提出前に.picopixelファイル、画像、README が入っていることを確認してください。 - Author / Credits — テンプレートの作者として表示したい名前。一緒にクレジットすべき人がいれば追加します。
- Notes（任意）— README に書いていない、審査担当チームが知るべき情報。たとえばギャラリーへの掲載に使ってほしくない画像や、公開説明には入れないデザイン背景などです。
すべて問題なければ、フォームを送信します。
権利と許可
投稿すると、作品の公開や利用に関する許可を与えることになります。送信前に、次の条件をご確認ください。
著作権で保護されたコンテンツ、または自分が所有していないコンテンツを含むものを提出しないでください。リポジトリ内のすべて、つまり .picopixel ファイル、画像、フォント、アイコン、その他のアセットは、完全に自分のオリジナル作品か、一般公開する明確な許可を持つ素材でなければなりません。
提出することで、PicoPixel にリポジトリの内容へアクセスし、ダウンロードし、コミュニティテンプレートギャラリーで公開する許可を与えます。公開されたテンプレートは、著作権上の制限やライセンス要件なしで提供され、誰でも自分のプロジェクトで自由に利用できます。商用利用も含みます。あなたのクレジットは表示されますが、テンプレート自体は他の人が好きなように使えるものになります。
この条件で共有できる作品だけを投稿してください。他の人が作ったフォント、アイコン、画像などを含む場合は、制限なく共有できるか確認が必要です。判断できない素材は投稿前に除いてください。権利関係が明確なテンプレートなら、利用者も安心して使えます。
PicoPixel は第三者の権利を侵害するコンテンツを削除する場合があります。利用規約 を参照してください。
投稿後の流れ
提出後、PicoPixel チームはリポジトリを複製してテンプレートを確認します。.picopixel ファイルが正しく開くか、画像と README が適切か、提出が利用規約を満たしているかを確認します。
不明点や修正が必要な場合、チームが連絡することがあります。審査を通過すると、テンプレートは テンプレートギャラリー に公開され、あなたのクレジットと README の説明が表示されます。そこから誰でも、自分のデザインの出発点として開けます。
提出後もリポジトリは残しておいてください。後でテンプレートを更新する必要がある場合、たとえば不具合修正、画像差し替え、説明改善などはリポジトリを更新してチームに知らせることができます。
公開済みテンプレートを修正または削除する必要がある場合（自分のものでも他人のものでも）、コンテンツの報告方法 を参照してください。
次のステップ
- テンプレートギャラリー、コミュニティテンプレートを見る
- ペットの投稿方法、アニメーションするスプライトを共有する
- コンテンツの報告方法、ペットやテンプレートの問題を報告する
- 利用規約、提出に適用されるルール
