Skip to content

SwonDev/TierList-Creator

Repository files navigation

🎮 TierList Creator

La herramienta definitiva para crear tier lists de videojuegos

Demo en Vivo Netlify Status License: MIT React Vite

Una aplicación web moderna e interactiva para crear tier lists personalizadas de videojuegos con funcionalidades avanzadas de drag & drop, integración con Steam API y exportación de alta calidad.

🎯 Características🚀 Demo📦 Instalación🎮 Uso🤝 Contribuir


📸 Vista Previa

Screenshots y GIFs demostrativos próximamente

TierList Creator Demo

Interfaz principal de TierList Creator

✨ Características

🎯 Experiencia de Usuario

  • Drag & Drop Fluido: Interfaz intuitiva con @dnd-kit
  • 100% Responsive: Perfecto en desktop, tablet y móvil
  • Temas Personalizables: Múltiples estilos visuales
  • Navegación por Teclado: Accesibilidad completa
  • Touch-Friendly: Optimizado para dispositivos táctiles

Funcionalidades Avanzadas

  • Integración Steam: Importa juegos automáticamente
  • Exportación HD: Imágenes PNG de alta calidad
  • Guardado Local: Persistencia automática
  • Editor Avanzado: Personalización completa
  • Rendimiento Optimizado: Lazy loading y memoización

🚀 Demo en Vivo

🌐 Prueba TierList Creator ahora

No requiere instalación - funciona directamente en tu navegador

🛠️ Stack Tecnológico

Categoría Tecnología Versión Propósito
⚛️ Frontend React 18.2.0 Framework principal
⚡ Build Tool Vite 5.0.8 Bundler y dev server
🎯 Drag & Drop @dnd-kit 6.0.8+ Sistema de arrastrar y soltar
🎨 Estilos CSS3 + Modules - Estilos modulares
🔧 Iconos Lucide React 0.525.0 Iconografía moderna
📸 Exportación html2canvas 1.4.1 Generación de imágenes
🛡️ Sanitización DOMPurify 3.2.6 Seguridad XSS
🚀 Deploy Netlify - Hosting y CI/CD

🏗️ Arquitectura

graph TD
    A[React App] --> B[Components]
    A --> C[Services]
    A --> D[Utils]
    B --> E[DraggableItem]
    B --> F[TierList]
    B --> G[Toolbar]
    C --> H[Steam API]
    D --> I[File Utils]
    D --> J[Templates]
Loading

📦 Instalación

📋 Prerrequisitos

🟢 Requerido

  • Node.js 16.0.0+
  • npm 8.0.0+ o yarn

🔵 Recomendado

  • Git para clonar el repo
  • VS Code con extensiones React

🚀 Instalación Rápida

# 1️⃣ Clona el repositorio
git clone https://github.com/SwonDev/tierlist-creator-swonproject.git
cd tierlist-creator-swonproject

# 2️⃣ Instala las dependencias
npm install

# 3️⃣ Inicia el servidor de desarrollo
npm run dev

# 4️⃣ ¡Abre tu navegador en http://localhost:5173! 🎉

🐳 Docker (Opcional)

# Construir imagen
docker build -t tierlist-creator .

# Ejecutar contenedor
docker run -p 5173:5173 tierlist-creator

🎮 Guía de Uso

🚀 Inicio Rápido

Guía de Uso

📝 Crear tu Primera Tier List

1️⃣ Añadir Elementos

  • 🖱️ Arrastra imágenes desde tu PC
  • 📋 Pega con Ctrl+V / Cmd+V
  • 🎮 Importa desde Steam API
  • 🔗 URLs de imágenes directas

2️⃣ Organizar Tiers

  • 🎯 Arrastra entre niveles (S→F)
  • 🏷️ Personaliza nombres de tiers
  • 🎨 Cambia colores de categorías
  • ➕ Añade/elimina tiers

3️⃣ Personalizar

  • 🌈 Selecciona temas visuales
  • 📏 Ajusta tamaño de elementos
  • 🔧 Configura opciones avanzadas
  • 💾 Guardado automático

4️⃣ Exportar & Compartir

  • 📸 Descarga como PNG HD
  • 🔗 Genera enlace para compartir
  • 💾 Guarda proyecto localmente
  • 📱 Compatible con redes sociales

🎮 Integración con Steam

🔧 Configuración de Steam API
  1. Accede a la configuración

    Toolbar → ⚙️ Configuración → 🎮 Steam API
    
  2. Ingresa tu información

    • Steam ID (ej: 76561198000000000)
    • URL de perfil (ej: steamcommunity.com/id/tuusuario)
  3. Selecciona juegos

    • ✅ Marca los juegos que quieres incluir
    • 🔍 Usa el filtro de búsqueda
    • 📚 Importa bibliotecas completas
  4. ¡Listo!

    • Los juegos aparecen automáticamente
    • Imágenes en alta calidad
    • Metadatos incluidos

⌨️ Atajos de Teclado

Acción Windows/Linux macOS
Pegar imagen Ctrl + V Cmd + V
Deshacer Ctrl + Z Cmd + Z
Rehacer Ctrl + Y Cmd + Shift + Z
Guardar Ctrl + S Cmd + S
Exportar Ctrl + E Cmd + E
Ayuda F1 F1

🎨 Características Técnicas

⚡ Rendimiento

🚀 Optimizaciones Frontend

  • Lazy Loading de imágenes
  • Memoización de componentes React
  • Virtual Scrolling para listas grandes
  • Bundle splitting automático
  • Tree shaking para código muerto
  • Compresión Gzip/Brotli

📊 Métricas de Rendimiento

  • Lighthouse Score: 95+ en todas las métricas
  • First Contentful Paint: < 1.5s
  • Time to Interactive: < 3s
  • Bundle Size: < 500KB gzipped
  • Memory Usage: Optimizado para dispositivos móviles

♿ Accesibilidad (WCAG 2.1 AA)

  • 🎹 Navegación por teclado completa
  • 📢 Screen reader compatible (ARIA labels)
  • 🌗 Alto contraste disponible
  • 👆 Touch-friendly (44px+ touch targets)
  • 🔍 Zoom hasta 200% sin pérdida de funcionalidad
  • ⚡ Reduced motion para usuarios sensibles

🌐 Compatibilidad

Navegador Versión Mínima Estado
Chrome 90+ ✅ Totalmente compatible
Firefox 88+ ✅ Totalmente compatible
Safari 14+ ✅ Totalmente compatible
Edge 90+ ✅ Totalmente compatible
Mobile Safari 14+ ✅ Optimizado
Chrome Mobile 90+ ✅ Optimizado

📱 Responsive Design

  • 📱 Mobile: 320px-768px (touch optimizado)
  • 📟 Tablet: 768px-1024px (interacción híbrida)
  • 💻 Desktop: 1024px-1440px (funcionalidades completas)
  • 🖥️ Large: 1440px+ (layouts expandidos)

🗺️ Roadmap

🚀 Versión 2.0 (Q2 2024)

🎯 Nuevas Características Planificadas

🎮 Gaming Features

  • 🎲 Plantillas predefinidas (RPGs, FPS, Indie, etc.)
  • 🏆 Sistema de logros y estadísticas
  • 👥 Tier lists colaborativas en tiempo real
  • 🎯 Comparación de tier lists entre usuarios

🔧 Mejoras Técnicas

  • 💾 Base de datos en la nube (opcional)
  • 🔐 Autenticación de usuarios (Google, Steam, Discord)
  • 📱 PWA completa con instalación
  • 🌙 Modo oscuro automático

🎨 UX/UI Enhancements

  • 🎬 Animaciones avanzadas con Framer Motion
  • 🎨 Editor de temas personalizado
  • 📐 Layouts alternativos (circular, hexagonal)
  • 🔍 Zoom y pan en tier lists grandes

🌐 Integrations

  • 🎮 Epic Games Store API
  • 🎯 IGDB (Internet Game Database)
  • 📺 Twitch integration para streamers
  • 📱 Discord bot para compartir

🔮 Futuro (2024+)

  • 🤖 IA para recomendaciones de juegos
  • 🎥 Exportación a video (timelapses)
  • 🌍 Comunidad global de tier lists
  • 📊 Analytics avanzados de tendencias

