rubyforgood /human-essentials
Human Essentials is an inventory management system for diaper, incontinence, and period-supply banks. It supports them in distributing to partners, tracking inventory, and reporting stats and analytics.
★ 600⑂ 603👁 46⑃ 3,965● 1,769▤ 133
600
stars
603
forks
46
watchers
3,965
prs
1,769
issues
133
releases
README
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
Top issues
#4517Include inactive items in distribution reports32 comments · 2024-07-14#4948case insensitive sorts throughout17 comments · 2025-01-26#5464Apply New Modal for Duplicate Item Entries to Distributions/Donations/Purchases etc.13 comments · 2025-12-15#5083Reconcile itemrequests and requestitems13 comments · 2025-03-09#3806[Investigation] Child. Should we be able to have both active and archived (as we have now)? It seems to me that either you are active or archived.12 comments · 2023-07-30#3805Review for unused fields --> clean up12 comments · 2023-07-30#5465[BUG]: Submit buttons remain in 'Saving' State when Duplicate Modal is Closed11 comments · 2025-12-16#5327Partner profile mandatoriness at submission11 comments · 2025-08-24
Latest release
2026.11.15 2026.11.15 2026-11-15What's Changed Fix distribution line-item labels on narrow screens (5603) by @Sinkleberg in https://github.com/rubyforgood/human-essentials/pull/5750 Keep download buttons enabled after the file downloads (Resolves 5691) by @costajohnt in https://github.com/rubyforgood/human-essentials/pull/5725 Bump knapsack_pro from 10.0.1 to 11.0.0 by @dependabot[bot] in https://github.com/rubyforgood/human-essentials/pull/5760 Bump rubocop from 1.88.2 to 1.91.0 by @dependabot[bot] in https://github.com/rubyforgood/human-essentials/pull/5758 Bump bootsnap from 1.26.0 to 1.26.1 by @dependabot[bot]