Skip to content

chore(Guides): Icons contribution guide#2629

Open
yceballost wants to merge 6 commits into
productionfrom
icons-guide
Open

chore(Guides): Icons contribution guide#2629
yceballost wants to merge 6 commits into
productionfrom
icons-guide

Conversation

@yceballost
Copy link
Copy Markdown
Collaborator

@yceballost yceballost commented Apr 30, 2026

Pull Request Description: chore(Guides): Icons contribution guide

This pull request introduces a comprehensive "Icons Contribution Guide" to streamline the process of adding new icons to the Mística Design System. The motivation behind this change is to provide clear, step-by-step instructions that encompass the entire workflow—from creating an issue to importing the final icons into the mistica-web project.

Key Improvements:

  1. Structured Process: The guide outlines a detailed process that spans multiple repositories and Figma libraries, ensuring that contributors can keep everything in sync and follow a consistent workflow.

  2. Enhanced Collaboration: By specifying the need for reviews and approvals from the design ops team at various stages, the guide fosters collaboration and maintains high-quality standards for icon design.

  3. Automation Steps: The guide includes instructions for running automated workflows, such as the Figma export action, which reduces manual effort and minimizes errors during the icon creation process.

  4. Clarity and Accessibility: The inclusion of visual aids, such as flowcharts and clear section indexing, makes it easier for both new and experienced contributors to navigate the contribution process effectively.

By implementing this guide, we aim to facilitate a more efficient and organized approach to icon contributions, ultimately enhancing the overall quality and consistency of the Mística Design System.

@yceballost yceballost marked this pull request as ready for review April 30, 2026 16:52
@yceballost yceballost linked an issue Apr 30, 2026 that may be closed by this pull request
@yceballost yceballost requested a review from AnaMontes11 May 4, 2026 09:32

The icon flow involves three repositories and two Figma libraries, so it is important to follow the steps in order to keep them in sync.

## Index
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

El orden de los pasos cambió en el texto (5 = export action, 6 = sync keywords) pero el índice se quedó con el orden antiguo. Índice corregido:

## Index

- [Process overview](#process-overview)
- [1. Create the issue](#1-create-the-issue)
- [2. Add the icon to the brand library in Figma](#2-add-the-icon-to-the-brand-library-in-figma)
- [3. Publish the brand library](#3-publish-the-brand-library)
- [4. Add the icon to the Mística Icons library in Figma](#4-add-the-icon-to-the-mística-icons-library-in-figma)
- [5. Run the Figma export action in mistica-icons](#5-run-the-figma-export-action-in-mistica-icons)
- [6. Sync icon keywords in Figma](#6-sync-icon-keywords-in-figma)
- [7. Review and merge the auto-generated PR](#7-review-and-merge-the-auto-generated-pr)
- [8. Import the icons in mistica-web](#8-import-the-icons-in-mistica-web)

Ojo también con el "(see step 6)" dentro de la sección de keywords: debería ser "(see step 5)" con el nuevo orden.

@AnaMontes11
Copy link
Copy Markdown
Contributor

AnaMontes11 commented Jun 3, 2026

@yceballost estoy bloqueada en el paso de incluir los keywords. Creo que el problema es de configuración y no puedo desbloquearlo desde mi lado. Lo dejo en standby hasta que podamos revisar qué puede estar fallando.

Resumen de lo que he comprobado:

  • Los iconos (rank, equal, ring) y sus keywords ya están en production desde la PR #355.
  • Los componentes existen en la librería Mística Icons en Figma (brand icons+master icons). revisados que funcionan bien.
  • Guía actualizada con todo el proceso de la parte de Figma.
  • Guía actualizada en la librería de Default Icons Set

El problema es que no consigo crear las keywords en la librería Mística Icons (antes se metían en Default icons Set o al menos eso ponía en la guía de figma).
Dos cosas que fallan y que creo apuntan a la misma causa (la fuente/librería que se usa no es la correcta):

  1. Export action (figma-export.yml): la variable MISTICA_ICONS_FILE_URL apunta al archivo "Default-Icons-Set" (JXy7Y07eb0Axg0ThVRWKju), no al de "Mística Icons" (JHuzksh01yxExMeMQBvymq). Por eso el export da changed=false y no genera PR. Runs: #623 y #622.
  2. Plugin de sync de keywords: al ejecutarlo sobre la página de Mística Icons, solo ha actualizado las descripciones de UN icono, esto no sé por qué puede estar pasado. Puede ser por nombres que no casan con las claves del JSON, por la página, o porque el plugin también esté leyendo de la librería que no toca.

Mi sospecha es que la migración de fuente (Default Icons Set -> Mística Icons) está a medias y afecta tanto al export como al plugin.

Necesito que confirmes:

  • Cuál es el archivo de Figma correcto que deben usar el export y el plugin.
  • Si es Mística Icons, actualizar MISTICA_ICONS_FILE_URL y revisar el plugin.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

How to include icons in Mística guide

2 participants