Título:: Desktop Sticky Notes
URL:: https://nandomoreira.dev/lab/noctalia-desktop-sticky-notes

Desktop Sticky Notes

Plugin para o Noctalia Shell que prende notas adesivas na área de trabalho como widgets: cada nota pode ser arrastada e redimensionada, tem cor de post-it e texto em Markdown, abre um editor ao clique e pode ficar ligada a um arquivo .md no disco, atualizando quando o arquivo muda.

Problema

Lembretes rápidos ficavam espalhados entre arquivos e apps, longe da tela onde eu trabalho, e o Noctalia não tinha notas fixadas na própria área de trabalho.

Decisões técnicas

Cada nota é uma instância de widget de desktop, com texto, cores, tamanho, posição e escala próprios, salvos nas configurações do Noctalia para sobreviver ao reinício do shell. O clique abre um painel com foco de teclado, porque um widget de desktop não recebe digitação. Uma nota pode apontar para um arquivo Markdown, que vira a fonte da verdade. A lógica em JavaScript é coberta por testes no Vitest; o renderizador de Markdown e o layout do editor vêm do plugin sticky-notes de sapjax, também MIT.

Resultado

MVP funcionando no meu desktop, testado no Noctalia 4.7.7, em inglês e português. Publicado em licença MIT e ainda não enviado ao registro de plugins do Noctalia.

Atalhos

Ctrl+S: salva a nota e fecha o editor
Esc: também salva e fecha

Links

Repo: https://github.com/nandomoreirame/noctalia-desktop-sticky-notes

---
title: Desktop Sticky Notes
url: https://nandomoreira.dev/lab/noctalia-desktop-sticky-notes
collection: lab
tech:
  - QML
  - JavaScript
  - Noctalia Shell
  - Markdown
  - Vitest
date: 2026-06-09
---

# Desktop Sticky Notes

Plugin para o Noctalia Shell que prende notas adesivas na área de trabalho como widgets: cada nota pode ser arrastada e redimensionada, tem cor de post-it e texto em Markdown, abre um editor ao clique e pode ficar ligada a um arquivo .md no disco, atualizando quando o arquivo muda.

## Problema

Lembretes rápidos ficavam espalhados entre arquivos e apps, longe da tela onde
eu trabalho, e o Noctalia não tinha notas fixadas na própria área de trabalho.

## Decisões técnicas

Cada nota é uma instância de widget de desktop, com texto, cores, tamanho,
posição e escala próprios, salvos nas configurações do Noctalia para
sobreviver ao reinício do shell. O clique abre um painel com foco de teclado,
porque um widget de desktop não recebe digitação. Uma nota pode apontar para
um arquivo Markdown, que vira a fonte da verdade. A lógica em JavaScript é
coberta por testes no Vitest; o renderizador de Markdown e o layout do editor
vêm do plugin sticky-notes de sapjax, também MIT.

## Resultado

MVP funcionando no meu desktop, testado no Noctalia 4.7.7, em inglês e
português. Publicado em licença MIT e ainda não enviado ao registro de plugins
do Noctalia.

## Atalhos

- `Ctrl+S`: salva a nota e fecha o editor
- `Esc`: também salva e fecha

## Links

- Repo: https://github.com/nandomoreirame/noctalia-desktop-sticky-notes