nanote
Aplicación auto-alojada ligera para gestión de notas con almacenamiento basado en sistema de archivos, construida con Nuxt 4, TypeScript y Vue. Objetivo: portabilidad total sin bases de datos.
Ficha actualizada 25 sept 2026, 12:59 · upstream 25 sept 2026, 12:53 · release 0.11.0
Qué es nanote
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Nanote es una aplicación auto-alojada ligera para gestión de notas con almacenamiento basado en sistema de archivos, construida con Nuxt 4, TypeScript y Vue. Su objetivo principal es la portabilidad total de las notas sin depender de bases de datos, utilizando carpetas y archivos markdown nativos.
La aplicación permite organizar notas mediante notebooks (carpetas) y archivos markdown individuales, ofreciendo búsqueda universal optimizada por sistema operativo y soporte completo para Markdown con tipos MIME correctos. Incluye autenticación básica mediante variable de entorno SECRET_KEY (por defecto "nanote") y personalización de directivas Remark como ::file, ::today, ::time, etc., que permiten insertar archivos o mostrar fechas/horas dinámicamente en las notas.
La arquitectura utiliza Nuxt 3/Vue con Pinia para estado, Tailwind 3 para estilos y Milkdown como editor principal. Expone una API REST tipada con validación, aunque documentada de forma limitada debido a su etapa temprana de desarrollo. El despliegue soporta Docker con imagen oficial en Docker Hub o construcción local, requiriendo ugrep instalado en el sistema anfitrión para operaciones de búsqueda eficientes.
- Gestión personal de notas sin dependencia de bases de datos
- Almacenamiento portátil de documentación técnica en formato markdown
- Organización de tareas mediante checklists y rollup (pendiente)
- Integración con flujos de trabajo auto-alojados sin servidor centralizado
- Portabilidad total: las notas son archivos locales editables con cualquier editor
- Sin base de datos: almacenamiento directo en sistema de archivos nativo
- Docker ready: incluye compose file y documentación de despliegue containerizado
- API REST tipada: endpoints validados con TypeScript para integración segura
- Autenticación básica sin cifrado por defecto (SECRET_KEY debe configurarse manualmente)
- Funcionalidades pendientes como archivado, rollup de checklists y encriptación
- Dependencia de ugrep instalado en el sistema anfitrión para búsqueda optimizada
- Documentación API incompleta debido a etapa temprana de desarrollo
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Node.js 18+, PNPM 8+ y Docker opcional. Configurar variables NOTES_PATH, UPLOAD_PATH, CONFIG_PATH y SECRET_KEY en el compose file. Montar volúmenes locales para persistencia de datos. Imagen oficial disponible en omarmir/nanote o construir localmente con docker build.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.