README.md

SNAP Screener

Find out if you are eligible for food assistance at Hunger Free Oklahoma.

---

The SNAP Screener is a single-page web application built with React and hosted on Firebase Hosting. Currently avaiable at snap-screener-ok.firebaseapp.com with final domain forthcoming. School contacts are managed with a Google Sheet available here. All other pertinent settings are available within src/lib/config.js—such as who recieves all email notifications with the variable NOTIFY_CC.

PLEASE NOTE: The spreadsheet uses real email addresses so submitting a form will, in fact, send emails out to all contacts listed for the selected school.

---

Partners

• Hunger Free Oklahoma
• Tulsa Public Schools
• Oklahoma Department of Human Services
• Spark Collaborative
• Underdog Systems
• Code for Tulsa

---

Technology

• Typescript
• React via Create React App
• Styled Components
• React i18next
• React Router
• Firebase via Hosting + Functions
• Mailjet

---

Development

To get started developing locally, clone the project. The from the root directory, run:

npm install
npm start

Requirements

• node > v10

---

Task List

• Front-end UI
• Back-end hosting
• Cloud function to determine eligibility and send mail
• Establish mail service and template via Mailjet
• Update NOTIFY_CC in src/lib/config.ts to reflect email address to receive all submissions
• Add Google Analytics for tracking
• Domain handling (to get site pointed from *.hungerfreeok.org)
• Domain email validation (to get emails as sent from HFO)
• Continus deployment via GitHub Actions (to redeploy cloud function + web app whenever commit is pushed to master branch)
• Possibly use Google Places Autocomplete API for address lookup?
• Possibly set up a hosted staging environment linked with a dev branch?
• Possibly move NOTIFY_CC from hard-coded config file to google spreadsheet