{"id":49801486,"url":"https://github.com/mafhper/spread","last_synced_at":"2026-05-12T14:36:32.398Z","repository":{"id":324502246,"uuid":"1097393716","full_name":"mafhper/spread","owner":"mafhper","description":"A better way to share","archived":false,"fork":false,"pushed_at":"2026-04-24T17:18:02.000Z","size":13378,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T18:29:52.305Z","etag":null,"topics":["astro","javascript","share","spread","typescript"],"latest_commit_sha":null,"homepage":"https://mafhper.github.io/spread/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mafhper.png","metadata":{"files":{"readme":"README-es.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-16T04:51:08.000Z","updated_at":"2026-04-24T17:18:12.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mafhper/spread","commit_stats":null,"previous_names":["mafhper/spread"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mafhper/spread","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafhper%2Fspread","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafhper%2Fspread/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafhper%2Fspread/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafhper%2Fspread/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mafhper","download_url":"https://codeload.github.com/mafhper/spread/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mafhper%2Fspread/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32943737,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T09:19:52.626Z","status":"ssl_error","status_checked_at":"2026-05-12T09:17:33.438Z","response_time":102,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astro","javascript","share","spread","typescript"],"created_at":"2026-05-12T14:36:31.485Z","updated_at":"2026-05-12T14:36:32.393Z","avatar_url":"https://github.com/mafhper.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spread\n\nSpread es una utilidad web de alta fidelidad diseñada para la generación de activos estéticos de visualización de enlaces. Facilita la transformación de URLs de diversas plataformas digitales —incluyendo servicios de streaming, redes sociales y portales de noticias— en componentes visuales profesionales optimizados para su distribución en alta resolución.\n\n![Banner](public/docs/assets/banner.jpeg)\n\n\u003cdiv align=\"center\"\u003e\n\n[English](README.md) • [Português](README-ptBR.md) • [Español](README-es.md)\n\n[![Live Demo](https://img.shields.io/badge/despliegue-en--vivo-EB5757?style=for-the-badge\u0026logo=rocket\u0026logoColor=white)](https://mafhper.github.io/spread)\n[![Licencia: MIT](https://img.shields.io/badge/Licencia-MIT-56CCF2?style=for-the-badge\u0026logo=opensourceinitiative\u0026logoColor=white)](LICENSE)\n[![Runtime: Bun](https://img.shields.io/badge/Runtime-Bun-000000?style=for-the-badge\u0026logo=bun\u0026logoColor=white)](https://bun.sh)\n\n\u003c/div\u003e\n\n---\n\n## Visión General Técnica\n\n- **Orquestación de Metadatos**: Implementa la extracción automatizada mediante protocolos Open Graph para la recuperación de títulos canónicos, descripciones e iconografía de alta calidad.\n- **Motor de Color Heurístico**: Utiliza un módulo de análisis especializado para derivar paletas de colores dominantes de los medios de origen, generando degradados cromáticos equilibrados.\n- **Plantillas de Diseño Adaptativas**: Presenta un conjunto de configuraciones especializadas optimizadas para diversos tipos de contenido, incluyendo música, fotografía y periodismo.\n- **Renderizado de Alta Resolución**: Desarrollado sobre Astro 5 y React 19, ofreciendo una interfaz de baja latencia con soporte para la exportación de activos PNG en una proporción de píxeles de 2x.\n\n---\n\n## Evaluación en Línea\n\nEl despliegue de producción está disponible para pruebas y evaluación en vivo.\n\n**Punto de Acceso:** [mafhper.github.io/spread](https://mafhper.github.io/spread)\n\n1.  **Despliegue**: Accesible a través de cualquier navegador web moderno estándar.\n2.  **Uso**: Ingrese URLs válidas de plataformas compatibles (Spotify, YouTube, Portales de Noticias).\n3.  **Gobernanza**: Los comentarios y reportes de errores deben enviarse a través de [GitHub Issues](https://github.com/mafhper/spread/issues).\n\n---\n\n## Garantía de Calidad y Gobernanza\n\nSpread integra **Quality Core**, un sistema de gobernanza modular diseñado para imponer estándares rigurosos de ingeniería de software mediante auditoría automatizada.\n\n- **Quality Gate**: Orquestador pre-commit que impone protocolos de integridad, internacionalización (i18n), seguridad y rendimiento.\n- **Panel de Telemetría**: Una interfaz analítica estilo Bento para el monitoreo en tiempo real de la salud del proyecto, tendencias históricas y snapshots de auditoría.\n- **Seguridad y Rendimiento**: Integración nativa con métricas de Lighthouse y escáneres especializados de dependencias y secretos.\n\nLa documentación técnica está disponible en el [Módulo Quality Core](quality-core/README.md).\n\n---\n\n## Flujo Arquitectónico\n\nLa aplicación se ejecuta exclusivamente en el lado del cliente (client-side) para garantizar la máxima privacidad de los datos y eficiencia computacional.\n\n```mermaid\ngraph LR\n    A[Entrada de URL] --\u003e B{Extracción}\n    B --\u003e|Metadatos| C[Procesamiento de Contenido]\n    B --\u003e|Imagen| D[Motor de Color]\n    C --\u003e E[Selección de Plantilla]\n    D --\u003e F[Procesamiento de Degradado]\n    E --\u003e G[Editor Visual]\n    F --\u003e G\n    G --\u003e H[Exportación PNG]\n\n    style A fill:#18181b,stroke:#a855f7,color:#fff\n    style H fill:#18181b,stroke:#f43f5e,color:#fff\n    style G fill:#18181b,stroke:#06b6d4,color:#fff\n```\n\n---\n\n## Referencia Visual\n\n![Visualización de Música](public/docs/assets/music-preview.png)\n_Figura 1: Configuraciones de diseño especializadas para metadados musicales._\n\n![Activos de Redes Sociales](public/docs/assets/social-preview.png)\n_Figura 2: Plantillas de nivel profesional para distribución en redes sociales._\n\n---\n\n## Desarrollo y Despliegue\n\nEl proyecto soporta un **flujo cross-platform** (Windows, macOS, Linux) y puede ejecutarse con **Bun** (recomendado) o **Node/npm**. Los scripts evitan comandos dependientes del shell.\n\n### Requisitos Previos\n\n- [Node.js](https://nodejs.org) \u003e= 20 (obligatorio)\n- [npm](https://www.npmjs.com) \u003e= 10 (obligatorio para auditorías/updates del dashboard)\n- [Bun Runtime](https://bun.sh) \u003e= 1.1 (recomendado; usado por utilidades TS de Quality Core)\n\n### Flujo Universal (Bun o Node)\n\n```bash\n# Sincronización de dependencias (elige uno)\nbun install\n# o\nnpm install\n\n# Servidor de desarrollo\nbun dev\n# o\nnpm run dev\n\n# Build de producción\nbun run build\n# o\nnpm run build\n```\n\n### Calidad y Reportes\n\n```bash\n# Quality gate completo (cross-platform)\nbun run quality:full\n\n# Reportes (Lighthouse + snapshots; requiere Bun para scripts TS)\nbun run quality:reports:all\n```\n\n---\n\n## Estructura del Repositorio\n\n```text\nspread/\n├── src/\n│   ├── components/      # Arquitectura de interfaz React\n│   ├── store/           # Sincronización de estado mediante Zustand\n│   ├── services/        # Utilidades lógicas y abstracción de API\n│   └── styles/          # Configuración de PostCSS y Tailwind 4\n├── quality-core/        # Sistema de garantía de calidad y gobernanza\n├── public/              # Activos estáticos y recursos de distribución\n└── Astro.config.mjs     # Orquestación del framework\n```\n\n---\n\n## Licencia\n\nEste proyecto está bajo la Licencia MIT. Los términos legales detallados están disponibles en el archivo [LICENSE](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eMantenido por \u003cb\u003emafhper\u003c/b\u003e\u003c/p\u003e\n  \u003ca href=\"https://github.com/mafhper\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/followers/mafhper?label=Follow\u0026style=social\" alt=\"Seguir a mafhper\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmafhper%2Fspread","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmafhper%2Fspread","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmafhper%2Fspread/lists"}