Git Product home page Git Product logo

handsforhunger's Introduction

HandsForHunger

What problem HandsForHunger solves?

Our app ensures a 'Two Way Connection' between NGO's and the donors. The NGOs can find food donors available in their vicinity whenever they have a huge mass to cater, while the donors can easily look up for NGOs ready to accept the food which might otherwise go waste.

Tech Stack

  • Flutter
  • Firebase

Requirements

  • Android Studio Dolphin | 2021.3.1
  • SDK Version: '>=2.18.0 <3.10.0'

How To Setup

  • Make sure your machine is having an internet connection.
  • Fork the repo.
  • Clone it to your local setup by using the command git clone <repo link>
  • Open the project with Android Studio.

Directly cloning from Android Studio (Alternate method):-

  • Go to FILE -> NEW -> PROJECT FROM VERSION CONTROL
  • Copy and paste the url of FORKED repo in the URL field and click clone.

Reference Links

Claim an issue

Comment on the issue. In case of no activity on the issue even after 2 days, the issue will be reassigned. If you have difficulty approaching the issue, feel free to ask on our discord channel.

Communication

Whether you are working on a new feature or facing a doubt please feel free to ask us on our discord channel. We will be happy to help you out.

Guidlines

Please help us follow the best practice to make it easy for the reviewer as well as the contributor. We want to focus on the code quality more than on managing pull request ethics.

  • People before code: If any of the following rules are violated, the pull-requests must not be rejected. This is to create an easy and joyful onboarding process for new programmers and first-time contributors.

  • Single commit per pull request and name the commit as something meaningful, example: Adding <-your-name-> in students/mentors section.

  • Reference the issue numbers in the commit message if it resolves an open issue. Follow the pattern Fixes #

  • Provide the link to live gh-pages from your forked repository or relevant screenshot for easier review.

  • Pull Request older than 3 days with no response from the contributor shall be marked closed.

  • Do not make PR which is not related to any issues. You can create an issue and solve it once we approve them.

  • Avoid duplicate PRs, if need be comment on the older PR with the PR number of the follow-up (new PR) and close the obsolete PR yourself.

  • Be polite to other community members.

handsforhunger's People

Contributors

aasthaaaa7 avatar abhinavs1920 avatar ananyaa07 avatar bhumika-kalaru avatar gammaj avatar karnawataman avatar poga0204 avatar pragya1976 avatar prakriti-19 avatar sona-123 avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar  avatar

handsforhunger's Issues

Design a logo for the app

Design a logo which best fits the theme and concept of this app.

Guidelines

  • Make sure you follow the given template in the .github folder before making the pull request.

  • For submitting PR, you have to make a .txt file containing your github username and figma link and add it into the designs/logo folder.

  • The deadline for the submission of this issue is 18th December,11.59 P.M

Note

  • The final decision will be taken by mentors.
  • As it is an open to all issue, therefore, no need to claim.

Create register page

Code the register page by imitating the UI given in design folder (login_sign_up_ui) as close as possible

Note:

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make the screens responsive by using MediaQuerry
  • No need to add any functionality just mimic the UI

Create Login Page

Code the Login Page by imitating the UI given in design folder (login_sign_up_ui) as close as possible

Note:

  • Deadline for the task is 21st Dec, 11:59 pm
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make the screens responsive by using MediaQuerry
  • No need to add any functionality just mimic the UI

Design SignIn/SignUp page

Things to consider before making the design :

  • The page must have input fields for email and password and sign in through google option.

  • Designs need to be minimal and intuitive.

Submission Guidelines :
For submitting PR, you have to make a .txt file containing your github username and figma link and add it into the designs/logo folder.

  • The deadline for the submission of this issue is 19th December,10.00 A.M

  • The top 3 designs will be rewarded with points.

  • Make sure the visibility of the Figma File is public.

  • The final decision will be taken by mentors.

  • Note that the issue is Open for All. There is no need to claim this issue. You can directly submit a PR

Let's Filter Out

