Documentación

Guías para usuarios y desarrolladores de Midori Marketplace.

Para Usuarios

Instalar un Tema

  1. Navega en el Marketplace y filtra por "Temas".
  2. Haz clic en el tema que te guste para previsualizarlo.
  3. Haz clic en "Instalar" para aplicarlo a tu nueva pestaña.
  4. El tema se aplicará automáticamente. Abre una nueva pestaña para ver los cambios.

Instalar un Fondo de Pantalla

  1. Navega en el Marketplace y filtra por "Fondos".
  2. Haz clic en un fondo para ver una vista previa completa.
  3. Haz clic en "Instalar" para establecerlo como fondo de tu nueva pestaña.
  4. Abre una nueva pestaña para disfrutar de tu nuevo fondo.

Instalar un Widget

  1. Navega en el Marketplace y filtra por "Widgets".
  2. Haz clic en un widget para previsualizar su funcionalidad.
  3. Haz clic en "Instalar" para añadirlo a tu nueva pestaña.
  4. El widget aparecerá en tu nueva pestaña. Puedes reposicionarlo o eliminarlo desde la configuración.

Instalar una Animación

  1. Navega en el Marketplace y filtra por "Animaciones".
  2. Haz clic en una animación para verla en acción.
  3. Haz clic en "Instalar" para activar la animación en tu nueva pestaña.

Gestionar tus Extensiones

  • Puedes ver y gestionar todas las extensiones instaladas desde la configuración de tu nueva pestaña de Midori.
  • Para desinstalar una extensión, ve a la configuración y haz clic en "Eliminar" junto al elemento.
  • Las extensiones se actualizan automáticamente cuando el desarrollador publica una nueva versión.

Para Desarrolladores

Asset Contract (Esquema)

Toda extensión publicada en Midori Marketplace debe cumplir con el Midori Asset Contract. Este esquema JSON define la estructura de los metadatos de tu extensión.

{
  "schemaVersion": "1.0.0",
  "kind": "midori-asset",
  "type": "theme | wallpaper | widget | animation",
  "id": "my-awesome-extension",
  "slug": "my-awesome-extension",
  "name": "My Awesome Extension",
  "status": "published",
  "compatibility": { ... },
  "distribution": { ... },
  "payload": { ... }
}

Crear un Tema

  1. Define un archivo JSON con tipo "theme" siguiendo el esquema del Asset Contract.
  2. Configura tu paleta de colores en el payload: colores primario, secundario, de fondo y acento.
  3. Incluye una captura de pantalla de vista previa (1280×800 recomendado) para el listado del Marketplace.
  4. Valida tu contrato usando la herramienta de validación proporcionada.
  5. Envíalo a través del Marketplace para revisión.

Crear un Fondo de Pantalla

  1. Prepara una imagen de alta calidad (mínimo 1920×1080, JPEG o WebP recomendado).
  2. Crea un contrato JSON con tipo "wallpaper" y referencia tu imagen en el payload.
  3. Incluye una miniatura para la vista previa del Marketplace.
  4. Valida tu contrato y asegúrate de que los tamaños de archivo estén dentro de los límites.
  5. Envíalo a través del Marketplace para revisión.

Crear un Widget

  1. Define un contrato JSON con tipo "widget" siguiendo el esquema del Asset Contract.
  2. Implementa tu widget HTML/CSS/JS dentro de la sección payload.
  3. Los widgets se ejecutan en un entorno aislado (sandbox). Solo las APIs aprobadas están disponibles.
  4. Prueba tu widget localmente en una versión de desarrollo de Midori Browser.
  5. Envíalo a través del Marketplace para revisión.

Crear una Animación

  1. Crea un contrato JSON con tipo "animation" siguiendo el esquema del Asset Contract.
  2. Define la animación usando animaciones CSS o JS ligero en el payload.
  3. Mantén las animaciones eficientes — evita manipulación pesada del DOM o archivos de recursos grandes.
  4. Envíalo a través del Marketplace para revisión.

Enviar al Marketplace

  1. Inicia sesión en el Marketplace con tu cuenta Astian.
  2. Ve a tu panel de desarrollador y haz clic en "Enviar Extensión".
  3. Sube tu JSON del Asset Contract y los recursos necesarios (imágenes, archivos).
  4. Completa los detalles del listado: descripción, etiquetas, licencia y capturas de pantalla.
  5. Envía para revisión. El equipo de Midori revisará y aprobará o solicitará cambios.

Directrices de Envío

  • Todas las extensiones deben seguir el esquema del Midori Asset Contract (versión 1.0.0).
  • Las extensiones no deben contener código malicioso, rastreadores ni permisos excesivos.
  • Proporciona descripciones claras y precisas e imágenes de vista previa de alta calidad.
  • Respeta la propiedad intelectual — no subas contenido que no te pertenezca o sobre el que no tengas derechos.
  • Las extensiones que violen las directrices serán eliminadas y la cuenta del desarrollador podrá ser suspendida.