Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PageForMyLittleStar 💫💗

Made with Love Status Licencia

💝 Inspiración

Este proyecto nace del deseo de expresar amor de una manera única y moderna. En un mundo donde la tecnología y los sentimientos a menudo parecen distantes, PageForMyLittleStar demuestra que el código también puede ser una forma de arte para expresar emociones profundas.

🌟 Descripción

PageForMyLittleStar es un proyecto web personal y emotivo creado por Antony Salcedo como un regalo especial para Sara, su "estrellita", con motivo del día del amor y la amistad (21 de septiembre). Esta página web interactiva combina elementos multimedia, animaciones y mensajes personalizados para expresar sentimientos de amor y aprecio de una manera creativa y tecnológica.

✨ Características Principales

🎨 Diseño y Experiencia Visual

  • Diseño Responsivo: Adaptado para una visualización óptima en dispositivos móviles y de escritorio
  • Fondo de Video Inmersivo: Video de fondo con respaldo de imagen para compatibilidad universal
  • Animaciones Suaves: Transiciones y efectos visuales cuidadosamente diseñados
  • Preloader Personalizado: Pantalla de carga inicial con animación temática

🎵 Elementos Multimedia

  • Reproductor de Audio Personalizado:
    • Selector de canciones con cambio dinámico de logos
    • Controles intuitivos de reproducción
    • Visualización del título de la canción actual
  • Carrusel de Imágenes Estilo Libro:
    • Navegación manual y automática
    • Efectos de transición tipo libro
    • Optimización de carga de imágenes
  • Reproductor de Video Integrado:
    • Controles personalizados
    • Modo pantalla completa
    • Autoplay opcional

🎯 Funcionalidades Interactivas

  • Modal Interactivo: Ventana emergente con poema personalizado
  • Reloj de Amor Digital: Mensajes románticos dinámicos según la hora
  • Integración con Spotify: Lista de reproducción personalizada embebida

🛠️ Estructura del Proyecto

PageForMyLittleStar/
├── 📄 index.html                 # Página principal
├── 📄 package.json              # Configuración del proyecto
├── 📄 .gitignore                # Archivos ignorados por Git
├── 📄 .prettierrc               # Configuración de formato
├── 📄 .htmlvalidate.json        # Validación HTML
├── 📄 LICENSE                   # Licencia del proyecto
├── 📄 README.md                 # Documentación principal
│
├── 📁 src/                      # Código fuente
│   ├── 📁 styles/               # Hojas de estilo CSS
│   ├── 📁 scripts/              # Scripts JavaScript
│   └── 📁 components/           # Componentes reutilizables
│
├── 📁 assets/                   # Recursos estáticos
│   ├── 📁 media/                # Contenido multimedia
│   │   ├── 📁 images/           # Imágenes optimizadas
│   │   ├── 📁 audio/            # Archivos de audio MP3
│   │   └── 📁 videos/           # Videos comprimidos MP4
│   ├── 📁 fonts/                # Fuentes personalizadas
│   └── 📁 icons/                # Iconos del proyecto
│
├── 📁 docs/                     # Documentación técnica
│   └── 📄 TECHNICAL.md          # Guía técnica detallada
│
└── 📁 config/                   # Archivos de configuración

🚀 Tecnologías y Herramientas

Frontend

  • HTML5: Estructura semántica y accesible
  • CSS3: Estilos modernos con Flexbox y Grid
  • JavaScript ES6+: Funcionalidad interactiva vanilla
  • Google Fonts: Tipografía Poppins

Herramientas de Desarrollo

  • Node.js & npm: Gestión de dependencias y scripts
  • Live Server: Servidor de desarrollo local
  • Prettier: Formateo automático de código
  • HTML Validate: Validación de HTML
  • Clean CSS & Terser: Minificación de assets

