Leve felicidade para o mundo, visite orfanatos e mude o dia de muitas crianças. NLW#3

• Sobre • Layout • Como executar • Tecnologias • Como contribuir • Licença •

---

💡 Sobre

A aplicação permite que Orfanatos se cadastrem para que qualquer pessoa possa visita-los e espalhar amor para as crianças! ❤️

Este projeto foi construído durante a terceira edição do evento Next Level Week da Rocketseat.

---

🎨 Layout

Web 💻

Mobile 📱

---

💻 Executando o Happy

Pré-requisitos

É necessário ter instalado na sua máquina para execução desse projeto:

• NodeJS
• Gerenciador de pacotes (Npm ou Yarn)

👾 Clonando o Repositório

$ git clone https://github.com/karlos-silva/nlw-happy.git

# entre na pasta do projeto

$ cd nlw-happy

💻 Rodando o Happy web

Entre na pasta

$ cd web

Instale as dependências

$ yarn

# ou, caso use npm

$ npm install

Rode a aplicação

$ yarn start

# ou, caso use npm

$ npm start

Caso você tenha uma conta no mapbox, pode usar seu token para utilizar o mapa da aplicação. No entanto, se você não quiser ter este trabalho, sem problemas, por padrão já tem um mapa configurado para uso.

Caso queira, vá para a seção do Mapbox.

🌐 Rodando o Servidor

Entre na pasta

$ cd backend

Instale as dependências

$ yarn

# ou, caso use npm

$ npm install

Rode o servidor

$ yarn dev

# ou, caso use npm

$ npm dev

📱 Rodando o Happy mobile

Entre na pasta

$ cd mobile

Instale as dependências

$ yarn

# ou, caso use npm

$ npm install

Rode o mobile

$ yarn start

# ou, caso use npm

$ npm start

Depois de fazer isso, irá abrir o metro bundler no seu navegador. A partir de agora você tem algumas opções para acessar o app.

1 - Emulador Android

Na página do metro bundler, clique em "Run on Android device/emulator" e espere carregar. Tenha em mente que é necessário ter passado pelo processo de instalação do android sdk, etc.

2 - Emulador IOS

Na página do metro bundler, clique em "Run on iOS simulator" e espere carregar.

3 - Seu smartphone

Baixe o aplicativo do Expo:

• iOS
• Android

Depois de baixar, volte a página do metro bundler e escaneie o QR Code com o app do Expo.

Se tudo deu certo, o app deve estar disponível agora! 👩🏽‍🔧

---

🗺 Mapbox

Siga as instruções para usar o mapbox no lugar do openstreetmap.

• Em "https://account.mapbox.com/", copie seu token.
• Na raiz do projeto web crie um arquivo chamado ".env"
• Dentro desse arquivo, digite "REACT_APP_MAPBOX_TOKEN =" e cole seu token logo depois.
• Entre no arquivo "OrphanagesMap.tsx", faça como no print

Se você fez tudo corretamente, estás usando a API do mapbox com seu Token na página do mapa. 😄

---

🛠️ Tecnologias

As ferramentas usadas no desenvolvimento do projeto.

Backend:

• Typescript
• NodeJS
• Express
• Express Async Errors
• TypeORM
• SQLite
• Multer
• Yup
• Cors

Web:

• Typescript
• ReactJS ⚛️
• React Router Dom
• React Icons
• Leaflet 🍃
• API do Mapbox 🗺️
• Axios

Mobile:

• Typescript
• React Native
• React Native Maps
• React Navigation
• React Navigation Stack
• Expo

---

⚙️ Como contribuir

• Faça um fork desse repositório;
• Crie uma branch com a sua feature: git checkout -b minha-feature;
• Faça commit das suas alterações: git commit -m 'feat: Minha nova feature';
• Faça push para a sua branch: git push origin minha-feature.

---

📝 Licença

Este projeto está sob licença MIT.

Feito com 💞 por Karlos Silva 🚀