Pedro Wiezel

Downright

minha contribuição Design e desenvolvimento
categorias macOS
stack SwiftUI, AppKit, WebKit, Swift Markdown, Mermaid, KaTeX
O Downright num MacBook Pro, mostrando um diário de trilha com foto, citação e tabela

visão geral

Quase tudo o que escrevo com agentes de programação acaba em Markdown: especificações, planos, passagens de bastão e notas. O Downright começou como um de seis pequenos utilitários para Mac que construí num único repositório, com o nome provisório de Markdown Viewer, para ler esses arquivos do jeito que deveriam aparecer enquanto um agente continuava mudando o texto.

O Downright abre um arquivo Markdown como uma página limpa e acompanha o arquivo enquanto outro app escreve nele, sem perder o ponto de leitura. Ele desenha fórmulas, diagramas Mermaid, tabelas e código com destaque, abre uma pasta com seus wiki links e seu sumário e mostra uma prévia no Finder quando você aperta Espaço. Um comando abre qualquer arquivo pelo Terminal num título ou numa linha.

Durante algumas semanas de outubro ele também foi um editor, com o código-fonte e a prévia lado a lado e a rolagem dos dois sincronizada. O meu próprio teste à mão num M1 mostrou que quase tudo o que ainda falhava era do editor. Reduzi o app a um leitor, depois deixei a edição voltar numa forma menor, e em novembro tirei-a de vez. O Downright nunca foi pensado para ser um editor. O código removido continua no repositório, e a visualização do código-fonte agora mostra o arquivo exatamente como foi escrito, para ler e buscar.

O conforto de leitura decide quase todos os ajustes. São 13 temas, do papel tingido ao alto contraste, e cada cor de texto de cada tema é conferida contra a página em que aparece. Aumentar Contraste reforça o texto sem mudar a página. A interface e o guia vêm em 27 idiomas, com layouts da direita para a esquerda para árabe e hebraico.

A prévia é uma página WebKit dentro de uma janela SwiftUI, e a maior parte dos problemas difíceis estava nessa fronteira. Manter dois painéis alinhados exigiu aprender como o WebKit desenha uma rolagem que não foi ele quem começou. Mais tarde uma atualização do macOS ativou a ancoragem de rolagem e passou a arredondar a posição para pontos inteiros, e os testes do próprio app pegaram as duas mudanças antes que alguém visse a página pular.

Construí o Downright com o Claude e o Codex. As decisões de produto foram minhas, de cortar o editor ao que cada aviso diz, e também foi minha a conferência do que cada versão realmente fazia, à mão e por testes automáticos que abrem páginas reais. Quando a edição saiu, mandei reescrever do zero os testes do app, só em torno da leitura.

design

A página vem primeiro. O Liquid Glass fica na barra de ferramentas e nos avisos, e cada janela tem no máximo uma ação colorida, para que nada dispute atenção com o texto.

Cada tema parte de três cores, uma página, uma tinta e um link, e o resto é derivado para atender ao WCAG AA contra o tom mais escuro em que o texto pode aparecer. Os destaques da busca, as seleções e os contornos dos diagramas passaram pelas mesmas medições.

O ícone é um m cursivo simples sobre papel, desenhado a partir de um trabalho meu, numa versão clara e outra escura.

papel #F5F1E6
tinta #1F1C18
lamparina #F2ECE0

A página usa a fonte do sistema por padrão, com Serifada, Arredondada e Monoespaçada a uma escolha de distância.

Três dias a pé por Yosemite

A visualização do código-fonte mostra o arquivo como foi escrito, numa fonte monoespaçada.

## Primeiro dia — Happy Isles

créditos

pessoas

design · desenvolvimento
Pedro Wiezel