Need4Deed's frontpage

Need4Deed is a need based voluntary support for refugees in Berlin

About the project

The number of people fleeing conflict zones, persecution and human rights violations worldwide has never been as high as it is today. Need4Deed is set to promote the inclusion and integration of refugees in Berlin through the actions of civil society by making volunteering more accessible. We aim to build a sustainable and scalable mechanism for this purpose by connecting volunteers with refugees that are living in accommodation centers in Berlin based on their specific needs.

Our values

Equal opportunities

People living under destitute life conditions should be given equal opportunities. The latter includes underserved individuals and groups affected by forced migration.

Responsibility

Both countries (the state) and civil society, have responsibility towards its underserved communities including those affected by forced migration.

Migrant-to-migrant support

In particular, groups and individuals who have undergone forced migration could be best understood and supported by others with migration background in the course of their integration process, so that they receive equal opportunities and eventually benefit society themselves.

Active participation

A migrant-to-migrant support alongside non-migrant support, can both play a key social role by facilitating a more rapid integration process and active participation of the supported communities.

Technology

Applying technology in the effort to support underserved communities is a key value to make support giving and receiving more inclusive, accessible and scalable.

Contributing 🤝

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

Step 1: Fork the Repository

1. Go to the our repository: https://gitlab.com/need4deed/website.
2. Click the Fork button in the top-right corner.
3. Choose where to fork the repository (usually your own GitLab account).

See CONTRIBUTE.md for the next steps and detailed contribution guidelines.

Tech Stack 🛠️

• React.js

Getting Started 🏁

Prerequisites

• Node.js (v20 or higher)
• yarn

Installation

Please note, that's the instruction for members of the project, if you are not one please check CONTRIBUTING.md.

1. Clone the repository

git clone [email protected]:need4deed/website.git

2. Install dependencies

cd website
yarn install

3. Create environment file

cp .env.example .env

4. start the development server

yarn dev

5. Optional dependencies to install

• aws

Unit tests 🧪

yarn test

Building 🚀

yarn build

Adding images

aws s3 sync $YOUR_PATH/website/pictures s3://need4deed-images/images

License 📝

This project is licensed under the Common Clause and the MIT License - see the LICENSE file for details.

Support 💬

• Create an Issue
• Join our Slack - ask as for an inivatation
• Email: [email protected]