How cresenciocl/biopixel-public works
Project Type and Purpose
• This is a static, multi-language website intended for deployment on GitHub Pages.
• It uses plain HTML, CSS, and JavaScript plus JSON files for internationalization (i18n).
Main Components
a. Client (Web Browser)
• Renders HTML/CSS, executes JavaScript, displays images.
b. Hosting Platform
• GitHub Pages (a static site host/CDN).
c. Static Assets
• HTML files: index.html, about.html, contacto.html, test_i18n.html
• CSS: style.css
• JavaScript:
• i18n.js (loads locale JSON based on user’s language)
• form-handler.js (captures form submissions)
• header-scroll.js, mobile-menu.js, smooth-scroll.js (UI behaviors)
• Images: /images directory
d. Locale Data
• JSON files: en.json, es.json, nl.json (text strings per language)
e. Optional External Service
• form-handler.js may POST to a third-party endpoint (e.g., Formspree, Netlify Forms).
Relationships and Data Flows
• Browser requests HTML from GitHub Pages.
• HTML references style.css and UI-behavior scripts.
• i18n.js loads the correct JSON file at runtime and replaces text nodes.
• User interactions (scroll, menu clicks) are handled by the various UI JS modules.
• When a user submits a form, form-handler.js serializes the data and sends it to the configured endpoint.
• All static resources are fetched from GitHub Pages CDN.
Architectural Patterns and Design Principles
• Static Site Architecture: no backend code in this repo.
• Separation of concerns:
• Structure: HTML
• Presentation: CSS
• Behavior: Modular JS (one module per UI concern)
• Content: JSON locale files
• Deployment as immutable assets on CDN (GitHub Pages).
Checklist
• All major files or logical groupings shown.
• Hosting/CDN
• Browser
• Static resource types (HTML/CSS/JS/JSON/images)
• External service
• Clear component names and data-flow annotations.