• Acerca del proyecto
• Características
• Tecnologías y versiones
• Inicio rápido
• Scripts
• Estructura del proyecto
• Data Manager CLI
• Configuración
• Deploy
• Contribuir
• Licencia
• Contacto

Worship Box es una aplicación web moderna para explorar y descargar secuencias musicales, charts y recursos de software para producción musical cristiana. Está diseñada con un enfoque en experiencia de usuario, rendimiento y accesibilidad.

• Búsqueda rápida y filtrado por artista, álbum y canción.
• Charts integrados por canción.
• Catálogo de recursos: DAWs, plugins y utilidades con múltiples servicios de descarga.
• Formulario de aportes con validación en tiempo real, control de frecuencia y notificaciones por EmailJS (sin enlaces magnet/torrent).
• Interfaz responsive, tema claro/oscuro y multilenguaje (ES/EN/PT).

Basado en app/package.json.

• Node.js LTS
• npm

git clone https://github.com/oscarmp7/worship-box.git
cd worship-box/app
npm install
npm run dev

La aplicación estará disponible en http://localhost:5173/.

worship-box/
├── app/
│   ├── src/
│   │   ├── components/
│   │   │   ├── views/
│   │   │   ├── HeaderBar.jsx
│   │   │   ├── Sidebar.jsx
│   │   │   └── MainContent.jsx
│   │   ├── data/
│   │   │   ├── secuencias.json
│   │   │   └── software.json
│   │   ├── locales/
│   │   ├── services/
│   │   ├── utils/
│   │   └── workers/
│   ├── tools/
│   │   └── data-manager.cjs
│   ├── aportes/
│   └── backups/
└── README.md

Herramienta CLI para gestionar datos desde Excel (XLSX), validar integridad y administrar aportes.

# Menú interactivo
node tools/data-manager.cjs

# Comandos directos
node tools/data-manager.cjs --export
node tools/data-manager.cjs --import
node tools/data-manager.cjs --validar
node tools/data-manager.cjs --sync-stats
node tools/data-manager.cjs --eliminar-vacios
node tools/data-manager.cjs --help

Crear app/.env a partir de app/.env.example y configurar:

VITE_EMAILJS_SERVICE_ID=
VITE_EMAILJS_TEMPLATE_FORM_ID=
VITE_EMAILJS_TEMPLATE_THANKS_ID=
VITE_EMAILJS_PUBLIC_KEY=
VITE_EMAILJS_TO_EMAIL=[email protected]
VITE_CONTRIBUTE_ENDPOINT=
VITE_EMAILJS_ATTACH_XLSX=false

1. Crear cuenta en EmailJS.
2. Configurar el servicio de email.
3. Crear plantillas Contribution (formulario de aporte) y Thank You (agradecimiento).

cd app
npm run deploy

URL: https://worshipbox.vercel.app

1. Fork del proyecto.
2. Crea tu rama (git checkout -b feature/mi-feature).
3. Commit (git commit -m "feat: mi feature").
4. Push (git push origin feature/mi-feature).
5. Abre un Pull Request.

También puedes contribuir desde la aplicación usando el formulario de aportes.

MIT.

Worship Box Ministry

• Email: [email protected]
• Web: https://worshipbox.vercel.app