Link to Next Steps Website
Link to Back-End Microservice
- Project Description
- Inspiration
- Testimonials
- Case Studies
- Features
- Usage
- Future Iterations
- Contributors
- Setup
- Testing
- Viewing the Web App
- Ruby 3.2.2
- Rails 7.0.7.2
- Faraday gem to interact with APIs
- SimpleCov gem for code coverage tracking
- ShouldaMatchers gem for testing assertions
- VCR / Webmock to stub HTTP requests in tests to simulate API interactions
- Omniouth gem for Oauth
Next Steps is a full-stack project that leverages the 211 API along with geolocation to assist individuals in finding community resources in their vicinity. We thought it was particularly important to create search options catered to persons who may not have the ability to navigate existing resources. This repository contains the front-end portion of the project which utilizes the API provided by the back-end repository.
This project has been deployed using Heroku, and Circle CI was used for Continuous Integration.
The project draws inspiration from various areas, serving as a tool to support:
- Mental Health Awareness: Providing access to mental health resources.
- The Unhoused Community: Assisting those experiencing homelessness in finding shelter and services.
- Justice-Affected Individuals: Offering support for individuals impacted by the justice system.
- People with Disabilities: Ensuring accessibility to resources for individuals with disabilities.
This tool is designed to assist a wide range of professionals, including crisis workers, first responders, social workers, therapists, case managers, or any person looking for community resources.
"Right now, I have a list of 12 different links that I use when I research options for my clients. I would love to have an app that has everything in one place" - anonymous case manager
"It is challenging for people with mental health struggles to have the wherewithal to search the internet for resources they need, let alone come up with the 'next step' on their to-do list. This kind of help is great for them." - anonymous social worker
"The hardest part of my job is to find housing for people who have criminal backgrounds. If there was a way for housing providers to add their listings, I would be grateful" - housing specialist
“I just got out of jail and need a place to go” => recommend shelters and/or transitional housing
“I’m ready for therapy and don’t have insurance” => connection to Medicaid & providers
"I need diapers and clothes for my baby” => connection to family services
“I have PTSD and will not go to shelters, I live in my car, it's -2 deg outside, where can I park?” => List of safe lots and emergency shelter options
- Users of the app can access community resources anonymously.
- Pre-built search queries are available to streamline the resource-finding process.
- An option to search for resources using keyword endpoints from 211 API.
- The user has the option to create an account.
- The user can create an account and/or log in using Google OAuth.
- The user is automatically logged out of the session after 15 minutes of inactivity.
- Service providers can create accounts to add information about their specific services.
- Providers offering specialized services such as housing for justice-affected individuals, LGBTQIA+ friendly services, emergency shelter, or any service relevant to vulnerable communities can create profiles to make their services searchable.
- Admin users review provider applications and can approve or deny them.
This project is the front-end user experience that utilizes an API endpoint to create convenient search options for the individuals we serve. The endpoint takes in two parameters, "keyword" and "location". We provide the user with some keywords built in, such as "basic needs", "shelters", "medical care", "mental health care", and others. They can select keywords from our provided options, or utilize the search bar to search their own keyword(s).
- Scale: Utilize cloud storage to store data for Providers and resource list saved by the user.
- Utilize Open AI API for generating motivational statements based on the user's identified needs.
- Create additional pre-built search options that make finding resources easy and convenient.
- Provider dashboard and Admin functionality.
- Allen Russell - GitHub: @garussell
- Weston Schutt - GitHub: @westonio
- Kaina Cockett - GitHub: @kcockett
- Zanna Fitch - GitHub: @z-fitch
- Jorja Flemming - GitHub: @jorjaf
- Fork and Clone the repo
- Navigate into the repo directory
cd next-steps-front-end - Install gem packages:
bundle install - Setup the database:
rails db:{drop,create,migrate,seed}
- After completing the above setup, run the command
bundle exec rspec
- Run the command
rails server - In your web browser, navigate to your local host
http://localhost:3000
