Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🌓 theme-toggle-effect

Un escaparate moderno e interactivo que demuestra el poder de la View Transitions API nativa de la plataforma web para crear transiciones fluidas y visualmente espectaculares al alternar entre los temas claro y oscuro (Light/Dark Mode).

Este proyecto implementa diferentes efectos visuales (como máscaras de recorte circulares con clip-path, efectos de revelado mediante máscaras CSS y animaciones con SVGs personalizados), sirviendo como guía de referencia práctica para desarrolladores frontend que buscan elevar la experiencia de usuario (UX) en sus aplicaciones web sin depender de pesadas librerías de animación de terceros.


🚀 Descripción General

El repositorio theme-toggle-effect proporciona una interfaz web interactiva donde los usuarios pueden experimentar y previsualizar en tiempo real múltiples efectos de transición al cambiar de tema.

Aprovechando la View Transitions API (soportada de forma nativa en navegadores modernos), la aplicación captura capturas de pantalla del estado anterior y posterior del DOM, permitiendo animar la transición entre ambos estados con CSS estándar de manera ultraeficiente.

Características Clave:

  • Múltiples Efectos: Registro dinámico de animaciones que incluye revelado circular, cortinas CSS, transiciones de trayectoria y uso de SVGs personalizados.
  • Sin Frameworks: Implementación pura con Vanilla JavaScript, garantizando un rendimiento óptimo y un tiempo de carga mínimo.
  • Respetuoso con las Preferencias de Usuario: Integración con @media (prefers-reduced-motion) para desactivar transiciones complejas en dispositivos de usuarios que así lo prefieran.
  • Diseño Responsivo: Interfaz adaptada a cualquier tamaño de pantalla, utilizando tipografías modernas (Manrope) y un diseño limpio y accesible.

🛠️ Tecnologías y Librerías

  • HTML5 / CSS3: Maquetación semántica y diseño visual mediante variables CSS (Custom Properties) para gestionar la paleta de colores de los temas claro y oscuro.
  • Vanilla JavaScript (ES6+): Orquestación del estado del tema, persistencia en almacenamiento local y registro dinámico de animaciones.
  • View Transitions API: Mecanismo central para la captura de estados y animación de la transición entre temas.
  • Prism.css: Utilizado para el resaltado de sintaxis de los fragmentos de código mostrados en la interfaz.
  • Docker & Nginx: Configuración lista para producción que permite empaquetar la aplicación en un contenedor ligero y servirla mediante un servidor web Nginx optimizado.

📂 Estructura del Repositorio

La arquitectura del proyecto es plana y modular, facilitando su comprensión y extensión:

├── .github/assets/        # Recursos visuales para la documentación (GIFs demostrativos)
├── assets/                # Recursos estáticos (Logotipos, SVGs personalizados, favicon)
├── scripts/               # Scripts de utilidad para desarrollo y auditoría
│   ├── security_audit.sh  # Script de auditoría de seguridad local
│   └── status.sh          # Dashboard de estado del proyecto
├── index.html             # Estructura HTML principal de la aplicación web
├── style.css              # Estilos base, variables de tema y animaciones de transición
├── script.js              # Lógica principal de inicialización y cambio de tema
├── animation-registry.js  # Registro de los diferentes efectos de animación disponibles
├── animations.txt         # Referencia rápida y definiciones CSS de los efectos
├── prism.css              # Estilos para el visor de código integrado
├── Dockerfile             # Configuración de contenedor Docker multi-stage (Node + Nginx)
├── nginx.conf             # Configuración del servidor web de producción Nginx
├── biome.json             # Configuración del formateador y linter de código (Biome)
├── lefthook.yml           # Configuración de Git Hooks (Pre-commit / Pre-push)
└── .no-mistakes.yaml      # Configuración de validación de políticas del repositorio

💻 Instalación y Ejecución Local

Opción 1: Servidor Local Rápido (Recomendado para Desarrollo)

Dado que es una aplicación web estática, puedes ejecutarla localmente de forma instantánea usando cualquier servidor HTTP local.

  1. Clona el repositorio:

    git clone https://github.com/tu-usuario/theme-toggle-effect.git
    cd theme-toggle-effect
  2. Inicia un servidor local. Por ejemplo, usando Python o Node.js:

    # Usando Python
    python3 -m http.server 8080
    
    # O usando Node.js (npx)
    npx serve .
  3. Abre tu navegador e ingresa a http://localhost:8080 (o el puerto que te indique tu consola).

Opción 2: Uso de Docker

El proyecto cuenta con un entorno Dockerizado optimizado con una estructura multi-etapa y servidor de producción Nginx.

  1. Construye la imagen de Docker:

    docker build -t theme-toggle-effect .
  2. Arranca el contenedor mapeando el puerto 80:

    docker run -d -p 8080:80 theme-toggle-effect
  3. Accede a la aplicación desde tu navegador en http://localhost:8080.


⚙️ Gobernanza del Proyecto

Para garantizar los más altos estándares de calidad y mantener el código limpio y seguro, este repositorio integra herramientas automatizadas de análisis estático y seguridad:

  • Formateo y Linting: Se utiliza Biome (configurado en biome.json) para un análisis estático de código ultrarrápido que asegura la consistencia de estilos en JavaScript y CSS.
  • Git Hooks (Lefthook): Gestionado mediante lefthook.yml, se ejecutan validaciones previas a cada git commit para prevenir la subida de código mal formateado o con errores lógicos.
  • Auditorías de Seguridad: Dispone de un script automatizado local en scripts/security_audit.sh (basado en la herramienta Bumblebee) para la detección temprana de vulnerabilidades.
  • Control de Calidad Integrado: El script scripts/status.sh actúa como un panel de control rápido para verificar el cumplimiento del ecosistema local, el estado de los Git hooks y las políticas del archivo .no-mistakes.yaml.

Megacore - Automatizando y estandarizando la calidad del software en Megasoft.

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages