```meta
title: @auth — a entrada do seu app
description: O login do app, na página do app: a pessoa digita o e-mail, recebe um código de seis dígitos e digita ali mesmo. Sem senha, e sem sair para outra tela.
```

_flows.md · documentação · [Blocos](/@docs/blocks)_

# @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
```

~~~text
```@auth
```
~~~

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

~~~text
```@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:`:

~~~text
```@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](/@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.