template 제출 방법

시작하기 전에

제출 전 두 가지를 준비해야 합니다.

1. A GitHub account. template repo는 GitHub에 호스팅되어야 합니다. 계정이 없다면 먼저 create one 하세요.
2. A finalized design. 제출하기 전에 .picopixel 파일이 최종 상태인지 확인하세요. PicoPixel app에서 내보내 repo에 추가할 준비를 합니다.

GitHub repo 설정하기

template submission을 위한 새 public GitHub repository를 만듭니다. repo에는 세 가지가 들어 있어야 합니다.

1. Your .picopixel file

.picopixel design file을 repo 루트에 둡니다. 사람들이 다운로드해 PicoPixel에서 열 파일이므로 최종 버전인지 확인하세요.

2. Showcase images

gallery에서 template과 함께 표시하고 싶은 이미지를 추가합니다. 사람들이 다운로드 전에 디자인이 어떻게 보이는지 이해하는 데 도움이 됩니다.

• 이미지는 repo 루트 또는 images/ 같은 폴더에 넣습니다.
• 일반 형식을 사용하세요: .png, .jpg, .webp.
• 디자인이 동작하는 스크린샷을 최소 하나 포함하세요. 여러 각도나 화면이 있으면 더 좋습니다.
• 이미지는 적당한 크기로 유지하세요. 세부 사항이 보일 만큼 크되, 불필요하게 거대하지 않게 합니다.

3. A README

repo 루트에 README.md를 작성합니다. 이것은 gallery에서 template 설명으로 사용되므로 template의 공개 페이지처럼 다루세요.

좋은 README에는 다음이 포함됩니다.

• What the template is — 디자인의 간단한 요약과 용도.
• Target resolution and hardware — 어떤 보드나 디스플레이를 위해 만들어졌는지, 사람들이 자신의 환경에 맞는지 알 수 있게 합니다.
• What's included — screens, widgets, 주요 기능을 나열합니다. 예: "two screens: a home dashboard and a settings page, with sliders, toggles, and a clock widget."
• Credits — 공유할 권리가 있는 타사 assets를 사용했다면 이름과 출처를 적습니다.

Here's a minimal example:

# 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).

양식 작성하기

repo가 준비되면 제출 양식으로 이동합니다.

1. the PicoPixel app을 열고 로그인합니다.
2. 왼쪽 사이드바 아래쪽의 계정을 클릭한 뒤 Your account를 선택합니다.
3. Your-account 사이드바에서 Submit Template을 엽니다.

양식에는 세 필드가 있습니다.

• GitHub Repo Link — public GitHub repository의 URL(예: https://github.com/yourname/my-template). review team이 접근할 수 있도록 repo는 public이어야 합니다. 제출하기 전에 repo에 .picopixel 파일, 이미지, README가 있는지 다시 확인하세요.
• Author / Credits — template creator로 표시할 이름입니다. 함께 크레딧을 받아야 할 사람이 있다면 추가하세요.
• Notes(optional) — README에는 없지만 review team이 알아야 할 내용입니다. 예를 들어 gallery listing에 사용하면 안 되는 특정 이미지나 공개 설명에는 맞지 않는 디자인 배경이 있을 수 있습니다.

모든 것이 맞아 보이면 양식을 제출합니다.

권리와 권한

template 제출은 실제 권한을 부여하는 일이므로 보내기 전에 주의 깊게 읽으세요.

제출하면 PicoPixel에 repository 콘텐츠에 접근하고, 다운로드하고, 커뮤니티 templates gallery에 공개 게시할 권한을 부여합니다. 게시된 templates는 저작권 제한이나 라이선스 요구 없이 제공되므로 누구나 자신의 프로젝트에서 자유롭게 사용할 수 있으며, 상업적 사용도 포함됩니다. 당신의 크레딧은 표시되지만 template 자체는 다른 사람들이 원하는 방식으로 사용할 수 있습니다.

따라서 이런 조건으로 공유해도 괜찮은 작업만 제출하세요. 디자인의 일부에 직접 만들지 않은 asset(폰트, 아이콘 세트, 이미지 등)이 있고, 자유롭고 제한 없이 공유할 수 있는지 확신이 없다면 제출 전에 제거하세요. 확실하지 않다면 빼세요. 나중에 내려야 하는 template보다 깨끗한 template이 훨씬 유용합니다.

PicoPixel은 제3자 권리를 침해하는 콘텐츠를 제거할 수 있습니다. Terms를 보세요.

다음에 일어나는 일

제출 후 PicoPixel 팀은 repo를 clone하고 template을 검토합니다. .picopixel 파일이 제대로 열리는지, 이미지와 README가 적절한지, 제출이 Terms를 충족하는지 확인합니다.

무언가 명확히 하거나 고쳐야 할 경우 팀이 연락할 수 있습니다. 검토를 통과하면 template은 Templates gallery에 게시되고 당신의 크레딧과 README 설명이 표시됩니다. 이후 누구나 자신의 디자인 시작점으로 열 수 있습니다.

게시된 template을 수정하거나 내려야 한다면(당신 것 또는 다른 사람 것), How to report content를 보세요.

다음 단계

• Templates gallery, 커뮤니티 templates 둘러보기
• How to submit a pet, animated sprite 공유하기
• How to report content, pet 또는 template 문제 신고하기
• Terms, 제출에 적용되는 규칙