Human Essentials

Inventory control for Diaper Banks and other Essentials Banks

Mission 💖

Human Essentials is an inventory management system built to address the needs of Diaper Banks as directly and explicitly as possible and adapted to meet the needs of other Essentials Banks. Essentials Banks maintain inventory, receive donations and other human essentials supplies (e.g. diapers, period supplies), and issue distributions to community partner organizations. Like any non-profit, they also need to perform reports on this data and have day-to-day operational information they need. This application aims to serve those needs and facilitate the general operations of the Diaper Banks (e.g., using barcode readers, scale weighing, inventory audits).

Human Essentials is a free hosted service! There is no cost to Essentials banks, and all of the source code (MIT Licensed) is shared and built by volunteers as part of Ruby for Good. You can find out more about Ruby for Good at rubyforgood.org.

Impact 🌟

Human Essentials has over 200 registered banks across the United States at no cost to them. It is currently helping over 3 million children receive diapers and over 400k period supply recipients receive period supplies. Our team is in partnership with the National Diaper Bank Network (NDBN) and can be found in their annual conference that brings numerous non-profit organizations that distribute essential products to people.

We are proud of our achievements to date but there is much more to do! This is where you come in...

Digital Public Good 🎉

The Digital Public Goods Alliance recognizes Human Essentials as a digital public good (DPG). This project supports the following Sustainable Development Goals:

• SDG 1 - End poverty in all its forms everywhere
• SDG 3 - Ensure healthy lives and promote well-being for all at all ages
• SDG 10 - Reduce inequality within and among countries

Use as an Organization or Contribute as an Individual/Team to this Project:

• NGO Adoption Info - information about how to use this DPG
• Skills Based Volunteering Info - information about how to volunteer

Welcome Contributors! 👋

Thanks for checking us out! Here is a quick-start, and also check out our Contributing Guidelines for details on how to contribute.

Local development

1. Install Ruby
   • Install the version specified in .ruby-version.
   • Visit the Install Ruby on Rails guide by GoRails for Ubuntu, Windows, and macOS setup. Follow only the Installing Ruby step, as our project setup differs. It is highly recommended you use a Ruby version manager such as rbenv, asdf, or rvm.
   • Verify that your Ruby installation works by running ruby -v.
2. Install Postgres
   • Follow one of these guides: macOS, Ubuntu.
   • Create a database.yml file in the config/ directory with your database configurations. You can also copy the existing files called database.yml.example and .env.example and change the credentials.
3. Clone the project and switch to its directory
4. Run bin/setup
5. Run bin/start and visit http://localhost:3000/ to see the Human Essentials page.
6. Log in as a sample user with the default credentials.

Cloud Development

You may also use GitHub Codespaces to start an instant cloud-based dev environment. Click here:

Or clone the project and open it locally in a VS Code Dev Container:

Credentials for development and staging

The staging server is at staging.humanessentials.app. The database there is reset every night, so feel free to make changes. These are also the test users for local development, with more users in the Contributing Guidelines.

Type	Organization / Group	Role	Email	Password
Bank User	Pawnee Diaper Bank	Organization Admin	org_admin1@example.com	password!
Partner User	Pawnee Diaper Bank	Verified Partner	verified@example.com	password!
Super User		Super Admin	superadmin@example.com	password!

Acknowledgements

Thanks to Rachel (from PDX Diaperbank) for all of her insight, support, and assistance with this application, and Sarah ( http://www.sarahkasiske.com/ ) for her wonderful design and CSS work at Ruby For Good '17!

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Edwin Mak 💻 📆 🚇 🤔 💬 🛡️	Sean Marcia 💻 💼 💵 🔍 📋	Aaron H 📆 💻	Dmitry 💻	Adam Bachman 💻	JC Avena 💻	mdworken 💻 📆
Marius Pop 💻	Elayne 💻	Amy Detwiler 💻	Gia 💻	Amina Adewusi 💻	albertchae 💻 🤔	Keith Walters 💻
Chase Southard 💻	Brock Wilcox 💻	danquill 💻	Keith Bennett 💻	Benjamin Reynolds 💻	jtu0 💻	Juarez Lustosa 💻
Julien A. 💻	Emerson Manabu Araki 💻	Ben Klang 💻	karolina 💻	Josh Cano 💻	Julian Macmang 💻	Philip DeFraties 💻
GabrielRMuller 💻	Lucas Hiago 💻	Lanya Butler 💻	Eduardo Moreira 💻	Alicia Barrett 💻	Bob Forcha 💻	William Murphy 💻
Kate Donaldson 💻	Matthew Russell Dodds 💻	Allison McMillan 💻	Ashley Jean 💻	Eduardo Alencar 💻	Thomas Hart 💻	Bart Agapinan 💻
Monique 💻	Valerie Woolard 💻	zak-kay 💻	Jason LaHatte 💻	Dave Tapley 💻	Meghan 💻	Andy Thackray 💻
Felipe Lovato Flores 💻	Marcel Kooi 💻	Lee Sharma 💻	Scott Steele 💻 🤔	Sam Weerasinghe 💻	Gerald Abrencillo 💻	Rodolfo Santos 💻
Gabriel Baldão 💻	Melanie White 💻	Melissa Miller 💻	Marc Heiligers 💻	Joe Hunt 💻	Meg Gutshall 💻	Andrew H Schwartz 💻
Joseph Glass 💻	Reese Williams 💻	Santiago Perez 💻	Sirius Dely 💻	Heather Herrington 💻	Moacir Guedes 💻	CraigJZ 💻
Semih Arslanoğlu 💻	Mauricio de Lima 💻	David Curtis 💻	Natalia Galán 💻	Anderson Fernandes 💻	Gabriel Belgamo 💻	Jorge David C.T Junior 💻
Seth Lieberman 💻	Jorge Oliveira Santos 💻	Drinks 💻	Bruno Castro 💻	Carlos Palhares 💻	Clifton McIntosh 💻	Daniel Beigelman 💻
Meg Viar 💻	Svetlana Vileshina 💻	Ben Reed 💻	Emily Giurleo 💻	Alem Getu 💻	Dejan Bjeloglav 💻	Cassiano Blonski Sampaio 💻
Greg 💻	finn 💻	Jayson Mandani 💻	Stanley Liu 💻	Curtis Bartell 💻	Libby Rodriguez 💻	joshuacgraves 💬 📆
Himanshu 💻	Mohamed Hegab 💻	Alejandro AR 💻	hatsu 💻	Matt Glover 💻	js-sapphire 💻	lasitha 💻
Patrick McClernan 💻	Marc Bellingrath 💻	Daniel Orner 💻	Bob Mazanec 💻	Mark Yen 💻	Rachael Wright-Munn 💻	Ítalo Matos 💻
Alvaro Sanchez Diaz 💻	mbrundige 💻	Robert Greene 💻

This project follows the all-contributors specification. Contributions of any kind welcome!