Buenas prácticas

Introducción

Es fundamental entender que para implementar y aprovechar un sistema de diseño, necesitamos seguir una serie de normas y buenas prácticas. El objetivo principal de Energy es enmarcar y dirigir el uso del lenguaje digital. Esto no solo contribuye a la consistencia visual y a la usabilidad, sino que también asegura que todas las interacciones digitales estén alineadas con los objetivos y la identidad de Repsol.

1. No podemos inventarnos cosas

En ocasiones el sistema puede parecer que no responde a nuestras necesidades.
En estos casos, podemos emprender algunas exploraciones para resolver el problema en cuestión, pero es crucial que validemos estas soluciones con el sistema para ver si hay algún elemento ya existente que pueda proporcionar una solución.

Además, tenemos una visión más amplia de otros proyectos, por lo que podemos sugerir o proporcionar soluciones que otros equipos ya han implementado.

TIP! Revisa siempre la documentación
Podrás ver ejemplos, y las options que permite el componente.

2. Nunca usar los fragmentos de forma descontextualizada

El propósito del fragmento es servir a su componente. El fragmento se define dentro del componente, no debe usarse fuera de ese contexto. Puede usarse de inspiración o referencia para realizar exploraciones, pero una vez validados, hay que alinearse con el sistema.

3. No usar librerías de app en web mobile

Si estamos en web mobile debemos tener en cuenta los siguientes puntos:

  • No usamos componentes de app para web mobile. Son librerías distintas, con patrones de interacción distintos. Los componentes Core tienen modo de variable mobile.
  • Podemos usarlos como referencia, y pueden llegar a formar parte de la librería de web, pero hace falta validar.
TIP! Revisa que el archivo tenga las librerías conectadas correctamente
En general, recomendamos no conectar librerías de entornos que no son parte del producto (email para una web, data viz si no vamos a diseñar data...)

4. No posicionar contenidos sobre un componente

Al utilizar un componente, si este no cubre nuestra necesidad:

  • No deberíamos posicionar elementos por encima del componente ocultando los existentes para adaptarlo a nuestro caso de uso
  • En la mayoría de casos se puede hacer swap o adaptar el componente sin detachear
    Podemos proponer mejoras o modificaciones al sistema
TIP! Recuerda que puedes hacer componente locales
Hasta más o menos un 20% de los componentes podrían ser específicos del producto mientras usen las foundations y los elementos Core de Energy.

5. Respeta los límites en la modificación de estilos

Al reutilizar componentes, deberíamos consultar en la documentación hasta dónde está permitido hacer ajustes en tokens de color y texto. Por lo general:

  • Los tokens de color no se deben eliminar/modificar
  • En algunos casos se puede ajustar tamaños de texto mientras se mantenga la jerarquía (titular-body-caption)

Modelo de gobernanza

Conoce los pilares de la gobernanza del sistema para construir de forma armoniosa los productos de Repsol

Ver en Figma

Contacto

¿Tienes alguna pregunta sobre nuestro sistema de diseño? El equipo de Energy está aquí para ayudarte