forma11y known as VisionImpairedFriendlyMedicalForms

Decrease barriers for blind and vision impaired people in medical practices.

Requirments

• Node
• Ionic - Angular

Get started

1. clone the project

git clone git@github.com:HealthHackAu2020/forma11y.git

2. cd into forma11y

cd forma11y

1. run npm install npm ci vs npm install

npm ci

4a. serve the project npx vs npm

npx ionic serve

4b. serve the project: show iOS and Android (npx ionic serve --l)

npx ionic serve --l

5. Ensure that you can do a prod build locally

npx ionic build --prod

Deployment

Forma11y github page

• Deployed via Github pages for now (all in one place)

npm run gh-pages

What this script does:

• does prod build
• uses gh-pages branch
• uses the www directory

Helpful commands

• Ionic Repair Fixes
  • package lock files
  • node_modules

npx ionic repair

Project Thoughts

Must have

• Web forms ✅
• Form Validation ✅
• 0 Errors on HTML Codesniffer

Plan

Use current Ionic Angular to leverage:

• components ✅
• typescript ✅
• Wny Typescript? To future-proof for HL7 FHIR R4 eventually
  • HL7 FHIR R4
  • npm package
  • Handle FHIR Objects with Typescript
  • Typescript FHIR R4 Server
• Automate part of the a11y testing with:
  • pa11y plugin or Netlify a11y plugin

Resources

• Notes
• a11yproject
• Inclusive Design - Microsoft
• HTML Codesniffer Bookmarklet
• Lighthouse in Chrome Dev Tools
• Spectrum Google Chrome Extension
• Pa11y
• Netlfiy a11y plugin
• Do’s and Don’ts
• WebAIM Contrast Checker
• Accessible Color Generator
• Article a11y Dyslexia
• Bootstrap template for inspiration