How diegomonterocrc/vidrios-universal-web works
Purpose and Delivery
Vidrios y Espejos Universal is a production marketing/catalog website for a family glass and mirror business. It is a static frontend deployed at https://vidriosuniversal.com, with no backend or build system represented. The document entry point is index.html; the custom-domain deployment marker is CNAME.
Page Composition and Content
index.html is the application shell and likely owns the business-facing sections: service/product presentation, gallery, contact/social links, SEO metadata, structured data, and external analytics embeds. Static visual content is organized under assets/img/, including hero imagery in assets/img/portada/, brand assets in assets/img/logos/, and gallery media in assets/img/galeria/.
Presentation Layer
Responsive, mobile-first layout, themes, animations, navigation states, and gallery/lightbox styling are centralized in assets/css/styles.css. This is the primary visual boundary: HTML supplies semantic structure and CSS controls responsive and dark/light presentation without a component framework.
Client Interaction Layer
Vanilla browser-side behavior is concentrated in assets/js/main.js. It implements the dynamic UI lifecycle described by the project: initial loader, responsive menu/navigation behavior, persisted dark mode, scroll-driven animation, gallery filtering, interactive lightbox, and outbound interaction tracking. index.html loads this script and provides the DOM hooks it operates on.
Gallery Data Flow
Gallery content is file-based rather than API-backed. index.html references categorized assets, while assets/js/main.js filters or opens selected items and assets/css/styles.css renders responsive gallery and lightbox states. Product categories are represented physically in paths such as assets/img/galeria/puertas/, assets/img/galeria/ventanas/, and assets/img/galeria/espejos/.
Discovery, Conversion, and External Boundaries
SEO and crawler boundaries are static: robots.txt defines crawl guidance and sitemap.xml exposes discoverable URLs. Conversion actions route users to external channels, notably WhatsApp and social platforms, from page links/events. Google Analytics is an external telemetry dependency, with click/event instrumentation coordinated from assets/js/main.js and page-level integration in index.html.
Hosting and Infrastructure
The site is intended for GitHub Pages static hosting, using CNAME for the custom domain. Cloudflare provides DNS/infrastructure integration in front of the hosted site. Assets are served directly from the repository, with WebP-oriented image optimization implied by the image asset organization; no server-side quote, catalog, CMS, or WhatsApp Business API integration currently exists.
Main entry points: index.html Page shell · main.js UI lifecycle · styles.css Responsive presentation · robots.txt Crawler guidance
Components 17
Static site
- Page shell · Semantic sections, metadata, embeds, and DOM hooks.
index.html - Responsive presentation · Owns layout, themes, animation, and lightbox states.
assets/css/styles.css - UI lifecycle · Controls navigation, theme persistence, gallery, lightbox, and tracking.
assets/js/main.js
Media catalog
- Hero imagery
- Brand assets
- Gallery media
- Door gallery
- Window gallery
- Mirror gallery
Discovery & conversion
- Crawler guidance
robots.txt - URL discovery
sitemap.xml - WhatsApp & social
- Google Analytics
Delivery
- GitHub Pages
- Custom domain marker
CNAME - Cloudflare
Other components
- Visitor browser
Connections 20
- Visitor browser → Cloudflare: requests site
- Cloudflare → GitHub Pages: routes domain
- Custom domain marker → GitHub Pages: configures domain
- GitHub Pages → Page shell: serves
- Page shell → Responsive presentation: loads
- Page shell → UI lifecycle: loads
- Page shell → Hero imagery: references
- Page shell → Brand assets: references
- Page shell → Gallery media: references categorized media
- Gallery media → Door gallery: contains
- Gallery media → Window gallery: contains
- Gallery media → Mirror gallery: contains
- UI lifecycle → Page shell: operates DOM hooks
- UI lifecycle → Gallery media: filters and opens items
- Responsive presentation → Gallery media: renders gallery states
- Page shell → WhatsApp & social: conversion links
- UI lifecycle → WhatsApp & social: tracks outbound actions
- Page shell → Google Analytics: page integration
- UI lifecycle → Google Analytics: sends interaction events
- Crawler guidance → URL discovery: crawler discovery