Guía
¿Vas a rehacer tu sitio? Extrae primero su sistema de diseño
Rehacer un sitio, cambiar de marca o pasar a un framework nuevo es el momento en que un sistema de diseño se pierde sin hacer ruido. Los colores viven en CSS antiguo, la escala tipográfica en la cabeza de alguien, los estados de los botones en un componente que nadie quiere abrir.
Extrae tu sitio actual como DESIGN.md antes de cambiar nada. Obtienes una base escrita para la nueva versión, que pueden leer tanto tu equipo como tu agente de programación.
Escrita para equipos que planean rehacer su sitio, cambiar de marca o migrar. Actualizada el .
Qué vas a conseguir
- Un DESIGN.md de tu sitio actual, con commit antes de la primera línea de la nueva versión.
- Una visión clara de lo que el archivo capturó y de lo que no.
- Una lista de lo que revisar a mano: recursos, estados, movimiento, breakpoints y páginas detrás de un inicio de sesión.
- Una forma de comparar el sitio nuevo con el antiguo cuando termines.
Cuándo hacerlo
- Un cambio de framework. El mismo aspecto, otro stack. El DESIGN.md permite a tu agente de programación reconstruir los componentes con los valores exactos en lugar de leer hojas de estilo antiguas.
- Un cambio de marca. Captura primero el sistema antiguo para saber exactamente qué colores, fuentes y radios cambian y cuáles se quedan.
- Un traspaso. Una agencia nueva o un equipo nuevo recibe un archivo que describe cómo se ve el sitio hoy, en lugar de un recorrido por el código.
Pasos
Extrae el sitio en vivo antes de cambiar nada
Pega la URL de producción en la página de inicio de Design Extractor y haz una extracción Pro. Tiene que ser una página pública: la extracción la carga como un visitante, así que localhost y las páginas detrás de un inicio de sesión no funcionan.
Haz commit como base
Guárdalo como DESIGN.md en el repositorio nuevo y haz commit antes de empezar a rehacer el sitio. A partir de ahí registra cómo se veía el sitio ese día.
Lee la sección Known Gaps
El final del archivo enumera lo que la extracción no pudo capturar. Cada punto de esa lista es algo que revisar a mano.
Revisa lo que un DESIGN.md no puede contener
Recursos, pantallas con sesión iniciada, movimiento y los demás puntos de abajo. Añade notas al archivo sobre la marcha.
Construye a partir de él
Apunta a tu agente de programación al archivo, como muestra la guía de Claude Code y Cursor, y revisa cada pantalla nueva con él.
Lo que capturó el archivo de Stripe
Para ver lo que obtienes, mira el DESIGN.md de Stripe en la galería. Su extracción Pro capturó 5 páginas de stripe.com: /nl, /nl/pricing, /nl/products, /nl/newsroom/news/stripe-openai-instant-checkout, /nl/contact/sales. Una extracción de tu propio sitio genera la misma estructura.
| Colores | 21 tokens, cada uno con su rol |
|---|---|
| Tipografía | 17 estilos en Sohne |
| Radios | 10 tokens |
| Espaciado | 62 tokens |
| Componentes | 71 recetas en HTML y CSS. Pasaron la comprobación con la página en vivo: 44. Marcadas o no comprobables, cada una con el motivo: 27 |
| Secciones | Overview, Colors, Typography, Layout, Elevation & Depth, Shapes, Components, Do's and Don'ts, Responsive Behavior, Iteration Guide, Known Gaps |
Lo que dice que no captó
El archivo es honesto sobre sus límites. Los primeros 5 de 11 puntos de su sección Known Gaps:
## Known Gaps
- **Many recipes did not reproduce exactly.** `button-primary` (84% pixel match), `card` (78%), `card-2` (94%), `promo-banner` (77%) and `skip-link` (0%; it is visually hidden until focused) are approximations. So are several header and footer recipes (`header-landing`, `header-inner-2` timed out, `footer-landing`, `footer-inner`, `footer-inner-2`).
- **Some recipes could not be judged at all.** `stat` and `stat-2` were not verifiable, because page media covered most of the element.
- **Some elements were never visible.** `footer-landing`, `header-inner` and `logo-strip-item` were not visible when verification ran, so their values come from computed styles only.
- **No section rhythm was measured.** `sectionRhythm` is empty, so vertical spacing between page sections and the inner padding of large cards is described only qualitatively.
- **No `base` spacing step was published.** The evidence frequency (4px, 8px, 12px, 16px and 24px most common) suggests a 4px-derived grid, but it is not a verified token.Extraído del sitio web público de Stripe, no es una guía de marca oficial. Leer el DESIGN.md completo de Stripe
Tu propio archivo tendrá su propia lista. Úsala como lista de tareas para las comprobaciones de abajo.
Qué revisar a mano
| Elemento | Por qué puede faltar en el archivo | Qué hacer |
|---|---|---|
| Logo, iconos, imágenes | Un DESIGN.md describe estilos, no archivos. | Expórtalos de la base de código actual y guárdalos con la nueva. |
| Pantallas con sesión iniciada | La extracción solo ve páginas públicas. | Anota en qué se diferencia la app del sitio de marketing, como tablas más densas o una barra lateral. |
| Estados | Hover y focus se registran donde la extracción los vio; los estados pulsado, desactivado y de error a menudo no. | Recorre formularios y botones y anota los estados que faltan. |
| Movimiento | Las transiciones y animaciones se describen como mucho con palabras. | Anota las duraciones y el easing a partir del CSS actual. |
| Breakpoints | La extracción captura un ancho de escritorio y uno de móvil. | Revisa el diseño en tablet y anota dónde cambian las columnas. |
| Plantillas fuera de la muestra | Pro recorre unas cinco páginas clave. | Extrae por separado cualquier página que se vea distinta, como la documentación o el proceso de pago. |
Después de rehacer el sitio
Cuando el sitio nuevo esté publicado, extráelo de nuevo y compara los dos archivos. Los tokens sin cambios significan que el aspecto se mantuvo; los que cambiaron son o el cambio de marca que planeaste o una desviación que corregir.
Cualquier diff de texto muestra los valores hex y los tamaños que cambiaron. El paquete @google/design.md de Google añade un comando diff que compara dos versiones token a token; la explicación de DESIGN.md cubre el formato y sus herramientas. Si editas el archivo a mano durante el proceso, compruébalo con el validador de DESIGN.md.
Archivos usados en esta guía
Abre uno para ver un DESIGN.md completo, desde los tokens del principio hasta los Known Gaps del final.
Finanzas y fintechStripe
Stripe, el sitio de marketing de la página principal, usa un sistema de diseño muy controlado (HDS, Stripe Design System) basado en la fuente variable "sohne-var" en pesos ligeros (300–400), una paleta de marca que va del azul marino profundo al índigo, anclada en #533afd (Stripe Indigo), y un característico degradado espectral a sangre completa en el encabezado. Los componentes tienen radios bajos (4–6 px), sombras planas o mínimas y se estructuran en torno a una cuadrícula base de 8 px. El tono general es autoritario pero cercano: infraestructura financiera comunicada mediante una tipografía segura de sí misma y un uso contenido del color.
Servicios profesionales y empresarialesShopify
La página de inicio de marketing de Shopify utiliza un vídeo de cabecera a pantalla completa de gran dramatismo, con un fondo casi negro (#02090a) que contrasta con fuerza con la barra de navegación blanca situada encima. El color de acento principal es un verde menta vibrante (#36f4a4), empleado con moderación para destacados y estados interactivos. La tipografía se reparte entre NeueHaasGrotesk, para los títulos de impacto y editoriales, e Inter-Variable, para el texto de interfaz y el cuerpo. Los botones de llamada a la acción tienen forma de píldora totalmente redondeada (border-radius: 9999px). En conjunto, el sistema transmite seguridad, alto contraste y aspiración, y está pensado para convertir a los visitantes en comerciantes.
Desarrollo e infraestructura · Developer Tools & IDEsSupabase
Supabase utiliza un sistema de diseño con prioridad al modo oscuro, anclado en un fondo casi negro y profundo (oklch ~0.19) con un acento verde vivo de marca (#3ecf8e / #3fcf8e). La disposición se organiza en una cuadrícula responsiva de tarjetas de funciones. Manrope se usa para los títulos de presentación e Inter para el texto de cuerpo y la interfaz, mientras que Source Code Pro se encarga de todos los contextos monoespaciados y de código. El sistema de color se basa en propiedades personalizadas de oklch con nombres semánticos. Las tarjetas tienen un radio de 12px con un tratamiento de borde sutil, los botones usan un radio de 6–8px, y la densidad general es moderada, con una cuadrícula base de espaciado de 8px.
Preguntas frecuentes
Extrae tu sistema de diseño antes de rehacer el sitio: preguntas
Respuestas breves a lo que la gente pregunta antes de probarlo.
No. Un DESIGN.md es un archivo de texto que describe estilos: colores, tipografía, espaciado, radios y recetas de componentes en HTML y CSS. Exporta el logo, los iconos, las ilustraciones y las fotos de tu base de código o de tus archivos de diseño actuales y guárdalos junto a él.
No. La extracción carga la página a partir de su URL como lo haría un visitante, así que no se admiten páginas detrás de un inicio de sesión, en localhost o en una red privada. Extrae el sitio público y anota en qué se diferencian las pantallas con sesión iniciada.
Pro recorre las páginas clave del sitio, unas cinco, y combina lo que encuentra en un DESIGN.md. Si una plantilla importante no está entre ellas, como una página de documentación o un proceso de pago, extrae también la URL de esa página y compara los dos archivos.
Extrae el sitio nuevo cuando esté publicado y compara los dos archivos. El paquete @google/design.md de Google tiene un comando diff que compara dos versiones de un DESIGN.md token a token, y cualquier diff de texto muestra los valores hex y los tamaños que cambiaron.
Captura tu sitio antes de cambiarlo
Pega la URL de producción. Una extracción Pro recorre sus páginas clave y devuelve un DESIGN.md.
Guías relacionadas
Haz que Claude Code y Cursor creen interfaces iguales a una web
Extrae un sitio que te guste, pon su DESIGN.md en tu repositorio y apunta a él a tu agente, con los prompts exactos para Claude Code y Cursor.
¿Sin diseñador? Toma prestado un sistema de diseño probado para tu app
Cómo elegir un sitio de referencia, qué conservar de su DESIGN.md y qué cambiar para que el resultado sea tuyo y no una copia.
Combina dos sitios de referencia en un solo diseño para un prototipo
Compara dos archivos DESIGN.md extraídos token a token y combínalos en una especificación para un prototipo, a mano o con tu agente.
Dale a tu agente de programación especificaciones de diseño bajo demanda con MCP
Conecta el servidor MCP para que tu agente pueda extraer el DESIGN.md de un sitio por su cuenta, esperar a que termine y trabajar a partir de él.