Dots: The alternative legal aid tech connecting individuals to the right organisations

---

🧐 About

Kona Connect’s legal team, together with students and expert volunteers from around the world, are developing a tool to connect people in need to the organisations best equipped to help them. This has been a 6 week volunteer project in collaboration with Kona-Connect and Women++. The team's goal is to develop an application that will connect Sengalese people to various NGO's and organizations that can provide assistance for specific needs.

🔺 Dependencies

The fastest way to get up and running is to use the Expo Go app on your iOS or Android device. Expo Go allows you to open up apps that are being served through Expo CLI.

npm install --global expo-cli

Download Expo Go on your mobile device

🤖 Android Play Store - Android Lollipop (5) and greater.

🍎 iOS App Store - iOS 11 and greater

☎️ Using the Dots App

In command line, in the project root run

expo start

This will produce a QR code in terminal which can be scanned by the Expo app on your mobile phone. Scan this app to start the application on your mobile device.

🔩 Application Design

• React-Native
• Expo
• JSON for data storage

In order to keep the app light-weight, we decided to use a JSON to store the data infrastruture.

Directory Structure

kona-app
│   README.md
│   .gitignore
|   .App.js
|   .app.json
└───.expo-shared 
|
└───assets     
│    └─── fonts
|    └─── SDG-Icons
│    └─── logos 
|
└───components
|   │   globals
|   │   quetion
|   |   startQuestionaire       
└───routes
|    │   CoverStack.js
|      
└───screens
|   │   Accordian.js
|   │   Cover.js
|   │   DropdownQuestion.js
│   │   Filter.js
|   |   FilteredBySGD.js
|   |   FilteredOrgs.js
|   |   Home.js
|   |   QuestionWithButtons.js
|   |   Solo.js
|   |   StartQuestionnaire.js
│   
└─── data
|   │   LogoMaping.js
|   |   kona_orgs.json
|   │   raw_data.csv
|   |   raw_data.xlsx
│   |    └─── data_analysis
|   |   └─── data_transformation
│   |    └─── scripts
|   |         |    AddLogos.py
|   |         |    GenerateLogoMappings.py
|
└─── docs
|    │   technical_specification.md
|    │   Project_Summary_KONA_A.pdf
|    │   Project_Presentation_KONA_A.pdf
|    |
└───src 
│    │   
│    └───test     

💾 Project Folder Description

This Project includes directories:

assets:

• This directory contains all of the images and fonts.

components:

• This folder contains the components used for the app, including global components, used on different screens (different types of buttons, Footer, Logo, Search bar, global stylesheet, etc.); more specific local components, including Filter section, SearchedFor section and local styling; and organizations folder with components displaying NGOs.

routes:

• CoverStack.js This is how navigation between the screens works in our app

screens:

• Home.js First screen with Searchbar, fast help buttons, quick glance to organizations and SDGs section
• Filter.js Section that allows the user to see the quick filters and narrow down the filters by clicking See all filters
• FilteredOrgs.js - Shows the organizations filtered by the applied categories
• FilteredBySDG.js - Shows the organizations filtered by Sustainable Development Goals
• SearchPage.js - Provides searching option
• Solo.js - Detailed description of the organization
• Accordion.js - Expanded filters that give possibilities to narrow down the results
• UltimatelyFiltered.js - Last screen that shows the organizations with all the filters applied

data:

• raw_org_data.csv Data that was provided by Kona.
• raw_org_data.xlsx Original Spreadsheet provided by Kona.
• kona_orgs.json Data that has been transformed, filtered, and grouped
• LogoMapping.js Data + company logos that is used to render the app
• Scripts that append images to the JSON file, and create the new LogoMapping.js file that will be rendered to the application
• data_transformation dir Jupyter Notebooks that show the process of how data was cleansed, filtered, and catagorized
• data_analysis dirs -Jupyter Notebook with analysis on the frequency of times a catagory, SDG, and target group appears within the organization data

docs:

• technical_specifications.md Contains information about the tech stack, decision making process, features, data structure, and future work. A link to Figma, where we created our UI/UX is included here
• Project_Summary_KONA_A.pdf Project summry that includes how we worked together to form a collaborative and effective team, the lessons we learned, and other project details
• Project_Presentation_KONA_A.pdf Final Presenatiation for this product

🙏 Acknowledgments

Inspiration, code snippets, etc.

• awesome-readme
• discord-hackathon
• Spam-Detector
• Markdown-Badges

👏 Authors

Tiffany Carruthers

Yulia Mikhaylova

Alexandra Bödtker

Kat Kavaliova

License

License