El reto
Cerrar la brecha entre el diseño en Figma y la ingeniería frontend de una startup en pleno crecimiento: un sistema único y coherente que acelerara el time-to-market sin frenar la evolución del producto.
En PinsXP, los usuarios guardan sus lugares favoritos, crean itinerarios de viaje o planes y comparten momentos en grupo con sus amigos. La startup crecía a gran velocidad y eso abría una brecha cada vez mayor entre el equipo de diseño en Figma y los ingenieros de frontend, que ralentizaba el time-to-market.



El problema
Inconsistencias visuales
Tarjetas de lugares guardados, creación de grupos o listados de planes se resolvían de formas distintas en cada pantalla.Componentes duplicados
La falta de estandarización multiplicaba las variantes de un mismo componente y ralentizaba la creación de nuevos flujos.Fricción en el handoff
La entrega de flujos complejos de interfaz, como los estados vacíos o el cambio entre modo claro y oscuro, consumía demasiado tiempo operativo.
Metodología end-to-end
Abordé el proyecto con una metodología sistemática, dividida en tres fases clave.
Auditoría y discovery
Mapeo exhaustivo de los componentes existentes y detección de las fricciones en el traspaso (handoff) entre diseño y desarrollo.Arquitectura de tokens
Una jerarquía limpia de variables avanzadas en Figma, con tokens primitivos y semánticos, para soportar la escalabilidad multiplataforma.IA y workflows avanzados
Incorporé Claude Code y el protocolo Figma MCP (Model Context Protocol) para automatizar la sincronización de especificaciones técnicas, validar tokens en tiempo real y acelerar la traducción de los elementos visuales a código limpio.
La solución: Compass
Diseñé la estrategia y la arquitectura de un sistema de diseño pensado para crecer con el producto.


Lo llamé Compass porque funciona como una brújula: guía a diseño e ingeniería en una misma dirección para que guardar, compartir y descubrir lugares mantenga siempre el mismo pulso visual y de usabilidad.
Estructura en Figma
Componentes altamente modulares apalancados en Auto Layout, propiedades avanzadas de componentes y variables semánticas.Accesibilidad y escalabilidad
Estándares de accesibilidad (WCAG) desde la raíz del sistema, con componentes inclusivos y listos para producción.
Conexión diseño-código con Figma MCP y Claude Code
- Flujos asistidos por IA que automatizan la revisión de la consistencia de los tokens.
- Menos ambigüedad en la documentación técnica: ingeniería consume directrices y estructuras sincronizadas directamente desde el ecosistema de diseño.
Resultados e impacto
COMPASS · PinsXP Design System
Panel de propiedades en Figma
Primitivas
primitives308 variablesLa paleta cruda de valores fijos (colores, escalas y medidas) que sirven como cimiento inalterable del sistema.
primary colors / base
| Nombre | Valor |
|---|---|
| white | #FFFFFF |
| black | #171717 |
| transparent | #FFFFFF20% opacidad |
| overlay | #00000080% opacidad |
primary colors / dark cyan lime green
- 50#F0FDF5
- 100#DCFCE8
- 200#BBF7D1
- 300#86EFAD
- 400#4ADE81
- 500#22C55E
- 600#16A34A
- 700#15803C
- 800#166533
- 900#14532B
- 950#052E14
primary colors / gray blue
- 50#F8FAFC
- 100#F1F5F9
- 200#CBD5E1
- 300#94A3B8
- 400#7588A2
- 500#64748B
- 600#4A5565
- 700#334155
- 800#1E293B
- 900#0F172A
- 950#030712
Más grupos
- spacing 35
- width 33
- radius 10
- opacity 21
- blur 8
- font 47
Semánticas
semantics232 variablesCapa lógica que asigna un propósito funcional a cada valor (ej. fondos, textos, bordes o estados), permitiendo una gestión limpia y automatizada entre el Light Mode y el Dark Mode sin romper la coherencia visual.
| Nombre | Light mode | Dark mode |
|---|---|---|
| colors / brand | ||
| primary | dark cyan lime green/600 #16A34A | dark cyan lime green/600 #16A34A |
| secondary | dark cyan lime green/800 #166533 | dark cyan lime green/800 #166533 |
| tertiary | dark cyan lime green/300 #86EFAD | dark cyan lime green/300 #86EFAD |
| colors / background | ||
| primary | base/white #FFFFFF | base/black #171717 |
| secondary | dark cyan lime green/100 #DCFCE8 | dark cyan lime green/100 #DCFCE8 |
| tertiary | gray blue/100 #F1F5F9 | gray blue/100 #F1F5F9 |
| input | base/white #FFFFFF | base/black #171717 |
| overlay | base/overlay #000000 | base/overlay #000000 |
| colors / background / status | ||
| error | error/50 #FEF2F2 | error/950 #55160C |
| success | success/50 #F0FDF4 | success/950 #052E16 |
| info | blue/50 #ECFAFF | blue/950 #083344 |
| colors / text | ||
| primary | gray blue/950 #030712 | base/white #FFFFFF |
| secondary | dark cyan lime green/800 #166533 | dark cyan lime green/600 #16A34A |
| body | gray blue/600 #4A5565 | gray black/100 #F5F5F5 |
| placeholder | gray black/500 #737373 | gray black/400 #A3A3A3 |
| colors / border | ||
| default | gray black/600 #525252 | gray black/600 #525252 |
| separator | gray black/200 #E5E5E5 | gray black/800 #262626 |
Velocidad de entrega
Los tiempos de implementación de nuevas vistas y componentes bajaron de forma notable gracias a la automatización del handoff con Claude Code y el MCP.Coherencia visual
Se eliminó más del 80 % de la deuda técnica de diseño y la experiencia de usuario quedó unificada en toda la plataforma de PinsXP.Escalabilidad sostenida
Un sistema listo para crecer con los futuros requerimientos de la startup sin comprometer la calidad de la interfaz.
Próximos pasos
Llevar Compass a la web (desktop y responsive)
A medida que PinsXP crece, los usuarios necesitan gestionar sus itinerarios y colecciones compartidas con más comodidad desde pantallas grandes. El reto: trasladar el ecosistema móvil a una experiencia web robusta y responsive.
Retícula y breakpoints
Una nueva capa de componentes web en Figma con retículas flexibles, breakpoints claros y densidades de información pensadas para escritorio, sin perder la paridad visual con la app.Componentes web-ready
Inspirados en shadcn/ui: tablas de itinerarios, menús desplegables de grupos, modales anidados y navegación lateral que se sientan nativos en web y en móvil.Coherencia de marca
La misma filosofía de brújula para que recordar y compartir momentos sea igual de fluido en el móvil y en el ordenador.
