Saltar al contenido
Alsatian Docs: documento de diseño en vista dividida con tabla y código resaltado.
Todos los proyectos

Software y herramientasEn desarrollo

Alsatian Docs

Editor de Markdown local-first con historial de versiones en GitHub y edición colaborativa en tiempo real.

Mi papel
Diseño y desarrollo
Estado
En desarrollo
Tecnologías
  • TypeScript
  • React
  • Electron
  • CodeMirror 6
  • Yjs
  • Cloudflare Durable Objects
  • Capacitor
  • Tailwind CSS
  • Vitest
  • Playwright

Descripción general

Alsatian Docs es un editor de documentos Markdown para escritorio (Linux y Windows) y Android. Cada documento es un archivo .md real, editable desde cualquier otro programa: la aplicación no encierra el contenido en un formato propio.

Sobre esa base añade lo que normalmente exige herramientas separadas: historial de versiones con Git explicado con un vocabulario sencillo, sincronización con GitHub y varias personas editando el mismo documento a la vez.

Se desarrolla por entregas. La hoja de ruta del proyecto documenta qué está hecho, cómo se verificó y qué falta validar.

  • Editor y vista previa sincronizados (datos de ejemplo)
  • Control de versiones con Git, sin jerga (datos de ejemplo)

Funcionalidades principales

  1. 01

    Editor y vista previa

    CodeMirror 6 con Markdown/GFM, vista previa segura con resaltado de código y vista dividida con desplazamiento sincronizado en ambos sentidos.

  2. 02

    Guardado que no pisa cambios

    Guardado atómico y autoguardado que nunca sobrescriben cambios hechos fuera de la app sin preguntar, conservando codificación y saltos de línea byte a byte.

  3. 03

    Git sin jerga

    «Guardar versión», «traer cambios» y «publicar»: ramas, comparación, historial por documento y conflictos resueltos dentro del propio editor.

  4. 04

    Colaboración en tiempo real

    Cursores con nombre sobre Yjs y Cloudflare Durable Objects. Sin conexión se sigue escribiendo y se sincroniza al volver.

  5. 05

    GitHub sin contraseñas

    Conexión mediante una GitHub App con Device Flow, sin secretos en la aplicación y con los tokens cifrados en el llavero del sistema.

  6. 06

    Escritorio y Android

    Instaladores AppImage, .deb y Windows, y una app Android con Capacitor. Exporta a PDF y a Word.

Participación y responsabilidades

Mi papel

Diseño y desarrollo

  • Arquitectura del monorepo: escritorio, móvil y servidor de colaboración.
  • Integración con Git y GitHub, incluida la resolución de conflictos.
  • Colaboración en tiempo real y fusión en tres vías al publicar.
  • Pruebas unitarias, de integración y E2E, y releases automatizadas desde CI.