create-canaima-app

El CLI oficial para arrancar proyectos Tauri + Vue 3 al estilo Canaima GNU/Linux 🇻🇪

¡Hola! 👋 Bienvenido a create-canaima-app. Esta es una herramienta interactiva de línea de comandos (CLI) creada para la comunidad de Canaima GNU/Linux, diseñada para facilitarte enormemente la vida al momento de iniciar proyectos de escritorio modernos y excepcionalmente rápidos utilizando Tauri y Vue 3.

Nuestro objetivo es brindar soberanía tecnológica con las mejores herramientas de desarrollo web adaptadas al escritorio.

🚀 Uso Rápido

No necesitas instalar el paquete globalmente, simplemente ejecuta:

npx create-canaima-app@latest

1. El nombre de tu proyecto.
2. La plantilla y el sistema de estilos que prefieras (Tailwind CSS o Materialize CSS).
3. Si deseas instalar las dependencias de NPM automáticamente.
4. Si deseas inicializar un repositorio Git local (si tienes Git instalado).

¡Y listo! Todo quedará configurado, desde el package.json hasta el tauri.conf.json, listo para que empieces a programar.

📦 Plantillas Disponibles

Hemos preparado dos plantillas robustas y modernas para que inicies con el pie derecho, ambas bajo la filosofía de Material Design:

1. Tauri + Material Tailwind (tauri-material-tailwind)

La modernidad de Tailwind CSS unida a los componentes prefabricados que emulan Material Design. Ideal para quienes disfrutan maquetar rápidamente con clases utilitarias de Tailwind, sin sacrificar la apariencia pulida de Material.

2. Tauri + Materialize CSS (tauri-materialize)

Para los amantes del diseño clásico de Material Design, esta plantilla integra el ecosistema de Materialize CSS nativamente con Vue 3. Está pensada para quienes prefieren la escritura tradicional de CSS, combinada con Javascript modularizado para los componentes interactivos.

🗂️ Estructura de tauri-materialize

Cuando creas un proyecto usando esta plantilla, obtienes una estructura sumamente organizada y orientada a la mantenibilidad:

📦 mi-app-canaima
 ┣ 📂 public/              # Assets públicos (favicon, logos originales)
 ┣ 📂 src-tauri/           # Backend en Rust (El corazón de Tauri)
 ┃ ┣ 📂 icons/             # Iconos para el binario generado
 ┃ ┣ 📂 src/
 ┃ ┃ ┗ 📜 main.rs          # Punto de entrada de la aplicación Rust
 ┃ ┣ 📜 build.rs           # Script de compilación de Tauri
 ┃ ┣ 📜 Cargo.toml         # Dependencias de Rust (¡Ya con el nombre de tu app!)
 ┃ ┗ 📜 tauri.conf.json    # Configuración maestra de Tauri
 ┣ 📂 src/                 # Frontend en Vue 3
 ┃ ┣ 📂 assets/            # CSS y multimedia
 ┃ ┃ ┣ 📜 index.css        # Variables Materialize y colores de Canaima
 ┃ ┃ ┗ 📜 materialize.css  # El framework CSS principal
 ┃ ┣ 📂 components/        # Componentes Vue reutilizables
 ┃ ┃ ┣ 📜 Greet.vue        # Componente de ejemplo (Tauri Invoke)
 ┃ ┃ ┗ 📜 Navbar.vue       # Barra de navegación principal Materialize
 ┃ ┣ 📂 router/            # Configuración de Vue Router
 ┃ ┃ ┗ 📜 index.js
 ┃ ┣ 📂 views/             # Páginas individuales
 ┃ ┃ ┣ 📜 HomeView.vue
 ┃ ┃ ┗ 📜 AboutView.vue
 ┃ ┣ 📜 App.vue            # Componente raíz de Vue
 ┃ ┗ 📜 main.js            # Punto de entrada del frontend (Inicializa Materialize, Router y Pinia)
 ┣ 📜 index.html           # Plantilla base (¡Ya con el título de tu app!)
 ┣ 📜 package.json         # Dependencias de Javascript
 ┣ 📜 vite.config.js       # Configuración de Vite
 ┗ 📜 README.md            # Documentación de tu proyecto

Beneficios incluidos en tauri-materialize:

• 🌓 Soporte base para el framework Materialize.
• 🚦 vue-router interconectado y listo para añadir múltiples páginas.
• 🍍 pinia listo en caso de necesitar manejo de estado global.
• 🎨 Variables de color unificadas con la paleta de Canaima (#0b6793).

💖 Agradecimientos y Tecnologías Base

Construimos sobre hombros de gigantes, porque la comunidad del Software Libre nos enseña que colaborando llegamos más lejos. Agradecemos enormemente a:

• Tauri: Por brindarnos la manera más segura, liviana e increíble de construir aplicaciones de escritorio usando tecnologías web y el poder de Rust 🦀.
• Vue.js (Vue 3): Por ser el framework progresivo de Javascript más elegante, fácil de aprender y con el mejor ecosistema para construir interfaces dinámicas.
• Tailwind CSS: Por revolucionar la manera en que maquetamos aplicaciones web haciéndolo todo más eficiente.
• Materialize CSS y Material Tailwind: Por facilitarnos la implementación de un Material Design visualmente espectacular sin dolores de cabeza.
• Y por supuesto, a la comunidad de Canaima GNU/Linux, que siempre se ha mantenido fiel a los propósitos de libertad y soberanía popular.

👨‍💻 Contribuir

¡Todo aporte es bienvenido! Si encuentras algún issue o quieres proponer una mejora (como nuevas plantillas), siéntete libre de abrir un Pull Request en nuestro repositorio.