flows.md · documentação · Blocos

@auth#

A entrada de um app ou de uma área de membros, na própria página dele. A pessoa digita o e-mail, recebe um código de seis dígitos por e-mail e digita no mesmo bloco: entrou. Não tem senha, e ela não passa pelas telas de entrada do flows.md. Um e-mail que ainda não tem conta ganha uma quando o código prova que a caixa é dela.

Ao vivo#

Um bloco sem argumento nenhum já é uma entrada completa: entra e volta para a mesma página.

```@auth
```

Com as suas palavras, um grupo e para onde ir#

```@auth group:"Passada · atletas" next:./app/perfil title:"Entre na Passada" submit:"Receber o código"
Use o e-mail. Enviamos um código de entrada, sem senha.
```

• group — quem entra também passa a fazer parte desse grupo quando a porta dele é aberta, ou pede para participar quando é por pedido. Um grupo só por convite, ou uma porta com perguntas, nunca é resolvido aqui: o bloco mostra o caminho para a página do grupo.
• next — para onde a pessoa vai depois de entrar: uma página do espaço desta página, escrita como um link de página (/@espaco/app, ./app, ../app, :/app). Outro espaço ou um endereço completo é recusado.
• O texto dentro do bloco é a ajuda embaixo do título.

O que cada pessoa vê#

• Quem não entrou: o título, a ajuda, um campo de e-mail e o botão.
• Depois de pedir o código: "Enviamos um código para…", o campo do código e "Usar outro e-mail".
• Quem já entrou: "Você entrou como…", e então o botão para continuar, Participar, Pedir para participar, "pedido enviado" ou o caminho para a página do grupo — e Sair.

O bloco é a porta, então ele nunca fica escondido: group: diz para quem é a entrada e não esconde nada. O que só o grupo vê fica nos outros blocos, com members_of::

```@data collection:treinos members_of:"Passada · atletas"
```

Onde ele não envia#

No endereço próprio do espaço (nome.flows.md) e num domínio próprio a página é só leitura, sem sessão: ali o bloco vira um link Entrar para a mesma página no endereço do flows.md, onde a entrada acontece. No editor ele aparece como quem ainda não entrou vê, sem enviar nada.

Pronto para colar#

O padrão Entrar (/@docs/patterns/entrar) é uma seção com este bloco num cartão centralizado: insert_pattern entrar pelo MCP, ou Layout ▸ Insert… no editor.

Argumentos#

• group — um grupo, pelo nome ou pelo id, como em members_of:.
• next — a página do mesmo espaço para onde ir depois de entrar. Sem ele, a pessoa fica nesta página.
• title — a linha acima do formulário. Padrão: "Entrar".
• submit — o texto do botão que pede o código. Padrão: "Receber o código".
• consent — como em todo bloco.