flows.md · documentação

Site#

Todo espaço que é de alguém responde num endereço só dele: o nome do espaço, sem separadores, em flows.md. O espaço @ana responde em ana.flows.md, e @jonas.porto em jonasporto.flows.md. Não precisa configurar nada: o endereço existe desde que o espaço é seu.

Esse endereço é um site, não o app. Ele mostra só o que qualquer pessoa pode ler, e nada mais: ninguém entra, ninguém edita, nenhum cookie é gravado por lá. Editar continua sendo em flows.md/@ana, como sempre.

Um endereço por página#

Uma página pública tem um endereço só, no site, na forma curta: flows.md/@ana/post é lida em ana.flows.md/post. É esse endereço que a busca indexa, que o cartão de um link mostra e que o link do MCP responde. O endereço no app continua abrindo a mesma página, e diz ao Google qual é o oficial.

Uma página cujo nome curto significa outra coisa no site (/core, /assets) continua no endereço longo, ana.flows.md/@ana/core.

A capa#

Um espaço nasce privado, e cada página nova nasce privada. Então o site precisa de uma casa: a capa, a página em que ele abre. Uma por espaço, escolhida entre as páginas que qualquer pessoa pode ler, nunca a raiz. A capa responde em ana.flows.md/ e só ali: o endereço próprio dela leva para /. As outras páginas públicas mantêm os seus endereços.

Onde escolher, em qualquer um dos três lugares:

Site (Pro), na barra lateral, logo abaixo do Inbox: o endereço do site, a capa de hoje e as páginas que podem ser capa.
O menu … de uma página na barra lateral: "Usar como capa", ou "Remover como capa" na própria capa.
As configurações da página, ao lado do QR code.

Marcar a primeira capa é um clique. Marcar outra, quando já existe uma, pergunta antes, dizendo qual é a capa de hoje. Trocar de capa é assim que se muda a cara do site sem reescrever nada: escreva a página nova, publique e marque.

Sem capa#

Se a raiz do espaço é pública, ela é a capa, como um site inteiro. Se a raiz é privada e nenhuma página foi marcada, o site mostra uma página limpa: o nome do espaço e a frase "ainda está arrumando a casa". Nada do que está dentro é dito.

Uma capa que deixa de ser pública fica marcada, inativa, e o site volta à página limpa até ela ser publicada de novo.

Quem chega pelo app#

Um visitante que abre flows.md/@ana sem poder ler a raiz é levado para ana.flows.md: a capa, ou a página limpa. Uma página compartilhada com alguém continua pedindo login, porque é assim que essa pessoa chega nela.

Um blog#

Um blog é uma pasta: cada texto é uma página dentro dela. Na página da pasta, um bloco lista os textos, o mais novo primeiro, com a data e uma linha de cada:

```@posts
```

A data é a que o texto diz no seu meta (date: 2026-09-12), ou o dia em que a página foi criada. Se a pasta é pública, ela também tem feed, para quem acompanha num leitor: ana.flows.md/blog.rss (RSS) e ana.flows.md/blog.atom (Atom). O feed só tem o que qualquer pessoa pode ler, e a lista termina com os dois links.

Agentes (MCP)#

front_page mostra a capa de cada espaço, marca uma (front_page ~/sobre) e desmarca (front_page ~/sobre clear:true). details diz se a página é a capa e qual é o endereço no site; manual site explica tudo isto.

O que vem depois#

O domínio próprio, para o plano Pro: o site do espaço no endereço que é seu, com a raiz do domínio como endereço.