Maqueta en Penpot
Metodología para el diseño de maquetas en Penpot. Ejecutar con Penpot MCP según penpot-design (componentes, flex, API, árbol de afuera hacia adentro). Leer high_level_overview una vez antes de escribir.
Preguntar primero
Detenerse si falta algo:
- Objetivo y alcance — ¿sitio web, aplicación móvil, aplicación de escritorio o responsive? ¿Qué pantalla(s) o flujo?
- Audiencia — ¿quién lo usa? (ej. usuarios mayores → tipo de letra más grande, navegación más simple)
- Fidelidad —
baja(estructura, diseño, flujo) oalta(color, tipografía, imágenes, pulido)? - Plataforma — móvil, web, escritorio o responsive. Usar reglas del proyecto si están definidas; si no, preguntar. Nunca asumir.
- Instrucciones — qué construir/cambiar. Variantes multi-alternativa solo si se pide.
Maqueta vs wireframe vs prototipo
| Etapa | Propósito | Enfoque en Penpot |
|---|---|---|
| Wireframe | Diseño, jerarquía, flujo de usuario — sin pulido visual | Formas simples, placeholders, espaciado real |
| Maqueta | Diseño visual — apariencia y sensación, detalles de UI | Este skill |
| Prototipo | Interactividad — clics, flujos, estados | Solo cuando el usuario lo pida; usar variantes para estados |
Por defecto, realizar maquetas visuales estáticas a menos que el usuario solicite comportamiento interactivo o de prototipo.
Fidelidad
Baja fidelidad — validar estructura y flujo rápidamente. Rellenos simples, placeholders, diseño alineado a cuadrícula. Iterar diseño y flujo de usuario antes del pulido. Se asigna al modo mockup en penpot-design.
Alta fidelidad — lista para cliente o entrega a desarrollo. Paleta de colores, tipografía, imágenes, componentes de marca. Se asigna al modo design en penpot-design.
Flujo de trabajo de seis pasos
Trabajar en este orden. No saltar al pulido antes de validar la estructura.
- Definir objetivo y alcance — propósito, audiencia objetivo, restricciones de plataforma.
- Wireframe — delinear secciones, áreas de contenido, navegación, CTAs con placeholders. Enfocarse en jerarquía y flujo.
- Sistema de cuadrícula — alinear elementos; espaciado consistente (escala de 8dp según
penpot-design). Establecer jerarquía visual (título > texto de apoyo). - Color y tipografía — paleta limitada; tipo de letra legible (tamaño, altura de línea, espaciado entre letras); contraste suficiente. Ver mockup-practices.md.
- Componentes de UI — botones, campos de entrada, barras de navegación, iconos. Aparece dos veces → componente. Estados → variantes. La ubicación y el tamaño importan para la usabilidad.
- Refinar detalles — imágenes, iconografía, espaciado, contraste. Exportar con
export_shapepara verificar.
Ensamblaje del lienzo (obligatorio)
La metodología anterior define qué decidir. Al dibujar en Penpot, seguir el orden de afuera hacia adentro de penpot-design — no inventar una secuencia de capas diferente:
- Tablero/contenedor de pantalla (vacío + flex)
- Capas de sección hijas directas (encabezado, cuerpo, pie de página, …) en orden z
- Componentes de cada sección, luego los elementos de esos componentes, recursivamente
Nunca crear hojas primero y envolverlas. Regla completa: ../penpot-design/references/build-order.md.
Mejores prácticas
- Centrado en el usuario — diseñar para los objetivos del usuario; considerar personas y puntos de fricción en el recorrido.
- Accesibilidad — tipo de letra legible, contraste suficiente, evitar significado solo con color; estructura navegable por teclado cuando corresponda.
- Consistencia visual — una guía de estilo: tipografía, colores, espaciado, iconos en todas las pantallas.
- Mundo real — considerar tamaños y orientaciones de pantalla; diseños responsive cuando la plataforma sea multi-dispositivo.
- Retroalimentación iterativa — priorizar retroalimentación procesable sobre diseño, tipo de letra, color y flujo por encima del pulido subjetivo.
Lista de verificación de componentes principales
Cada maqueta de pantalla debe abordar:
- Diseño y composición (cuadrícula, alineación, jerarquía)
- Color y tipografía (paleta, tipo de letra legible)
- Componentes de UI e iconos (CTAs, campos de entrada, navegación — componentizados)
- Imágenes y medios (relevantes, sin saturar)
- Marca (logotipo, colores, tipo de letra consistentes con la marca)
Dificultades
| Desafío | Respuesta |
|---|---|
| Demasiado detalle demasiado pronto | Mantenerse en baja fidelidad hasta que el diseño y el flujo estén validados |
| Limitaciones (tiempo, tecnología, presupuesto) | Enfocar funcionalidades MVP; reutilizar componentes del sistema de diseño |
| Desalineación con interesados | Presentar justificación; vincular decisiones a objetivos del usuario |
Referencia detallada: mockup-practices.md.
Hecho
- Objetivo, audiencia, fidelidad, plataforma, instrucciones confirmados
- Estructura antes que pulido (wireframe → cuadrícula → tokens → componentes → detalles)
- Lienzo de afuera hacia adentro (contenedor → capas hijas → elementos anidados)
- Centrado en el usuario, accesible, visualmente consistente
- Componentes/variantes según
penpot-design; exportación verificada