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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

Colores21 tokens, cada uno con su rol
Tipografía17 estilos en Sohne
Radios10 tokens
Espaciado62 tokens
Componentes71 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
SeccionesOverview, 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:

Del final del DESIGN.md de Stripe, tal como está escrito.
## 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

ElementoPor qué puede faltar en el archivoQué hacer
Logo, iconos, imágenesUn 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 iniciadaLa 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.
EstadosHover 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.
MovimientoLas transiciones y animaciones se describen como mucho con palabras.Anota las duraciones y el easing a partir del CSS actual.
BreakpointsLa 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 muestraPro 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.

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.

Ver todas las guías de DESIGN.md