Skip to content

fix(marca): Logo variant="flat" + auditoría y limpieza de los componentes de marca - #52

Merged
A-PachecoT merged 1 commit into
mainfrom
fix/branding-audit
Nov 4, 2026
Merged

A-PachecoT merged 1 commit into
mainfrom
fix/branding-audit

Conversation

@A-PachecoT

Copy link
Copy Markdown
Member

Por qué

André (2026-11-03): «¿están todos los components bien utilizados? ej el monochrome colors de Logo creo q no va, y hay varias cosas q están raras. audita y clean up y hazlo todo profesional». Y sobre la story Stacked: el panel «Mono oscuro · fondo claro» «no me hace sentido».

Causa: mono pinta las caras con currentColor a opacidades 1/0.7/0.5/… (relieve). Eso solo funciona en blanco sobre oscuro; en un color oscuro sobre claro la luz se invierte y la cara iluminada sale casi negra.

Auditoría (origin/main)

  1. src/stories/ui/Logo.stories.tsx:95 y LogoHeader.stories.tsx:112 — MonochromeColors: mono con relieve en primary/muted/amber. Uso inválido (luz invertida).
  2. LogoHeader.stories.tsx:183 — Stacked, panel «mono oscuro · fondo claro»: el mismo bug.
  3. logo.tsx:34 — no había variante de un color plano. Todo mono que no fuera blanco caía en el relieve.
  4. cofoundy-badge.tsx:90 — pill usa mono con relieve a 14 px en muted/50: a ese tamaño el relieve es ruido gris.
  5. Logo.stories.tsx:37-58 y LogoHeader.stories.tsx:50-66 — stories Small/Large/ExtraLarge/XXLarge que duplican AllSizes y los controles.
  6. Logo.stories.tsx:118 y :130 — WithBrandName e InHeader arman a mano un wordmark (más el tagline «Build with AI», que no es de marca) en vez de usar LogoHeader.
  7. Logo.stories.tsx:146 — LoadingWithLogo (logo con animate-pulse como loader): no es un patrón de la marca.
  8. LogoHeader.stories.tsx:144 — ThemeAdaptive es un duplicado de Default.
  9. LogoHeader.stories.tsx:211 y :229 — Wordmark className="h-6/h-8/h-12" y h-10: el Wordmark es texto, h-* no lo dimensiona y las tres filas se veían idénticas.
  10. logo-header.tsx:66-68 — wordmarkOnly/isologoOnly duplican <Wordmark>/<Logo>. Sin consumidores: los dejo deprecados.
  11. logo-header.tsx:113 y :135 — aria-label="Cofoundy" redundante sobre un <span> con el texto «Cofoundy».
  12. logo.tsx:64 — el SVG no tenía nombre accesible (sin role/aria-label). Ahora es role="img" «Cofoundy» por defecto, con aria-hidden donde va junto a texto (LogoHeader, CofoundyBadge y ChatHeader.tsx:51).
  13. logo-header.tsx:110 y :132 — estilo del wordmark duplicado → WORDMARK_STYLE.
  14. CofoundyBadge.stories.tsx:29, :71-89 y :101-106 — fondos y textos hardcodeados (#0d0d0d, text-white/30-40) en vez de tokens. Las stories Professional/Shimmer/Pill/Friendly duplicaban AllVariants.
  15. COMPONENTS.md:41 — sin regla de variantes. Mezclaba efectos (Shimmer/GradientBorder) en la fila de marca.
  16. Stories de tamaños y del header con el isologo color sobre el tema oscuro de Storybook: contradice identity.md §02 (sobre oscuro → white/pure-white).

Cambios

  • Logo: variant?: "color" | "mono" | "flat".
    • flat es un color plano (currentColor) con las caras separadas. Geometría: los 10 paths de handbook/positioning/BRAND/assets/isologo/isologo-pure-white.svg (make-pure-white.py).
    • mono (booleano) sigue funcionando y queda deprecado. variant gana sobre mono.
    • Se exportan LogoProps y LogoVariant.
    • La salida de color y mono es la misma que antes, salvo los atributos de a11y y data-variant.
  • LogoHeader: variant pasa al isologo; en mono y flat el wordmark usa currentColor. Deprecados: mono, wordmarkOnly, isologoOnly.
  • CofoundyBadge: pill → cubo flat; logos decorativos.
  • Stories: una por caso real, cada una con su regla.
    • Logo: Default, Sizes, Variants, SmallSizes.
    • LogoHeader: Default, Sizes, Variants, Stacked (color/claro · mono/oscuro · flat/color de cliente · flat oscuro/claro), StackedSizes, InHeader, WordmarkStandalone.
    • CofoundyBadge: Default, Prefijo, Variantes y cuándo usarlas, En un footer.
    • Helper BrandPanel con data-theme por tarjeta y sin colores literales.

Compatibilidad (grep de consumidores fuera de node_modules)

  • Logo (color, size, className): landing-page-v2, landing-page-v2-chatsim e inbox-ai-mcp. Sin cambios visuales.
  • LogoHeader mono size="lg": products/forms (3 pantallas, blanco sobre panel oscuro). Mismo render, y conserva las clases .cf-logo y .cf-logo-header de las que depende su CSS.
  • wordmarkOnly, isologoOnly, Wordmark, CofoundyBadge, *Variants: ningún consumidor.

Evidencia

  • Tests nuevos Logo.test.tsx (5) y LogoHeader.test.tsx (5), en verde.
  • Suite completa: los 3 rojos que quedan (ChatInput, chat-sim ×2) ya fallan en main.
  • build-storybook OK. Typecheck: ningún error en los archivos tocados; los 3 que quedan son de chat-sim/ShaderHero y ya estaban en main.
  • Capturé y revisé las 10 stories de marca.
  • BRAND: make-stacked.py (handbook) lee el nuevo FACES de logo.tsx y regenera los 6 archivos logo-stacked-* byte a byte idénticos (la geometría no cambió).
  • pm-pass: no aplica (variantes de marca, no un flujo humano).

https://claude.ai/code/session_01NqiCEUeGA5czNfuEY2uE24

…tories limpias por caso de uso

- Logo: variant "color" | "mono" | "flat". flat = un color plano con las caras separadas
  (geometría de BRAND/assets/isologo/isologo-pure-white.svg). mono (relieve por opacidad)
  queda para blanco sobre oscuro neutro: en un color oscuro la luz se invertía.
  `mono` booleano sigue funcionando (deprecado → variant="mono"). Accesible por defecto
  (role="img", «Cofoundy»); aria-hidden lo vuelve decorativo. Exporta LogoProps y LogoVariant.
- LogoHeader: variant pasa al isologo; wordmarkOnly/isologoOnly deprecados (usar Wordmark/Logo);
  quita aria-label redundante del wordmark; el isologo es decorativo junto al texto.
- CofoundyBadge pill: cubo flat en vez de mono a 14px; logos decorativos junto al texto.
- ChatHeader: el logo por defecto es decorativo (el nombre ya está al lado).
- Stories: una por caso real con su regla (Variants, SmallSizes, Stacked con color/claro,
  mono/oscuro, flat/color de cliente, flat oscuro/claro); fuera duplicados de tamaño,
  MonochromeColors, WithBrandName, LoadingWithLogo, ThemeAdaptive, Wordmark con h-*,
  fondos hardcodeados del badge.
- COMPONENTS.md: regla de variantes y deprecaciones.

Claude-Session: https://claude.ai/code/session_01NqiCEUeGA5czNfuEY2uE24
@A-PachecoT
A-PachecoT merged commit b4ae60f into main Nov 4, 2026
1 check passed
@A-PachecoT
A-PachecoT deleted the fix/branding-audit branch November 4, 2026 03:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant