<b>BE HERO!</b>
<b>BE HERO!</b>
Technologies | Project | Layout | Getting started | How to contribute | License
🚀
Technologies
This project was developed with the following technologies:
Extras:
- Main Libs
- Style
💻
Project
Be The Hero is a project that aims to connect people interested in helping NGOs with open campaigns.
🔖
Layout
You can view the project layout at this link. Remembering that you will need to have a Figma account.
💺
Getting started
These instructions will get you a copy of the full project up and running on your local machine for development and testing purposes.
Setting up the development environment
You will need to install Git, Docker Desktop and Docker Compose before following the instructions below.
Installation using Docker Compose
The following steps need to be performed inside a terminal window (Windows user may prefer to use the Windows Terminal but the Command Prompt will also work).
Clone the repository and build Docker images:
git clone https://github.com/diegomais/be-the-hero.git
cd be-the-hero
docker-compose build
Running the services
Use the following command to run all Be The Hero containers (from within the be-the-hero directory):
docker-compose up
You can now use the API at http://localhost:3333 and view the Web App in the browser at http://localhost:3000.
Prerequisites
The project can be built with npm or Yarn, so choose one of the approach bellow in case you don't have any installed on your system.
- npm is distributed with Node.js which means that when you download Node.js, you automatically get npm installed on your computer. Download Node.js.
- Yarn is a package manager built by Facebook Team and seems to be faster than npm in general. Download Yarn.
Setting up the development environment
Follow the instructions for Expo CLI available in the official Expo Documentation.
Adding environment variables
- Rename the file
environment.example.js
onmobile
directory toenvironment.js
. - Add the API URL (e.g.
http://localhost:3333
) intoenvironment.js
file.
Installing dependencies and running the mobile application
Run the instructions bellow inside mobile
directory:
npm install
expo start
or
yarn install
expo start
🤔
How to contribute
- Fork this repository;
- Create a branch with your feature:
git checkout -b my-feature
; - Commit your changes:
git commit -m '[feat](scope) My new feature'
; - Push to your branch:
git push origin my-feature
.
After the merge of your pull request is done, you can delete your branch.
📝
License
This project is under the MIT license. See the LICENSE for more details.