🦀 VaultLocal Desktop: Gestor de Notas Local-First con Tauri v2, Rust & Svelte 5

🦀 VaultLocal Desktop — Gestor de Notas Local-First (Tauri v2 + Rust + Svelte 5)

Alternativa a Obsidian Ultraligera, Privada y Sin Dependencias en la Nube

VaultLocal es una aplicación de escritorio nativa orientada a la privacidad y el rendimiento extremo (local-first). Construida con Tauri 2, un núcleo backend de alta velocidad en Rust y una interfaz moderna y reactiva en Svelte 5 (Runes), utiliza archivos Markdown planos en el disco local como única fuente de verdad, sin telemetría, sin suscripciones y con renderizado en vivo de KaTeX y Mermaid.

• 💻 Repositorio GitHub: github.com/Alecwce/vaultlocal (Privado)
• 🦀 Núcleo: Rust 2021 + Tauri 2.1 | Frontend: Svelte 5 + CodeMirror 6 + Vite 6

---

✨ Arquitectura del Sistema

flowchart TD
    Disk[("💾 Sistema de Archivos Local\n(Bóveda de archivos .md)")] <--> Watcher["🦀 Rust File Watcher\n(Crates: notify, walkdir, dunce)"]
    Watcher <--> TauriIPC["⚡ Tauri 2.1 IPC Bridge\n(Comandos nativos Rust / TypeScript)"]
    TauriIPC <--> SvelteUI["🎨 UI Reactiva Svelte 5\n(Runes, Vite 6, Árbol de Archivos)"]
    SvelteUI --> Editor["✏️ Editor CodeMirror 6\n(Markdown, Autocompletado, Búsqueda FTS)"]
    SvelteUI --> Renderer["📑 Pipeline de Renderizado Unified\n(Remark-GFM + Rehype + KaTeX + Mermaid 11)"]

1. Local-First & Cero Telemetría:
   • La totalidad de las notas residen exclusivamente en el disco duro del usuario. Cero sincronizaciones opacas o dependencias externas.
2. Editor Profesional con CodeMirror 6:
   • Resaltado sintáctico de Markdown, edición asistida, selección múltiple y atajos de teclado de alto rendimiento.
3. Pipeline de Renderizado Matemático y Gráfico:
   • Ecosistema Unified.js con soporte nativo para fórmulas matemáticas vía KaTeX, tablas GitHub Flavored Markdown (GFM) y diagramas interactivos vía Mermaid 11.
4. Reactividad de Nueva Generación con Svelte 5:
   • Interfaz construida con la nueva reactividad de Runes de Svelte 5, eliminando sobrecargas de memoria en comparación con entornos Electron tradicionales.
5. Observador de Archivos en Tiempo Real en Rust:
   • Integración con el crate notify para detectar cambios externos en los archivos .md de forma instantánea sin recargar la aplicación.

---

🛠️ Stack Tecnológico

Componente	Tecnología	Rol
Shell de Escritorio	Tauri 2.1.1	Enlace nativo ligero entre el sistema operativo y la webview
Backend Core	Rust (Edición 2021)	I/O de archivos de alta velocidad, indexación y eventos del OS
Frontend Framework	Svelte 5.20.2 (Runes)	Interfaz gráfica minimalista y reactiva
Editor de Texto	CodeMirror 6	Motor de edición extensible con soporte para Markdown
Parseo & Markdown	Unified + Remark + Rehype	Transformación de AST para previsualización en vivo
Diagramas & Fórmulas	Mermaid 11.16 + KaTeX 0.16	Renderizado visual de diagramas y matemáticas complejas
Testing Suite	Vitest 3.0 + Playwright 1.50	Pruebas unitarias de parsing y tests e2e de la aplicación

---

🚀 Comandos de Construcción y Test

cd vaultlocal-desktop
 
# Instalar dependencias con pnpm
pnpm install
 
# Iniciar entorno de desarrollo Tauri (Rust + Svelte 5)
pnpm tauri dev
 
# Ejecutar suite de pruebas unitarias
pnpm test
 
# Ejecutar pruebas end-to-end con Playwright
pnpm test:e2e
 
# Compilar ejecutable binario de producción
pnpm tauri build

---

🔗 Relación con el Ecosistema

• 🦀 Hermanos Tecnológicos en Rust/Tauri: Complementa a Tauri y a la bóveda Bóveda Web SvelteKit.
• 🎯 Catálogo de Proyectos: Documentado en Proyectos Privados.