Home Unite Us

We're working with community non-profits who have a host home initiative to develop a workflow management tool to make the process scaleable (across all providers), reduce institutional bias, and effectively capture data.

Host home programs are centered around housing young people, 18 - 25 years old. Their approach focuses on low-cost, community-driven intervention by matching a willing host with a guest or group of guests, providing a stable housing environment for youths who are experiencing homelessness and seeking stable housing.

Come visit us at https://homeunite.us/

Project context

This project is part of a larger initative at Hack for LA around creating a shared housing application, that can be used by organizations accross the county to help people tranisition to living independently and sustainably through host homes, empty bedrooms, and roomate matching for shared housing with lease signing.

Technology used

• Docker
• Nginx
• AWS
• MongoDB
• React
• Styled Components
• Material UI
• Flask

How to contribute

• Review the Getting Started guide on the Hack for LA website
• Review the documents in the home-unite-us shared drive.
• Join the #home-unite-us slack channel.
• Visit our project boards and see issues in the prioritized backlog.

Installation instructions

1. Step-by-step instructions help new contributors get a development environment up and running quickly.
2. You'll want to find the balance between being specific enough for novices to follow, without being so specific that you reinvent the wheel by providing overly-basic instructions that can be found elsewhere.
3. Feel free to adapt this section and its sub-sections to your own processes.
4. Alternatively, you can move everything from Installation instructions through Testing to a separate Contributing.md file to keep your ReadMe.md more succinct.

Working with issues

• Explain how to submit a bug.
• Explain how to submit a feature request.
• Explain how to contribute to an existing issue.

To create a new issue, please use the blank issue template (available when you click New Issue). If you want to create an issue for other projects to use, please create the issue in your own repository and send a slack message to one of your hack night hosts with the link.

Working with forks and branches

• Explain your guidelines here.

Working with pull requests and reviews

• Explain your process.

Testing

• Provide instructions.

Contact info

Please join our Slack channel and introduce yourself!

Licensing

Include details about the project's open source status.

this readme file sourced from Jessica Sand

Local development environment

Flask, Mongo and NPM

1. Ensure npm, mongodb and python3 are installed. Get the code: git clone git@github.com/hackforla/HomeUniteUs

2. Run server

3. cd host-home

4. ./seed-local-db.sh

   • check that data was seeded correctly by printing first three guest objects: mongoexport -d=hosthome -c=guests --jsonArray --pretty --limit=3
5. 1. (Optional) Configure a conda or virtualenv project
   2. pip install -r requirements.txt

4. python hosthome.py to start server running

3. Run client

   1. cd app
   2. npm install
   3. npm run dev runs webpack dev server

Docker

1. See the README in 'scripts'