Multimedia

  • MP4: Videos optimizados y comprimidos
  • MP3: Audio de alta calidad
  • PNG/JPG: Imágenes optimizadas para web
  • ICO: Favicon personalizado

🚀 Características Técnicas Destacadas

Rendimiento

  • Optimización de recursos multimedia
  • Minificación de CSS y JavaScript
  • Implementación de caché estratégico

Experiencia de Usuario

  • Animaciones optimizadas para rendimiento
  • Navegación fluida entre secciones
  • Interfaz intuitiva y emotiva

Accesibilidad

  • Etiquetas semánticas HTML5
  • Atributos ARIA implementados
  • Alto contraste y legibilidad

🚀 Instalación y Uso

Requisitos Previos

  • Node.js >= 14.0.0
  • npm >= 6.0.0
  • Navegador web moderno (Chrome, Firefox, Safari, Edge)

Instalación

# Clonar el repositorio
git clone https://github.com/tu-usuario/PageForMyLittleStar.git

# Navegar al directorio
cd PageForMyLittleStar

# Instalar dependencias de desarrollo
npm install

Scripts Disponibles

# Iniciar servidor de desarrollo
npm start

# Modo desarrollo con recarga automática
npm run dev

# Construir para producción
npm run build

# Validar HTML
npm run validate

# Formatear código
npm run format

Acceso

  • Desarrollo: http://localhost:3000
  • Producción: Desplegar archivos en servidor web

🏗️ Arquitectura Profesional

El proyecto ha sido reestructurado siguiendo las mejores prácticas de desarrollo web:

Separación de Responsabilidades

  • src/: Todo el código fuente organizado por tipo
  • assets/: Recursos estáticos optimizados y categorizados
  • docs/: Documentación técnica completa
  • config/: Archivos de configuración del proyecto

Herramientas de Calidad

  • Prettier: Formateo automático consistente
  • HTML Validate: Validación de estándares web
  • Minificación: Optimización para producción
  • Live Server: Desarrollo con recarga automática

Gestión de Dependencias

  • package.json: Scripts y dependencias organizadas
  • npm scripts: Automatización de tareas comunes
  • .gitignore: Control de versiones optimizado

🎨 Personalización

Contenido Multimedia

  1. Reemplaza los archivos en assets/media/ con tus propios recursos
  2. Mantén los nombres de archivo originales o actualiza las referencias
  3. Optimiza los nuevos recursos para web

Mensajes y Textos

  1. Edita index.html para personalizar mensajes
  2. Adapta el contenido manteniendo la estructura
  3. Personaliza los mensajes del reloj en src/scripts/scripts.js

Estilos y Funcionalidad

  • Colores: Modifica las variables CSS en src/styles/styles.css
  • Fuentes: Cambia la fuente en Google Fonts
  • Animaciones: Ajusta las transiciones y efectos
  • Reproductor: Personaliza controles en JavaScript
  • Modal: Modifica el contenido del poema
  • Carrusel: Ajusta velocidad y efectos de transición

🤝 Contribución

¿Quieres mejorar PageForMyLittleStar? ¡Tus contribuciones son bienvenidas!

  1. Fork el proyecto
  2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
  3. Commit tus cambios (git commit -m 'Add: AmazingFeature')
  4. Push a la rama (git push origin feature/AmazingFeature)
  5. Abre un Pull Request

📄 Licencia

Este proyecto está bajo la Licencia MIT - consulta el archivo para más detalles.

💌 Agradecimientos

  • A Sara, mi estrellita, por ser la inspiración de este proyecto
  • A la comunidad de desarrolladores por las herramientas y recursos
  • A todos los que apoyan el código con propósito

👨‍💻 Autor

Creado con ❤️ por Antony Salcedo


"En el vasto universo, entre millones de estrellas, te amo más que todas las estrellas del firmamento."


Visítanos

About

This page was made for my little star (Sara) from Antony, to show her how much he loves her and as a gift for September 21, that is, the day of love and friendship.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages