HOLOCRON SWU

Progressive Web App (PWA) companion para el juego de cartas Star Wars: Unlimited.

🌐 Producción: swusv.com

---

Features

• 🃏 Mi Botín — colección personal con import/export CSV/JSON/TXT
• ⚔️ Tracker en vivo — partidas con persistencia y log de movimientos
• 🏟️ Holocrón / Arena — historial completo de duelos + estadísticas
• 🏆 Sistema de Torneos — Swiss, eliminación, dashboard live, vista pública
• 🎯 Circuito — integración con Melee.gg
• 🌌 La Galaxia — explorador global de jugadores (rankings, actividad, mapa)
• 🕵️ Espionaje — perfiles públicos + visualizador de decks ajenos
• 🌍 Comunidades — por país/continente con feed propio
• 🎮 Gamificación — XP, niveles, achievements, misiones, trivia, frames animados
• 📦 Constructor de Decks — builder visual + validador + import/export
• 🔍 Base de cartas — búsqueda con caché local (Dexie/IndexedDB)
• 📲 PWA — instalable, funciona offline parcialmente

---

Stack

Frontend	React 19 + TypeScript 5.9 + Vite 7
UI	Tailwind CSS 4 + framer-motion + lucide-react
Estado	Zustand 5
Caché local	Dexie 4 (IndexedDB)
Routing	React Router 7 (lazy + Suspense)
PWA	vite-plugin-pwa
Backend	Supabase (Postgres + Auth + Storage + Realtime)
Hosting	Vercel (auto-deploy desde main)

---

Setup local

Requiere Node ≥ 20.

# 1. Clonar
git clone https://github.com/Neldark15/swu-companion.git
cd swu-companion

# 2. Dependencias
npm install

# 3. Variables de entorno (automático con Vercel CLI)
vercel link --yes --project=swu-companion
vercel env pull .env.local --environment=production --yes

# o manual: copiar .env.example a .env.local y rellenar
cp .env.example .env.local

# 4. Dev server
npm run dev
# http://localhost:5173

---

Comandos

npm run dev       # Vite dev server con HMR
npm run build     # tsc -b && vite build (chequea TS estricto)
npm run preview   # preview del build de producción
npm run lint      # eslint .

---

Deploy

git push origin main → webhook GitHub → Vercel build → swusv.com (~1-2 min).

No hay CI adicional. Siempre correr npm run build localmente antes de pushear para evitar romper el deploy.

---

Estructura

src/
├── App.tsx              # 46 rutas lazy + AuthGate
├── components/          # AuthGate, CardImage, SWIcons, layout, ui
├── features/            # 16 módulos (amistosas, cards, collection, community, decks, ...)
├── services/            # ~30 servicios (supabase, swuApi, sync, galaxyService, ...)
├── hooks/               # useAuth, useMatchPersistence, useSettings, useUIStore
├── data/                # regions.ts (continentes + países)
└── types/               # tipos TS compartidos

supabase/migrations/     # Esquemas y migraciones SQL
public/                  # Assets estáticos + íconos PWA

Más detalle técnico en CLAUDE.md.

---

Licencia

Privado. © NOVA ARQUITECTOS / Nel.