Logos Argentina

Directorio de logos/favicons de entidades financieras argentinas para uso rápido en proyectos web.

La app permite:

• buscar entidades por nombre o dominio,
• filtrar por categoría,
• previsualizar y copiar endpoints/curls de Google y DuckDuckGo.

Documentación de API disponible en /docs al correr la app localmente.

Producción: https://loguitos.app — documentación en https://loguitos.app/docs.

Stack

• Next.js 16 (App Router)
• React 19 + TypeScript
• Tailwind CSS
• pnpm

Requisitos

• Node.js LTS (recomendado: 22+)
• pnpm instalado globalmente

Setup local

pnpm install
pnpm dev

Abrí http://localhost:3000.

Scripts disponibles

• pnpm dev: entorno de desarrollo
• pnpm lint: lint del proyecto
• pnpm build: build de producción
• pnpm start: correr build en modo producción
• pnpm indexnow:submit-all: notificar todas las URLs del sitemap a IndexNow
• pnpm indexnow:ping-changed: notificar solo URLs con <lastmod> cambiado

Hoy el proyecto no requiere variables de entorno obligatorias para ejecutarse localmente.

URL canónica (SEO)

Para override en otros entornos, definí NEXT_PUBLIC_SITE_URL. Sin esa variable, metadata, sitemap y robots.txt usan https://loguitos.app por defecto.

En producción (Vercel), conviene fijar explícitamente:

NEXT_PUBLIC_SITE_URL=https://loguitos.app

Sitemap y Google Search Console

El build genera public/sitemap.xml (archivo estático) y valida el XML en postbuild. La ruta pública es:

https://loguitos.app/sitemap.xml

Si Search Console muestra Couldn't fetch después de un deploy:

1. Verificá en vivo con inspección de URL que el sitemap devuelva 200 y XML válido.
2. En Sitemaps, eliminá el envío fallido y volvé a enviar la misma URL.
3. Si el error persiste (caché de GSC), probá una URL alternativa para forzar un fetch nuevo, por ejemplo https://loguitos.app/sitemap.xml?v=2.
4. En Vercel → Security, confirmá que no haya Deployment Protection ni reglas de firewall que bloqueen a Googlebot.

IndexNow

Tras el deploy, el sitio expone la clave de verificación en la raíz (public/<key>.txt) y un workflow de GitHub notifica a IndexNow solo las URLs cuyo <lastmod> cambió respecto al sitemap anterior (cache en Actions).

Comandos (después de pnpm build, que genera public/sitemap.xml):

# Envío inicial o reindex completo (verifica la clave en producción y POST a api.indexnow.org)
pnpm indexnow:submit-all

# Solo URLs con lastmod nuevo o distinto (usa .cache/indexnow-previous-sitemap.xml por defecto)
pnpm indexnow:ping-changed

Variables opcionales para indexnow:ping-changed:

• INDEXNOW_FETCH_CURRENT=1 — lee el sitemap en vivo desde NEXT_PUBLIC_SITE_URL / https://loguitos.app
• INDEXNOW_PREVIOUS_SITEMAP_PATH — ruta al XML baseline anterior
• INDEXNOW_CURRENT_SITEMAP_PATH — ruta al sitemap actual (si no se usa fetch)

Estructura del proyecto

Puntos clave para contributors:

• app: layout global y página principal
  • app/page.tsx: búsqueda, filtros, render de categorías, panel de configuración
  • app/layout.tsx: metadata y estructura raíz
• components: componentes de UI y bloques funcionales
  • components/category-section.tsx: render por categoría
  • components/logo-card.tsx: tarjeta de logo/endpoints
  • components/config-panel.tsx: controles de parámetros
• lib: datos y helpers de dominio
  • lib/logos-data.ts: fuente principal de categorías/entidades
  • lib/config-context.tsx: estado/configuración de curls y endpoints
  • lib/utils.ts: utilidades compartidas

Cómo contribuir

Flujo recomendado

1. Forkeá el repo y creá una rama:
   • feature/<descripcion-corta> para features
   • fix/<descripcion-corta> para correcciones
2. Hacé cambios acotados y enfocados.
3. Validá localmente antes de abrir PR:
   • pnpm lint
   • pnpm build
4. Abrí un Pull Request con contexto claro:
   • problema/oportunidad,
   • qué cambiaste,
   • por qué este enfoque.

Guía para cambios frecuentes

Agregar o editar entidades

Editá lib/logos-data.ts respetando:

• tipos Category y Entity,
• unicidad de id dentro del archivo,
• dominios válidos y sin duplicados innecesarios.

Después verificá en la UI:

• resultados de búsqueda,
• conteos por categoría,
• generación de endpoint/curl.

Cambios de UI o interacción

• Ubicá la lógica principal en app/page.tsx.
• Si el cambio es reutilizable, movelo a components.
• Mantené consistencia visual con componentes de components/ui.

Checklist antes de abrir PR

• Corre localmente (pnpm dev)
• pnpm lint sin errores
• pnpm build sin errores
• Probé manualmente los flujos afectados
• La descripción del PR explica impacto y alcance

Licencia y atribución

Este repositorio distribuye una interfaz y referencias a endpoints públicos de favicons. Los logos y marcas pertenecen a sus respectivas entidades.

Si vas a reutilizar assets descargados, revisá términos de uso y políticas de marca de cada organización.