Be The Hero

A full-stack app that connects NGOs with people willing to help, built during Rocketseat's Semana OmniStack 11.0.

What it does

NGOs register the cases they need help with. Each case has a title, a description, and the amount of money needed. People who want to help (the heroes) browse the cases and contact the NGO by email or WhatsApp to support one.

The project has three parts:

• A REST API for NGOs, cases, and sessions.
• A web app where NGOs log in, register cases, and manage them.
• A mobile app where heroes see the cases and reach out to help.

Download

The mobile app is published on Google Play.

• Get it on Google Play

Stack

• Backend: Node.js, Express, Knex, SQLite
• Frontend: React
• Mobile: React Native, Expo
• HTTP client: Axios

Project structure

be-the-hero/
├── backend/    Node.js REST API (Express, Knex, SQLite)
├── frontend/   Web app (React)
└── mobile/     Mobile app (React Native, Expo)

Run locally

You need Node.js and Yarn installed. Run each part in its own terminal.

Backend

cd backend
yarn install
yarn knex migrate:latest
yarn start

The API runs on http://localhost:3333.

Frontend

cd frontend
yarn install
yarn start

The web app runs on http://localhost:3000.

Mobile

cd mobile
yarn install
yarn start

This opens Expo. Scan the QR code with the Expo app on your phone, or run it on an emulator.

License

This project is under the MIT license. See LICENSE for details.

---

Made by Thiago Marinho. Get in touch.