Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/expresshermes/helping-hand
Django web app for charity event organisers to connect and collaborate.
https://github.com/expresshermes/helping-hand
css django hacktoberfest html javascript mapbox
Last synced: 19 days ago
JSON representation
Django web app for charity event organisers to connect and collaborate.
- Host: GitHub
- URL: https://github.com/expresshermes/helping-hand
- Owner: ExpressHermes
- Created: 2020-05-11T10:10:21.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-02-08T02:26:25.000Z (almost 2 years ago)
- Last Synced: 2024-10-12T06:52:46.411Z (about 1 month ago)
- Topics: css, django, hacktoberfest, html, javascript, mapbox
- Language: HTML
- Homepage:
- Size: 607 KB
- Stars: 8
- Watchers: 2
- Forks: 9
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Helping Hand
[](https://join.slack.com/t/slack-coh8135/shared_invite/zt-zrefahmo-NcRHial9jkoZrzZEcFMMTA)
A social platform built for the organizers charity events to connect with each other to organize bigger events and thus help more people.
## Frontend
The frontend is fast and interactive. It is built with HTML, CSS, Bootstrap 4 and Vanilla JavaScript.
## Backend
The backend is built with Django framework. It uses SQL based database.
## Demo Screenshots
## Installation
Make sure following softwares are installed in your computer:
* Python 3
* Git
- First you need to clone the repository
```
git clone https://github.com/ExpressHermes/Helping-Hand.git
```
- Install all required dependencies in a virtual environment
```
cd
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
```
- Run the backend on local server
```
cd
source venv/bin/activate
cd Helping-Hand
python manage.py runserver
```
- To create superuser, run following command inside Helping-Hand folder
```
python manage.py createsuperuser
```
- For a "OperationalError", run the following command
```
python manage.py makemigrations mainapp
python manage.py migrate
```
## Setting the environment variables
If you are facing the problem in login through Google, follow these steps:
- Create a .env file in the project directory of Helping Hands.
- Follow the variable names from .env.sample file but values of that variables are dummy so make sure to update.
- Now for getting the client id and secret key, Go to https://console.cloud.google.com/ .
- Create new project and give it a name then go to your project and configure your OAuth Consent Screen.
- After that Go to API & Services and then credentials, create the OAuth Key.
- Copy paste the Client id and secret key in the .env file.
## Contribution
- Fork and clone the repo.
- To avoid merge conflicts, make sure to set upstream in your git.
```
git remote add upstream https://github.com/ExpressHermes/Helping-Hand.git
```
- Whenever you want to pull changes from main repo, run:
```
git pull upstream master
```
- Create your feature branch
```
git checkout -b
```
- Commit your changes
```
git commit -am "Meaningful commit message"
```
- Push to the branch
```
git push origin
```
- If you see any bug or you have a feature suggestion, create an issue.
- Start working on an issue only after it has been approved by the maintainer.
- Wait till the end of the day to get the reply on an issue or review of a PR.