Disability Access Now is a comprehensive web application designed to streamline and simplify the information aggregation/application process for individuals with disabilities, their caregivers, and case workers. By offering role-based guidance, centralized tips, and intuitive search functionality, the platform provides personalized support via interactive features and an admin-responsive Q&A system. Users benefit from a tailored dashboard allowing the saving of past researched documentation, resources, tracking of questions, and accessing personalized content while also maintaining WCAG 2.1 accessibility compliance. The application aims to transform complex and time-consuming application processes into a more navigable, supportive, and user-friendly experience by leveraging technology to break down the existing barriers and provide real-time, contextual guidance across different user roles.
This project should be able to run in your favorite IDE. We used VS code while building it.
Before you get started, make sure you have the following software installed on your computer:
- Fork the repository
- Copy the SSH key in your new repository
- In your terminal type...
git clone {paste SSH link} - Navigate into the repository's folder in your terminal
- Open VS Code (or editor of your choice) and open the folder
- In the terminal of VS Code run
npm installto install all dependencies - Create a
.envfile at the root of the project and paste this line into the file:SERVER_SESSION_SECRET= "choose a string longer than 8 digits for your session secret, you can randomly generate one" - You'll also need to add this to your .env file if you'd like the email notifications to function
GMAIL_USER= "your gmail account" GMAIL_PASS= "create an app password via gmail" - Create a database named
disability_applicationin PostgresSQL If you would like to name your database something else, you will need to changedisability_applicationto the name of your new database name inserver/modules/pool.js - The queries in the database.sql file are set up to create all the necessary tables that you need, as well as a dummy data table to test the app. Copy and paste those queries in the SQL query of the database. If this is going to production, leave out the dummy data.
- Run
npm run serverin your VS Code terminal - Open a second terminal and run
npm run client
Once everything is installed and running it should open in your default browser - if not, navigate to http://localhost:5173/#/.
Video walkthrough of application usage: https://www.youtube.com/watch?v=HRonNTkScl0
- Login Credentials for Heroku have been provided in the hand off document.
- If you need make changes you wish to push to the deployed app, you must login, go into the disability-access-now section, go to the deploy tab, and then manually deploy. You can reconfigure this to redeploy automatically if you wish, which is on the same page.
- Environment variables are kept on Heroku in the Settings tab, just click the Reveal Config Vars button
- To set up the database, we used Postico, just plug the information from Heroku into a new favorite. The Information for this can be found in the Resources tab, by clicking the Postgres add on. From there it will bring you to a new page where you will go into the settings tab and click view credentials.