🍦 Vanilla IDE

Un IDE minimalista y ligero construido con Electron para desarrolladores que buscan simplicidad sin sacrificar funcionalidad.

---

✨ Características

💻 Editor de Código

• Editor completo con Ace Editor
• Soporte para múltiples lenguajes (JavaScript, Python, HTML, CSS, Java, C++, etc.)
• Resaltado de sintaxis automático
• Indentación inteligente

🖥️ Terminal Integrada

• Terminal Bash virtual integrada
• Ejecuta comandos directamente desde el IDE
• Output en tiempo real

🔗 Control de Versiones Git

• ✅ Inicializar repositorios
• ✅ Ver cambios en tiempo real (Modified, Added, Deleted)
• ✅ Stage y commit de archivos
• ✅ Publicar en GitHub, GitLab y otros repositorios remotos
• ✅ Historial de commits
• ✅ Configuración de credenciales

🤖 IA Integrada

• Autocompletado inteligente
• Edición mágica con Ctrl+K
• Sugerencias de código en tiempo real

🎨 Interfaz Moderna

• Tema Vanilla limpio y minimalista
• Logo personalizado
• Diseño responsivo
• Navegación intuitiva

---

🚀 Inicio Rápido

Requisitos Previos

• Node.js 16+ (descargar)
• Git instalado en el sistema (descargar)

Instalación

# 1. Clonar el repositorio
git clone https://github.com/Vanilla-IDE/vanilla-ide.git
cd vanilla-ide

# 2. Instalar dependencias
npm install

# 3. Ejecutar Vanilla IDE
npm start

Para instrucciones detalladas, consulta SETUP.md.

---

📚 Documentación

• Guía de Instalación y Setup - Instrucciones completas paso a paso
• Release Notes - Historial de cambios y versiones
• Guía Rápida - Tutorial básico de uso

---

📂 Estructura del Proyecto

vanilla-ide/
├── main.js                 # Punto de entrada de Electron
├── preload.js              # Bridge seguro frontend-backend
├── git-manager.js          # Módulo de Git
├── index.html              # UI principal
├── splash.html             # Pantalla de inicio
├── package.json            # Dependencias y scripts
├── assets/
│   └── logo.png            # Logo de la aplicación
├── README.md               # Este archivo
├── SETUP.md                # Guía de instalación
└── RELEASE_NOTES.md        # Historial de versiones

---

🎮 Cómo Usar

1️⃣ Abrir un Proyecto

Menu → Abrir Carpeta → Selecciona tu proyecto

2️⃣ Editar Código

• Haz clic en cualquier archivo en el explorador
• Edita en el editor central
• Los cambios se guardan automáticamente

3️⃣ Usar la Terminal

Pestaña "Terminal" → Ejecuta comandos normalmente

4️⃣ Control de Versiones

Panel Izquierdo → Control de Código Fuente

Opciones disponibles:

• 📍 Inicializar Repositorio
• 📋 Ver cambios sin staged
• ➕ Add All (agregar todos los cambios)
• 💾 Commit (guardar cambios)
• 📤 Push (publicar en remoto)
• 📜 Ver historial de commits

5️⃣ Publicar en GitHub/GitLab

1. Haz clic en "Push a Remoto"

2. Ingresa la URL de tu repositorio:

   https://github.com/usuario/nombre-repo.git
   

3. Ingresa tu Token Personal de GitHub:

   • Generar token en GitHub

4. Haz clic en "Publicar"

---

🔒 Seguridad

• Context Isolation activado en Electron
• Sandbox habilitado para procesos aislados
• Git ejecuta con permisos limitados
• Credenciales se manejan de forma segura

---

📦 Crear Instalador

Windows

npm run build

Genera ejecutables en la carpeta dist/:

• .exe portable (sin instalación)
• Instalador NSIS (opcional)

macOS / Linux

npm run build

---

🛠️ Tecnologías

Tecnología	Propósito
Electron	Desktop app framework
Ace Editor	Editor de código
Node.js	Runtime backend
Git	Control de versiones
Tailwind CSS	Estilos responsive

---

📋 Requisitos del Sistema

Requisito	Mínimo	Recomendado
RAM	512 MB	2 GB
Espacio	200 MB	500 MB
Procesador	i3 / Ryzen 3	i5 / Ryzen 5
SO	Windows 7+	Windows 10+

---

🐛 Reporte de Errores

Si encuentras un error:

1. Revisa los Release Notes para problemas conocidos
2. Abre un issue en GitHub
3. Incluye:
   • Sistema operativo
   • Versión de Vanilla IDE
   • Pasos para reproducir
   • Mensajes de error

---

🤝 Contribuciones

¡Las contribuciones son bienvenidas!

1. Fork el repositorio
2. Crea una rama: git checkout -b feature/mi-feature
3. Commit cambios: git commit -m "Agrega mi feature"
4. Push: git push origin feature/mi-feature
5. Abre un Pull Request

---

📄 Licencia

Este proyecto está bajo la licencia MIT. Ver LICENSE para más detalles.

---

👨‍💻 Autor

Juanoto2012
📧 juanoto2012@gmail.com
🌐 GitHub

---

🙏 Agradecimientos

• Ace Editor - Editor de código
• Electron - Framework para desktop
• Material Design Icons - Iconografía
• Comunidad open source

---

📞 Soporte

• 📖 Documentación Completa
• 🐛 Reportar Issues
• 💬 Diskusiones

---

Hecho con ❤️ por Juanoto2012