Mural de recados

Neste projeto, você vai construir um mural de recados na web: um app onde qualquer pessoa pode deixar um recado, que aparece como um post-it colado na parede. Dá para postar, ver, corrigir e apagar recados.

Mural de recados com o título em destaque, o botão verde Novo recado e, embaixo, quatro cartões amarelos lado a lado, cada um com a mensagem, a autora em itálico e os botões Editar e Apagar

Você não precisa saber programar para começar. O guia explica cada passo, e no fim do dia você vai ter construído um app de verdade, com Ruby on Rails.

Como o projeto funciona

O mural de recados cresce aos poucos, um capítulo de cada vez. Cada capítulo começa por um problema, como “como postar um recado?”, e segue sempre o mesmo caminho:

  1. O desafio: o problema que o capítulo resolve.
  2. Pense antes de programar: alguns minutos com papel e caneta, para você planejar antes de escrever código. Não existe resposta errada.
  3. Compare com o nosso plano: o que a gente planejou, para você comparar com o seu.
  4. Mão na massa: os passos, um de cada vez. Em cada passo, você dá um palpite antes de rodar e confere o resultado depois.
  5. O que aconteceu?: a explicação do que você fez, perguntas e respostas, um quiz e, se quiser, um jeito de quebrar o app de propósito para aprender a ler os erros.

Travou em algum passo? Todo Mão na massa tem, no fim, uma parte Travou? com os problemas mais comuns. E a equipe de mentoria está aí para ajudar. 💜

O que você vai construir

Ao fim de cada capítulo, o mural de recados já funciona, só que mais simples. É como ir de skate, depois de patinete, depois de bicicleta: em todas as etapas você já chega a algum lugar. Veja a ideia em Como os projetos crescem.

Capítulo No fim dele, o mural de recados…
00. Planejando o app …ainda não existe, mas você já sabe o que ele vai ter.
01. Por onde começar? …é um app Rails novo, rodando no seu codespace.
02. Como guardar os recados? …guarda recados no banco de dados.
03. Como ver todos os recados? …mostra os recados no navegador.
04. Como postar um recado? …recebe recados novos por um formulário, numa página própria.
05. Errei! Como corrigir ou apagar? …deixa corrigir e apagar recados.
06. Como deixar o mural de recados mais bonito? …mostra os recados como post-its, lado a lado.
07. E se alguém mandar um recado vazio? Opcional …recusa recados vazios e avisa o que falta.
08. Como mostrar o mural de recados para o mundo? Opcional …está no ar, num endereço que qualquer pessoa pode abrir.
09. Terminei! E agora? …está guardado, e você sabe como voltar a ele e o que fazer depois.

Terminou tudo e quer mais? Veja os Desafios extras.

Cada pessoa no seu ritmo

Não precisa terminar tudo hoje. Cada pessoa vai num ritmo diferente, e está tudo bem: quem para no meio do caminho já sai com um mural de recados que funciona. O guia fica no ar depois do workshop, e você pode continuar em casa, de onde parou.

Antes de começar

  • Uma conta no GitHub. Se ainda não tem, veja Criando uma conta no GitHub.
  • Um navegador, como o Chrome, o Firefox ou o Edge. O projeto roda no GitHub Codespaces, um computador na nuvem que já vem com tudo instalado. Quer usar o seu próprio computador? Fica nos Extras, para depois do workshop: veja Instalando no seu computador.
  • Papel e caneta, para o “Pense antes de programar”.

Os termos novos têm um link para o glossário, com a explicação de cada um. Não precisa decorar nada.

Comece aqui

Pegue o papel e a caneta e comece por 00. Planejando o app. 🚀


Table of contents


Material de Rails Girls São Paulo, licenciado sob CC BY-NC-SA 4.0. Uso livre e gratuito com atribuição; uso comercial proibido.

This site uses Just the Docs, a documentation theme for Jekyll.