Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
local_testing/
136 changes: 136 additions & 0 deletions README.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,136 @@
# Discord Embed Creator

[🇪🇸 Versión en español](README.md)

---

**🌐 App URL:**
> [https://salmonidas.github.io/discord-embed-message-builder](https://salmonidas.github.io/discord-embed-message-builder/)

---

## What is Discord Embed Creator?

An advanced visual generator for Discord embed messages, designed to facilitate professional creation, management, and sending of rich media messages via webhooks.
It allows you to save templates, change languages and themes, and manage multiple webhooks locally and securely.

---

## Main Features

- **Visual embed creation:** Fill in the fields from the side panel and view changes in real time.
- **Light/dark theme and instant language switching (ES/EN).**
- **Local webhook management:** Add, modify, or remove your Discord webhook URLs. Completely isolated between main page and templates.
- **Smart templates:** Save, load, and share designs as unique links. Templates maintain their own independent webhook configuration.
- **Real-time preview of the final result.**
- **Clear modal system** for notifications, errors, and confirmations (no invasive popups).
- **Character counters** in all fields to respect Discord limits.
- **Help center** with practical video tutorial and step-by-step guide.
- **Full support for emojis, special characters, URLs, and multimedia elements.**
- **Private and secure configuration:** All your data (webhooks, templates, preferences) is stored exclusively in your browser.
- **Complete legal information:** Privacy Policy, Terms of Use, and Cookies accessible in the footer.

---

## How to use each section

### 1. Embeds

- Complete the data in the side panel (title, description, color, author, footer, image, thumbnail, custom fields).
- Changes are shown in the preview immediately.
- Use the integrated validator to ensure all fields meet Discord requirements.

### 2. Webhooks

- Add your Discord webhook URL(s).
- Switch between them quickly or assign one per template.
- The system prevents contamination between main page and templates (each context has its own webhooks).
- Test your webhook before sending important messages.

### 3. Templates

- Save any design as a template, generate a unique link, and share it.
- Load saved templates from the template manager.
- Templates are completely independent in terms of webhook configuration and data.
- Export templates as JSON for backups or import into other systems.

### 4. Help Center

- Access visual tutorials, practical examples, and frequently asked questions.
- Report bugs or suggest improvements using the GitHub Issues button.
- Check the video tutorial section to learn advanced features.

---

## Best Practices and Tips

- **Save links to your favorite templates** as shortcuts to always have them at hand.
- **Don't worry about privacy:** Everything stays in your browser; no one accesses your embeds or webhooks.
- **Use the notification system** to know if there are errors, save confirmations, etc.
- **Always check Discord limits:** The integrated validator prevents sending malformed embeds.
- **Report any bugs** using the Issues button in the help center.
- **Change the language and theme** to your liking at any time; your preferences are saved automatically.
- **The donation banner** and heart are optional and don't affect your experience.

---

## Technical and Security Notes

### Validations

- URLs must have a valid format (`http://` or `https://`).
- Hexadecimal colors are validated before saving.
- Each required field shows an error if information is missing.
- Embeds are validated against Discord's official limits before sending.

### Webhook Management

- Webhooks and templates are independent; changes to templates do NOT affect your main configuration.
- Each webhook is tested before being assigned to prevent sending errors.
- Webhooks are stored locally in your browser securely.

### Export and Import

- You can export any embed as valid JSON for use in other bots or tools.
- Import templates from JSON to reuse designs from other users.
- All exported data maintains compatibility with the Discord API.

### Internationalization

- The web is available in Spanish and English, with automatic translation of the entire interface.
- Language changes are applied instantly without losing your work.

---

## How to Report Bugs or Suggest Improvements

- Go to the **Help Center** (question mark icon).
- Click the **"Report Error"** button to open an issue on GitHub.
- Attach screenshots, a clear description, and steps to reproduce the problem if possible.
- You can also suggest new features in the same way.

---

## Privacy and Storage

All your data is stored exclusively in your browser:
- **Webhooks:** Stored on your device, not on remote servers.
- **Templates:** Saved locally with shareable access via unique link.
- **Preferences:** Language, theme, and settings saved in your browser.
- **Embeds:** Never transmitted or stored on external servers.

Check the **Privacy Policy** in the footer for more details.

---

## Requirements and Supported Browsers

- **Browsers:** Chrome, Firefox, Safari, Edge (recent versions).
- **JavaScript:** Must be enabled.
- **Local Storage:** Your browser must allow local storage (localStorage).

---

Enjoy creating your Discord embed messages!

For more information or support, contact through the Help Center or open an issue on GitHub.
138 changes: 136 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,136 @@
# discord-embed-message-builder
Web para crear mensajes embed personalizados para tus canales de discord
# Discord Embed Creator

[English version](README.en.md)

---

**🌐 URL de la app:**
> [https://salmonidas.github.io/discord-embed-message-builder](https://salmonidas.github.io/discord-embed-message-builder/)

---

## ¿Qué es Discord Embed Creator?

Un generador visual avanzado de mensajes embed para Discord, diseñado para facilitar la creación profesional, gestión y envío de mensajes rich media mediante webhooks.
Permite guardar plantillas, cambiar idiomas y temas, y gestionar múltiples webhooks de forma local y segura.

---

## Funcionalidades Principales

- **Creación visual de embeds:** Rellena los campos desde el panel lateral y visualiza los cambios en tiempo real.
- **Tema claro/oscuro y cambio de idioma instantáneo (ES/EN).**
- **Gestión local de webhooks:** Añade, modifica o elimina tus URLs de Discord webhooks. Totalmente aislados entre página principal y plantillas.
- **Plantillas inteligentes:** Guarda, carga y comparte diseños como enlaces únicos. Las plantillas mantienen su configuración de webhooks independiente.
- **Previsualización en tiempo real del resultado final.**
- **Sistema claro de modales** para notificaciones, errores y confirmaciones (sin popups invasivos).
- **Contadores de caracteres** en todos los campos para respetar los límites de Discord.
- **Centro de ayuda** con tutorial práctico en video y guía paso a paso.
- **Soporte completo para emojis, caracteres especiales, URLs y elementos multimedia.**
- **Configuración privada y segura:** Todos tus datos (webhooks, plantillas, preferencias) se guardan únicamente en tu navegador.
- **Legal completo:** Política de Privacidad, Términos de Uso y Cookies accesibles en el footer.

---

## Cómo usar cada apartado

### 1. Embeds

- Completa los datos en el panel lateral (título, descripción, color, autor, pie, imagen, miniatura, campos personalizados).
- Los cambios se muestran en la vista previa de inmediato.
- Utiliza el validador integrado para asegurar que todos los campos cumplen con los requisitos de Discord.

### 2. Webhooks

- Añade tu(s) URL(s) de webhook de Discord.
- Cambia entre ellas rápidamente o asigna una por plantilla.
- El sistema previene la contaminación entre página principal y plantillas (cada contexto tiene sus propios webhooks).
- Prueba tu webhook antes de enviar mensajes importantes.

### 3. Plantillas

- Guarda cualquier diseño como plantilla, genera un enlace único y compártelo.
- Carga plantillas guardadas desde el gestor de plantillas.
- Las plantillas son totalmente independientes en cuanto a configuración de webhooks y datos.
- Exporta plantillas como JSON para respaldos o importación en otros sistemas.

### 4. Centro de Ayuda

- Accede a tutoriales visuales, ejemplos prácticos y preguntas frecuentes.
- Reporta errores o sugiere mejoras usando el botón de GitHub Issues.
- Consulta la sección de video tutorial para aprender funciones avanzadas.

---

## Buenas prácticas y consejos

- **Guarda enlaces de tus plantillas favoritas** como acceso directo para tenerlas siempre a mano.
- **No te preocupes por la privacidad:** Todo se queda en tu navegador; nadie accede a tus embeds o webhooks.
- **Utiliza el sistema de notificaciones** para saber si hay errores, confirmaciones de guardado, etc.
- **Siempre revisa los límites de Discord:** El validador integrado evita enviar embeds malformados.
- **Reporta cualquier bug** mediante el botón de Issues en la ayuda.
- **Cambia el idioma y el tema** a tu gusto en cualquier momento; tus preferencias se guardan automáticamente.
- **El banner de donación** y el corazón son opcionales y no afectan tu experiencia.

---

## Notas Técnicas y de Seguridad

### Validaciones

- Las URLs deben tener formato válido (`http://` o `https://`).
- Los colores hexadecimales se validan antes de guardar.
- Cada campo requerido muestra error si falta información.
- Los embeds se validan contra los límites oficiales de Discord antes de enviar.

### Gestión de Webhooks

- Los webhooks y plantillas son independientes; los cambios en plantillas NO afectan tu configuración principal.
- Cada webhook se prueba antes de asignarse para evitar errores en el envío.
- Los webhooks se guardan localmente en tu navegador de forma segura.

### Exportación e Importación

- Puedes exportar cualquier embed como JSON válido para usarlo en otros bots o herramientas.
- Importa plantillas desde JSON para reutilizar diseños de otros usuarios.
- Todos los datos exportados mantienen compatibilidad con la API de Discord.

### Internacionalización

- La web está disponible en español e inglés, con traducción automática de toda la interfaz.
- Los cambios de idioma se aplican instantáneamente sin perder tu trabajo.

---

## Cómo reportar errores o sugerir mejoras

- Dirígete al **Centro de Ayuda** (ícono de signo de interrogación).
- Pulsa el botón **"Reportar error"** para abrir un Issue en GitHub.
- Adjunta capturas de pantalla, descripción clara y pasos para reproducir el problema si es posible.
- También puedes sugerir nuevas funcionalidades de la misma forma.

---

## Privacidad y Almacenamiento

Todos tus datos se almacenan exclusivamente en tu navegador:
- **Webhooks:** Almacenados en tu dispositivo, no en servidores remotos.
- **Plantillas:** Guardadas localmente con acceso compartible mediante enlace único.
- **Preferencias:** Idioma, tema y configuración guardados en tu navegador.
- **Embeds:** Nunca se transmiten ni se almacenan en servidores externos.

Consulta la **Política de Privacidad** en el footer para más detalles.

---

## Requisitos y Navegadores Soportados

- **Navegadores:** Chrome, Firefox, Safari, Edge (versiones recientes).
- **JavaScript:** Debe estar habilitado.
- **Almacenamiento local:** Tu navegador debe permitir almacenamiento local (localStorage).

---

¡Disfruta creando tus mensajes embed para Discord!

Para más información o soporte, contacta a través del Centro de Ayuda o abre un Issue en GitHub.
Loading