📁 Estructura del Proyecto

tierlist-app/
├── public/                 # Archivos estáticos
├── src/
│   ├── components/         # Componentes React
│   │   ├── DraggableItem.jsx
│   │   ├── TierList.jsx
│   │   ├── Toolbar.jsx
│   │   └── ...
│   ├── services/          # Servicios (Steam API)
│   ├── utils/             # Utilidades y helpers
│   ├── App.jsx           # Componente principal
│   └── main.jsx          # Punto de entrada
├── package.json
└── vite.config.js

🤝 Contribuir

🌟 ¡Tu contribución hace la diferencia! 🌟

Contribuidores Issues Pull Requests

🚀 Guía de Contribución

🔰 Para Principiantes

  1. 🍴 Fork el repositorio
  2. 📥 Clona tu fork localmente
  3. 🌿 Crea una rama para tu feature
  4. 💻 Desarrolla tu contribución
  5. ✅ Testea tus cambios
  6. 📤 Envía un Pull Request

🏗️ Tipos de Contribución

  • 🐛 Bug fixes y correcciones
  • Nuevas características
  • 📚 Documentación
  • 🎨 Mejoras de UI/UX
  • Optimizaciones de rendimiento
  • 🌐 Traducciones

📋 Proceso Detallado

# 1️⃣ Fork y clona el repositorio
git clone https://github.com/tu-usuario/tierlist-creator-swonproject.git
cd tierlist-creator-swonproject

# 2️⃣ Instala dependencias
npm install

# 3️⃣ Crea una rama para tu feature
git checkout -b feature/mi-nueva-caracteristica

# 4️⃣ Realiza tus cambios y commitea
git add .
git commit -m "feat: añadir nueva característica increíble"

# 5️⃣ Push a tu fork
git push origin feature/mi-nueva-caracteristica

# 6️⃣ Abre un Pull Request en GitHub! 🎉

📝 Scripts de Desarrollo

Comando Descripción Uso
npm run dev 🚀 Servidor de desarrollo Desarrollo local
npm run build 📦 Build para producción Deploy
npm run preview 👀 Preview del build Testing pre-deploy
npm run lint 🔍 Linter ESLint Code quality
npm run lint:fix 🔧 Auto-fix linting Corrección automática

🐛 Reportar Issues

🔍 Cómo reportar un bug efectivamente

Antes de reportar:

  • Busca si el issue ya existe
  • Reproduce el bug en la última versión
  • Verifica que no sea un problema de configuración

Incluye en tu reporte:

  • 📝 Descripción clara del problema
  • 🔄 Pasos para reproducir el bug
  • ✅ Comportamiento esperado vs ❌ actual
  • 📸 Screenshots/GIFs si es visual
  • 💻 Información del sistema:
    • OS: Windows/macOS/Linux
    • Navegador: Chrome/Firefox/Safari + versión
    • Versión de Node.js
    • Versión de la app

🐛 Reportar Bug💡 Solicitar Feature

📄 Licencia

License: MIT

Este proyecto está bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.

Libre para usar, modificar y distribuir

👨‍💻 Autor

Swon

Full Stack Developer & Game Dev Enthusiast

GitHub Website LinkedIn

"Creando herramientas que inspiran creatividad en la comunidad gaming"

🙏 Agradecimientos

💝 Tecnologías que hacen esto posible

React Vite DnD Kit Lucide Netlify

🌟 Inspiración y Comunidad

  • 🎮 Gaming Community - Por la pasión compartida por los videojuegos
  • ⚛️ React Community - Por las increíbles herramientas y recursos
  • 🎨 Design Community - Por la inspiración en UX/UI
  • 👥 Open Source Contributors - Por hacer posible el desarrollo colaborativo

⭐ ¡Si te gusta este proyecto, dale una estrella en GitHub! ⭐

Star History Chart

🚀 Contribuir • 🐛 Reportar Bug • 💡 Solicitar Feature

Hecho con ❤️ para la comunidad gaming

About

🎮 The ultimate tool for creating video game tier lists with advanced drag & drop, Steam API integration and HD export

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages