Rappi Sheets Sync

About this plugin

Rappi Sheet Sync es una herramienta desarrollada a la medida para la empresa Rappi, diseñada para optimizar el flujo de trabajo de nuestros diseñadores de producto y contenido.

Este plugin permite poblar diseños en Figma masivamente utilizando datos reales de nuestras hojas de cálculo de Google Sheets, asegurando consistencia y agilidad en la creación de mockups, banners y prototipos.

COLUMNAS DE INYECCIÓN (Sin Símbolo)

Estas columnas controlan qué componentes se crean dentro de un Frame (Modo Página).

Nombre Ejemplo Columna: BANNERHOME

Valor Ejemplo Fila: VERTICAL

Acción en figma: Busca un componente llamado BANNERHOME=VERTICAL e inyecta una instancia

COLUMNAS DE SINCRONIZACIÓN GLOBAL (Tags Simples #)

Usadas para actualizar propiedades de texto, color o imagen, independientemente del componente en el que se encuentren (dentro del alcance del Frame).

Nombre Ejemplo Columna: TITULO

Valor Ejemplo Fila: Oferta del Día

Acción en figma: Reemplaza el texto del nodo de nombre #TITULO.

COLUMNAS DE SINCRONIZACIÓN CON SCOPE (Target Específico)

Esta es la funcionalidad avanzada para evitar conflictos. Usa la sintaxis #PREFIJO TAG para apuntar a un componente específico (padre) y sincronizar un nodo (hijo) dentro de él.

Nombre Ejemplo Columna: #CARD_PROMO TITULO

Valor Ejemplo Fila: Producto 50% OFF

Acción en figma: Cualquier instancia que inicie con CARD_PROMO (ej. CARD_PROMO=A), toma El nodo #TITULO DENTRO de esa instancia.

CONTROL DE VISIBILIDAD

El plugin puede controlar las propiedades de componentes (Variantes y Toggles) utilizando la misma sintaxis de Tags (#).

CONTROL DE VISIBILIDAD

Para ocultar o mostrar una instancia, se utiliza el valor de la celda:

Nombre Ejemplo Columna: TITULO

Valor Ejemplo Fila: VACIO | si es una instancia debe ser: NO, OFF, FALSE

Acción en figma: OCULTAR TITULO

Control de Variantes Múltiples (El "Smart Match")

Para cambiar el estado de un componente, el plugin automáticamente busca la propiedad que acepte el valor de la celda.

Casos de Combinación (Separador Coma)

Si un componente tiene múltiples propiedades (Color, Tamaño, Estado), usa la coma (,) para enviarlos todos en una celda.

Nombre Ejemplo Columna: Cintas_System_Rappi

Valor Ejemplo Fila: Rojo,Small

Propiedades en figma: Color:[Rojo, Azul], Tamaño:[Small, Large]

Acción en figma: Color=Rojo y Tamaño=Small

Casos de Conflicto (Variantes con valores iguales)

Si dos propiedades tienen el mismo valor (ej. Color Texto: Azul y Color Fondo: Azul), debes usar una Pista seguida de dos puntos (:) :

Nombre Ejemplo Columna: Cintas_System_Rappi

Valor Ejemplo Fila: Color:Rojo,Tamaño:Small,Fondo:Rojo

Propiedades en figma: Color:[Rojo, Azul], Tamaño:[Small, Large], Fondo:[Rojo, Azul]

Acción en figma: Color=Rojo, Tamaño=Small y Fondo:Rojo