Create a simple button on home page such that on clicking it we filter out and display only those food items that can serve more than 50 people

Note

  • In case you need access to backend share your email
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make a new dart file for each task and name it accordingly

Lets Wrap Up!

Lets finalize the project by adding functionalities to filter, search, profile and logout option of the drawer

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make a new dart file for each task and name it accordingly

Validate the email

Only valid email should be able to register in the app. Verify the email through which user is registering in the app either through OTP or online mail verification.

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • In case you need access to backend share your email

Add Authentication via email password

With firebase already integrated in the project allow your users to register in your app by adding authentication using email and password in firebase

Note

  • In case you need access to backend share your email
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make a new dart file for each task and name it accordingly
  • User should be registered by clicking on Register button of the SignUp page

Code a Splash screen

Create a Splash Screen with a delay of 3 seconds which will just have the logo given in the figma file of the design folder

Design UI for Donation page

Through the Donation page we take the details of the food such as quantity(person), image, veg-non-veg, used by date, location, contact no.

Note

  • The deadline for the task is 26th December 11.59 P.M
  • No need to claim it, it's open for all
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Try to keep it minimalistic and innovative

Change the UI

Change the UI of homepage by cloning the one given in design folder(food inventory.txt)

Add Menu

Add a drop down menu on people filter button for ranges(<10, 11-20,20-50,50-100,>100) and add functionality to each button and filter the data depending on veg and non-veg:

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make a new dart file for each task and name it accordingly

Design a welcome screen

Design a welcome screen for the app which asks users whether they are food donors or NGO before navigating them to the signup page

Things to consider before making a design :

  • The page will have a welcome message and ask donors to choose if they are food donors or NGO.

  • Designs need to be minimal and intuitive.

Submission Guidelines :

  • For submitting PR, you have to make a .txt file containing your github username and figma link and add it into the designs/logo folder.

  • The deadline for the submission of this issue is 18th December,11.59 P.M

  • Make sure the visibility of the Figma File is public.

Note that the issue is Open for All. There is no need to claim this issue. You can directly submit a PR

Display the data

Create a new Screen named Homescreen and display in a list view all the details of the food stored in the backend

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • In case you need access to backend share your email

It's Time To Animate

Use your imagination and come up with a good animation for our Splash Screen

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • You can use any animation but try to keep it minimalistic

Store the data

Store all the details of the food as a document in firebase with user id of that donor also as a field as shown in the ss:
2022-12-30

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • In case you need access to backend share your email

Need a Drawer

Create a drawer on homescreen displaying- profile, search, filter and logout option. You can take reference from the image below:
2023-01-07

Note

  • No need to add any functionality
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make a new dart file for each task and name it accordingly

Take input the dates

Add Functionality to the calendar feature in donor page to take date as the input. Also make all the 3 checkboxes in this page functional

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders

Design UI for HomeScreen

The homescreen displays all the food available at that very instant in our inventory along with an area for ads

Note

  • Color scheme should be similar to previous screens
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Try to keep it minimalistic and innovative

Add a Check On The TextFields

Add a condition such that the user can't proceed from register or login page without filling in all the details. If so an error message in red is displayed on the screen

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders

Adding Navigation

  1. Convert text at the bottom of login and register pages ("Already have an account Sign in", "Don't have an account Sign Up") to textbutton and add navigation through it between the pages.
  2. Also add an imagebutton of google above "Sign up with google" text

Note

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders

Create Donation Page

Code the donation page by imitating the UI given in design folder (UI for donation page folder) as close as possible

Note:

  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make the screens responsive by using MediaQuerry
  • No need to add any functionality just mimic the UI

Login via email password

Once the user has registered, they should be able to login every time in your app by using email and password

Note

  • In case you need access to backend share your email
  • You are not allowed to make changes in any of the files except for pubsec.yaml and lib folders
  • Make a new dart file for each task and name it accordingly
  • User should be logged in by clicking on Login button of the SignIn page

Create a welcome page

Code a welcome page by imitating the UI given in design folder (welcome screen->screen 2) as close as possible

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.