Code Monkey home page Code Monkey logo

reliefsupport-android's Introduction

ReliefSupports Platform

This is a community-driven Open Source project to support relief support activities conducted by volunteers. This project was originally created to support flood relief activities in Sri Lanka in May 2017. We are revamping the entire platform at the moment to mainly focus on supporting the economic and humanitarian crisis we are about to face in Sri Lanka.

We welcome your innovative ideas, codeing and non-coding contributions and suggestions to build a better platform.

How to Contribute

Setting up the development environment

Prerequisites

  • Install Node.js and MongoDB on your workstation.
  • We use Yarn as we use yarn-workspaces

Clone the main repository

git clone [email protected]:reliefsupports/reliefsupports.git
cd reliefsupports
yarn // will install all the dependencies for all the apps at once

Set /web/.env file.

Copy .env.example to .env and update necessary values (Firebase)

Run the application

yarn start // will start server and web at once

Frontend on ::3000 and Backend ::3001/api

Guidelines

  • Primary branch is master, and strongly recommend to avoid pushing changes to master branch directly.
  • Follow proper naming conventions always
  • Alyways put active WIP PRs in draft stage
Branch names
  • Use feat/<awasome-feature>-[issue-id] naming conventions for feature branches
  • Use fix/<good-fix>-[issue-id] for bug fixes
  • Use chore/<task>-[issue-id] for regular tasks
PR naming
  • Use feat: <My Awesome Feature> naming conventions for feature titles
  • Use fix: <That fix> for fixes
  • Use chore: <Regular Task> for regular tasks
Commit messages
Issues

Apply labels appropriately for each issues when created:

  • epic
  • story
  • bug
  • feature
  • feature-request
  • enhancement
  • documentation
  • question
  • help wanted

Components:

  • comp:frontend
  • comp:server

Labels for maintainers:

  • wontfix
  • invalid
  • good first issue
  • duplicate
  • freez

Priorities:

  • priority:high
  • priority:medium
  • priority:low

API Docs

Check postman collection

License

MIT

reliefsupport-android's People

Contributors

danishka avatar naveenmadhawa avatar thinkholic avatar thpubs avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

reliefsupport-android's Issues

Update repo with project structure

atm we only have basic boilerplate code in the repo. I think it will better to have a proper project structure in the repo . otherwise in the initial PR's we will experience confusions regarding this structure.

Web API (Need help)

  • User registration
  • User login
  • User logout
  • Fetch data
  • Post donations
  • Post needs
  • Notifications
    • Ask whether the needs are fulfilled
    • Warn of new threats

Need someone with PHP and Laravel knowledge to build the API part.

SOS! requests

In the Mobile app we will add single click/tab to send a message when someone need rescue people.
App should send his/her geolocation, mobile number and relevant details.

CMS should handle these requests separately validation (we should not let someone to misuse).
and these requests should send to rescue teams.

We may enable these requests to outside with credentials (media should not get these contacts and publish in mainstream and disrespect ethics)

Here is the related cms ticket https://github.com/reliefsupports/reliefsupports.org/issues/117

User registration

  • Shall we make this optional so people can quickly use the app if they are in a hurry?
  • Google authentication: Since most of the Android users have a Google account attached to their phone, this can make login really fast.

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.