Cómo enviar una plantilla

Antes de empezar

Necesitas tener dos cosas listas antes de enviar.

1. Una cuenta de GitHub. Tu repositorio de plantillas debe estar alojado en GitHub. Si no tienes cuenta, crea una primero.
2. Un diseño finalizado. Asegúrate de estar satisfecho con tu archivo .picopixel antes de enviarlo. Expórtalo desde la app de PicoPixel y tenlo listo para añadirlo a tu repositorio.

Configurar tu repositorio de GitHub

Crea un nuevo repositorio público de GitHub para tu envío de plantilla. El repositorio debe contener tres cosas:

1. Tu archivo .picopixel

Coloca tu archivo de diseño .picopixel en la raíz del repositorio. Este es el archivo que la gente descargará y abrirá en PicoPixel, así que asegúrate de que sea la versión final.

2. Imágenes de muestra

Añade las imágenes que quieras mostrar junto a tu plantilla en la galería. Estas ayudan a la gente a ver cómo luce el diseño antes de descargarlo.

• Coloca las imágenes en la raíz del repositorio o en una carpeta como images/.
• Usa formatos comunes: .png, .jpg o .webp.
• Incluye al menos una captura de pantalla de tu diseño en acción. Múltiples ángulos o pantallas es aún mejor.
• Mantén las imágenes en un tamaño razonable: lo suficientemente grandes para ver los detalles, pero no innecesariamente grandes.

3. Un README

Escribe un README.md en la raíz del repositorio. Este se usa como la descripción de la plantilla en la galería, así que trátalo como la página pública de tu plantilla.

Un buen README debe cubrir:

• Qué es la plantilla: un breve resumen del diseño y para qué sirve.
• Resolución objetivo y hardware: la placa o pantalla para la que fue creada, para que la gente sepa si encaja con su configuración.
• Qué incluye: lista las pantallas, widgets y características principales. Por ejemplo: "dos pantallas: un panel principal y una página de ajustes, con controles deslizantes, interruptores y un widget de reloj."
• Créditos: si usaste recursos de terceros que tienes licencia para compartir, nómbralos y su fuente.

Aquí hay un ejemplo mínimo:

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

Rellenar el formulario

Una vez que tu repositorio esté listo, ve al formulario de envío.

1. Abre la app de PicoPixel e inicia sesión.
2. Haz clic en tu cuenta en la parte inferior de la barra lateral izquierda, luego elige Tu cuenta.
3. En la barra lateral de Tu cuenta, abre Enviar Plantilla.

El formulario tiene tres campos:

• Enlace al repositorio de GitHub: la URL de tu repositorio público de GitHub (p. ej. https://github.com/tunombre/mi-plantilla). El repositorio debe ser público para que el equipo de revisión pueda acceder a él. Verifica que el repositorio contenga tu archivo .picopixel, las imágenes y el README antes de enviar.
• Autor / Créditos: el nombre que quieres que aparezca como creador de la plantilla. Añade a quien deba ser acreditado junto a ti.
• Notas (opcional): cualquier cosa que el equipo de revisión deba saber y que no esté en tu README. Por ejemplo, si ciertas imágenes no deben usarse en el listado de la galería, o si hay contexto sobre el diseño que no pertenece a la descripción pública.

Cuando todo esté bien, envía el formulario.

Derechos y permisos

Enviar una plantilla otorga permisos reales, así que lee esto con atención antes de enviar.

Al enviar, otorgas a PicoPixel permiso para acceder, descargar y publicar el contenido de tu repositorio públicamente en la galería de plantillas de la comunidad. Las plantillas publicadas se ponen a disposición sin restricciones de derechos de autor ni requisitos de licencia, para que cualquiera pueda usarlas libremente en sus propios proyectos, incluso para uso comercial. Tu crédito se muestra, pero la plantilla en sí es libre para que otros la usen como quieran.

Esto significa que solo debes enviar trabajo con el que te sientas cómodo compartiendo en esos términos. Si alguna parte de tu diseño usa un recurso que no creaste — una fuente, conjunto de iconos, imagen u otra cosa — y no estás seguro de que puedes compartirlo libremente y sin restricciones, elimínalo antes de enviar. Ante la duda, omítelo: una plantilla limpia es mucho más útil para los demás que una que tenga que ser retirada más tarde.

PicoPixel puede eliminar contenido que infrinja derechos de terceros. Consulta los Términos.

Qué sucede después

Después de enviar, el equipo de PicoPixel clona tu repositorio y revisa la plantilla. La revisión comprueba que el archivo .picopixel se abre correctamente, que las imágenes y el README son apropiados y que el envío cumple los Términos.

El equipo puede ponerse en contacto si algo necesita aclaración o corrección. Una vez que supera la revisión, la plantilla se publica en la galería de Plantillas con tu crédito y tu README como descripción. Desde allí, cualquiera puede abrirla como punto de partida para su propio diseño.

Si una plantilla publicada alguna vez necesita ser corregida o retirada (la tuya o la de otra persona), consulta Cómo reportar contenido.

A dónde ir después

• Galería de Plantillas: explora las plantillas de la comunidad
• Cómo enviar un pet: comparte un sprite animado en su lugar
• Cómo reportar contenido: señala un problema con un pet o plantilla
• Términos: las normas que aplican a los envíos