> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Como criar seu primeiro projeto

> Seu primeiro site ou app, pronto hoje

Você descreve o que quer em linguagem simples e o Macaly constrói para você. É como mandar mensagem para um desenvolvedor muito habilidoso que trabalha na hora.

<iframe width="100%" height="420" src="https://www.youtube.com/embed/videoseries?list=PL_6FnllPMh1G-XbXlylnuEJk9yUGBGEHn" title="Macaly tutorials" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen />

## Antes de começar

Você não precisa de um plano detalhado. Mas, se não sabe por onde começar, estes são ótimos primeiros projetos:

<CardGroup cols={2}>
  <Card title="Landing page" icon="browser">
    Simples, objetiva e rápida de construir. Perfeita para testar uma ideia.
  </Card>

  <Card title="Portfólio pessoal" icon="user">
    Poucas páginas sobre você, seu trabalho e como entrar em contato.
  </Card>

  <Card title="Site institucional" icon="building">
    Início, sobre, serviços, contato. Uma estrutura inicial sólida.
  </Card>

  <Card title="Painel interno" icon="table-columns">
    Uma ferramenta simples para sua equipe acompanhar tarefas ou exibir dados.
  </Card>
</CardGroup>

**O que deixar à mão:**

* Uma breve descrição do assunto do seu site (uma frase basta)
* Seu logotipo, se tiver um
* As cores da sua marca ou um site de referência cujo visual você goste

<Note>
  Não se prenda a detalhes. Tudo pode ser alterado depois, então sua primeira versão não precisa ser perfeita.
</Note>

## Crie seu primeiro projeto

<Steps>
  <Step title="Abra o Macaly e comece um novo projeto">
    Entre em [macaly.com](https://www.macaly.com/). O campo de prompt fica em destaque na tela inicial.

    <img src="https://mintcdn.com/macaly-41b1d3e9/3b1-nExOoaeiOJYq/images/guides_first-project_01.png?fit=max&auto=format&n=3b1-nExOoaeiOJYq&q=85&s=a5862e0e462ab210eb18f1cad269d7b1" alt="Iniciando um novo chat" width="1500" height="1000" data-path="images/guides_first-project_01.png" />
  </Step>

  <Step title="Descreva o que você quer criar">
    Conte ao Macaly o que você tem em mente, do mesmo jeito que explicaria a um amigo. Qualquer idioma funciona.

    Se você já tem materiais prontos (um logotipo, diretrizes da marca, um PDF com conteúdo), anexe tudo de uma vez. Quanto mais contexto o Macaly tiver desde o início, melhor será o primeiro resultado.
  </Step>

  <Step title="Aguarde o agente terminar">
    O Macaly começa a construir imediatamente. Ele pode fazer uma ou duas perguntas pelo caminho, se algo precisar ser esclarecido.

    A primeira versão pode levar alguns minutos. Você verá atualizações no chat enquanto o agente trabalha.

    <img src="https://mintcdn.com/macaly-41b1d3e9/3b1-nExOoaeiOJYq/images/guides_first-project_02.png?fit=max&auto=format&n=3b1-nExOoaeiOJYq&q=85&s=27c4c4e309eee0cd13430043d516eaec" alt="Plano do agente" width="1500" height="1000" data-path="images/guides_first-project_02.png" />
  </Step>

  <Step title="Revise o resultado">
    Confira a prévia à direita. Observe o layout, os textos, as imagens e a impressão geral. Use o seletor de dispositivo acima da prévia para ver na hora como seu site aparece no celular, no tablet e no computador.

    Não vai ficar perfeito de primeira, e isso é totalmente normal. Continue ajustando com novas mensagens no chat ou use a <Tooltip headline="Edições visuais" tip="Use a barra de ferramentas sobre a prévia para editar um elemento diretamente, reescrever o texto no próprio lugar ou marcar o que você quer dizer." cta="Saiba mais sobre Edições visuais" href="/docs/pt-BR/features/visual-edits">barra de ferramentas sobre a prévia</Tooltip> para fazer alterações precisas direto na página.

    <img src="https://mintcdn.com/macaly-41b1d3e9/3b1-nExOoaeiOJYq/images/guides_first-project_03.png?fit=max&auto=format&n=3b1-nExOoaeiOJYq&q=85&s=4b655dc218595353d9741bba7e8ec71e" alt="Revisando o resultado" width="1500" height="1000" data-path="images/guides_first-project_03.png" />
  </Step>
</Steps>

## Como conversar com o Macaly

Converse com o Macaly como com um amigo. Sem comandos, sem termos técnicos. Basta dizer o que você quer.

Comece com algo concreto:

```
Quero criar um site para a minha cafeteria, a Dusk. É um lugar
pequeno e aconchegante em Praga. Café excelente, doces caseiros,
jazz ao vivo nos fins de semana. Cores quentes, muitas fotos
de comida.
```

Depois, continue a conversa. Cada mensagem se baseia no que já foi construído:

```
Encontrei um site cujo estilo eu adorei: https://example.com
Podemos fazer algo parecido para a página inicial?
```

```
Troque as avaliações do Google Maps por uma galeria de fotos.
```

```
Você pode adicionar uma seção de cardápio? Tenho o cardápio
completo em PDF e vou enviar. Dá para extrair os itens e os preços?
```

O Macaly mantém todo o contexto do seu projeto durante a conversa, então ele nunca perde de vista o que você já construiu.

### Algumas dicas

* **Bons resultados começam com contexto.** Compartilhe um site de referência, envie seu logotipo ou explique para quem é o site. Quanto mais o Macaly souber, melhor será o resultado.

* **Descreva o resultado, não os passos.** Foque em como você quer que fique e em que sensação deve passar. O Macaly descobre como fazer.

* **Envie um pedido de cada vez.** Mensagens focadas dão resultados melhores do que listas longas. Se você tem várias alterações em mente, envie uma por uma e o Macaly cuida delas em ordem.

* **Pergunte antes de construir.** Não sabe se algo é possível? É só perguntar. O Macaly pode apresentar as opções antes de qualquer trabalho começar.

* **Diga o que está estranho, não apenas que está errado.** "A fonte parece formal demais" dá ao Macaly algo concreto para trabalhar. "Tente de novo" não dá.

## Quando algo dá errado

Algo não ficou como você esperava? Isso é totalmente normal, principalmente no começo. Veja o que fazer:

* **Peça ao agente para desfazer.** Descreva o que mudou e diga que quer reverter. Funciona melhor quando só uma coisa deu errado.
* **Restaure uma versão anterior.** Se várias coisas deram errado de uma vez, restaurar é mais rápido do que desfazer passo a passo. Abra o **Histórico de versões** pelo ícone de relógio na barra superior, veja a prévia da versão que você quer e clique em **Restaurar**. Veja [Histórico de versões](/docs/pt-BR/chat/overview#histórico-de-versões).
* **Edite um prompt anterior.** Volte a qualquer mensagem anterior e edite. O Macaly volta o projeto àquele momento e o reconstrói a partir do seu prompt atualizado.
* **Comece a partir de uma cópia segura.** Antes de fazer grandes mudanças, clique em "Duplicar" abaixo de qualquer mensagem. Assim você sempre tem um ponto de retorno.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.