Creador de temas¶
Arma un tema de la app viendo cómo queda, con un asistente de IA que además dibuja su logo en SVG (el icono del tema). A la izquierda está Kino (el Inicio, el menú lateral, la búsqueda y un diálogo) con datos de ejemplo, y debajo el logo puesto en la app; a la derecha, los valores del tema; abajo, el código que va escribiéndose. Parte del tema de Kino: cada valor que muevas cambia la vista al instante, y lo que Kino descartaría (por contraste o por rango) se descarta también aquí y se explica debajo, con las mismas palabras del kit.
Pulsa el menú de tres rayas para abrir el menú lateral y Inicio para volver al Inicio. Con TV ves el riel lateral y el foco. También puedes escribir o pegar el JSON abajo: los controles se ponen al día con lo que escribas.
El logo y el asistente de IA¶
El logo de un tema (logo) es solo vectores: un wordmark (el logo largo del menú y la cabecera), una
mark (el cuadrado del riel del TV) y un decor que se dibuja encima de la «o» del logo de Kino. El creador los dibuja de
verdad: en la cabecera y el menú del celular, en el riel del TV y en la tira Tu logo en la app, debajo de la vista previa.
Pídeselo al asistente con tus palabras («un icono de rayo neón», «una marca de ola para mi tema azul») y él escribe los trazos.
Mientras trabaja verás en qué paso va: preparando la petición, consultando a la IA, leyendo la respuesta, revisando los
valores y actualizando la vista previa. Cada valor que propone se comprueba antes de aplicarlo, con las reglas del contrato: de 1
a 8 trazos de hasta 2.000 caracteres cada uno, solo comandos de trazo SVG (M L H V C S Q T A Z), un lienzo de 1.000 × 1.000 como
mucho y como mucho 8 veces más ancho que alto, y el relleno entre accent, onAccent, textPrimary, textSecondary o un
#RRGGBB. Lo que no cumpla no se aplica y se dice debajo, con el motivo.
El logo también puede venir en el JSON que pegues, y sale en el código y en el kino-plugin.json que descargas. En la sección
Logo e icono de la derecha puedes ver el tamaño y los trazos de cada pieza y quitarlas una por una.
Publicar el plugin desde el creador¶
El panel Publicar en GitHub sube kino-plugin.json, plugin.js (con export {};) y un .gitignore a un repositorio tuyo que ya existe,
sin salir de esta página. También escribe la descripción del repositorio y, si dejas marcada la casilla, le pone el topic
kino-plugin, que es la única forma en que Kino descubre un plugin: el repositorio tiene que ser público y no un fork
(Publicar tu plugin). La descripción que escribas en el panel es también el texto de la tarjeta de tu plugin en Kino (hasta 300 caracteres), y tu usuario de GitHub queda como autor. Al terminar te dice el usuario/repositorio que se escribe en Kino.
No crea repositorios ni pide entrar con tu cuenta. Se prepara una sola vez:
- Crea en GitHub un repositorio público y vacío, sin README.
- En
github.com/settings/personal-access-tokenscrea un token fine-grained. En Repository access elige Only select repositories y marca solo ese repositorio. En permisos pon Contents: Read and write y Administration: Read and write (este último sirve para el topic y la descripción). - Escribe el repositorio en el panel y pega el token.
El token solo alcanza a ese repositorio: si se filtrara, nada más de tu cuenta queda expuesto. Se guarda en esa pestaña, se borra
al cerrarla (o con Borrar el token) y el navegador lo envía únicamente a api.github.com: no pasa por ningún servidor de este
sitio ni de terceros. Si prefieres no usar un token, descarga kino-plugin.json y súbelo tú mismo.
Entrar con GitHub (opcional) evita crear el token: la página muestra un código, lo escribes en https://github.com/login/device y
autorizas. Es más cómodo pero menos estricto: el permiso es public_repo, que alcanza a todos tus repositorios públicos, y el
token pasa por un proxy de Kino (un Worker de Cloudflare, código en
github-oauth-worker/) que no guarda ni registra nada,
no reenvía el refresh token y solo atiende a esta página. Si prefieres que nada pase por ahí, usa el token de un solo repositorio.
Cómo usar el resultado¶
- Descarga
kino-plugin.json(o copia el código) y ponlo en un repositorio nuevo de GitHub, junto con unplugin.jsque solo digaexport {};, o deja que el panel Publicar en GitHub lo suba por ti. Un plugin que solo trae temas no necesita capacidades ni hosts: Un plugin que solo trae temas. - Pon el tópico
kino-pluginal repositorio y publícalo. - Valida con
node sdk/validate.mjs .(el kit): imprime las mismas advertencias que ves aquí.
La vista previa es una aproximación de Kino hecha con HTML y CSS: sirve para escoger colores, formas y bordes, pero la última palabra
la tiene la app. Los valores de Reproductor se guardan en el tema aunque la vista previa solo muestre una barra pequeña. El precio
(price), la experiencia (experience) y los ajustes de la persona (adjustable) se escriben a mano en el código: mira
Temas de la app.