{"id":13554814,"url":"https://github.com/freeCodeCamp/pantry-for-good","last_synced_at":"2025-04-03T07:32:58.669Z","repository":{"id":43212333,"uuid":"72547133","full_name":"freeCodeCamp/pantry-for-good","owner":"freeCodeCamp","description":"An open source food bank logistics and inventory management tool","archived":true,"fork":false,"pushed_at":"2019-04-29T16:18:17.000Z","size":2703,"stargazers_count":389,"open_issues_count":29,"forks_count":189,"subscribers_count":52,"default_branch":"staging","last_synced_at":"2024-08-01T12:33:15.106Z","etag":null,"topics":["charity","food","food-banks","inventory-management","nonprofit","nonprofit-organizations","nonprofits","opensourceforgood"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/freeCodeCamp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-01T15:02:08.000Z","updated_at":"2024-07-17T03:10:17.000Z","dependencies_parsed_at":"2022-09-09T23:20:11.530Z","dependency_job_id":null,"html_url":"https://github.com/freeCodeCamp/pantry-for-good","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeCodeCamp%2Fpantry-for-good","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeCodeCamp%2Fpantry-for-good/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeCodeCamp%2Fpantry-for-good/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/freeCodeCamp%2Fpantry-for-good/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/freeCodeCamp","download_url":"https://codeload.github.com/freeCodeCamp/pantry-for-good/tar.gz/refs/heads/staging","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222935626,"owners_count":17060398,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["charity","food","food-banks","inventory-management","nonprofit","nonprofit-organizations","nonprofits","opensourceforgood"],"created_at":"2024-08-01T12:02:55.391Z","updated_at":"2024-11-04T03:31:19.563Z","avatar_url":"https://github.com/freeCodeCamp.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","others"],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/freeCodeCamp/pantry-for-good.svg?branch=staging)](https://travis-ci.org/freeCodeCamp/pantry-for-good)\n[![Docker Repository on Quay](https://quay.io/repository/painejs/pantry-for-good/status \"Docker Repository on Quay\")](https://quay.io/repository/painejs/pantry-for-good)\n[![Join the chat at https://gitter.im/FreeCodeCamp/pantry-for-good](https://badges.gitter.im/FreeCodeCamp/pantry-for-good.svg)](https://gitter.im/FreeCodeCamp/pantry-for-good?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nThis repository is for the Pantry-for-Good application designed by Open Source for Good Contributors at [freeCodeCamp](http://www.freecodecamp.com). For deployment instructions see the [deployment guide](DEPLOYMENT.md).\n\nIf you'd like to contribute, the [contributing guide](CONTRIBUTING.md) explains the git workflow and the [developers guide](https://github.com/freeCodeCamp/pantry-for-good/wiki/developer's-guide) gives an overview of how the app works. The [open issues](https://github.com/freeCodeCamp/pantry-for-good/issues) are a good place to start, or you can try the app and add your own issues. If you get stuck or need help with something, feel free to leave a comment.\n\nSome issues are quite large, don't feel like you have to finish them, it's ok. Little bits help too! Start slow! \n\nThere's a demo app hosted at https://pantry-for-good.herokuapp.com, though it might be a bit behind the current version.\n\n## Installation\n\n------------\n### Local installation summary:\n1. Install [Node.js](http://nodejs.org) and [MongoDB](https://docs.mongodb.com/manual/installation/#mongodb-community-edition)\n2. Start MongoDB\n3. `git clone https://github.com/freeCodeCamp/Pantry-for-Good.git`\n4. `cd Pantry-for-Good`\n5. Make sure you're on the 'staging' branch (`git branch`), otherwise run `git checkout staging`\n6. `npm install`\n7. `npm run dev`\n8. Open \u003chttp://localhost:8080\u003e in your web browser\n9. Login with username `admin@example.com` password `password`\n\n\n------------\n### Detailed local development installation steps\n\nYou'll need to have a **Node.js** version \u003e= 6 installed. Either use your OS's package manager or follow the installation instructions on the [official website](http://nodejs.org).\n\nThis app uses **MongoDB** as its database engine. Follow [these instructions](https://docs.mongodb.com/manual/installation/#mongodb-community-edition) to install it locally and start the MongoDB server on your machine.\n\nInstall [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) if it is not already installed. To clone this repository to your local machine, open a command line interface and navigate to the directory where you would like to install the app. Then run\n`git clone https://github.com/freeCodeCamp/Pantry-for-Good.git`\n\nMove to the `Pantry-for-Good` directory and run the `npm install` command to install the application dependencies.\n\nType `npm run dev` to start the application in development mode. If all goes well, it will be available at `http://localhost:8080`.  The application is pre-populated with an administrator account with `admin@example.com` as username  and `password` as password.\n\n\n------------\n### Installing API keys\n\nTo use all the features of this application you will need to obtain API keys and install them in the application. After following the instructions below to obtain API Keys, put your keys in the file `server/config/env/secrets.js`.\n\n#### 1. [gmapsApiKey](https://developers.google.com/maps/documentation/javascript/get-api-key)\nGoogle Maps API key for the deliveries feature. Currently, this key needs to be entered in the general settings page of your local instance of the application.\n#### 2. [oauth](https://developers.google.com/identity/sign-in/web/devconsole-project)\nGoogle+ API for allowing users to register/login with google.\n#### 3. [sendgrid](https://sendgrid.com)\nSendgrid email API for sending emails.\n- Register for a trial account or deploy the app and get the username/password from the heroku config vars\n- Go to [Settings \u003e API Keys](https://app.sendgrid.com/settings/api_keys) and create a key\n- Paste the key in `secrets.js` or the `SENDGRID_API_KEY` config var of your deployed app.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FfreeCodeCamp%2Fpantry-for-good","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FfreeCodeCamp%2Fpantry-for-good","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FfreeCodeCamp%2Fpantry-for-good/lists"}