Skip to content

Tswelo23/DisabilityAwareness

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

♿ DisabilityAware

An Accessibility-First Educational Web Platform

DisabilityAware is a comprehensive, accessibility-focused educational web application built with ASP.NET Core MVC. The platform provides clear, structured information on disabilities, support services, educational resources, and inclusion best practices — while strictly adhering to modern accessibility standards (WCAG 2.1 AA).


🌍 Project Purpose

The goal of DisabilityAware is to:

  • Promote disability awareness and inclusion
  • Provide accessible, easy-to-understand educational content
  • Support individuals, caregivers, educators, and organisations
  • Demonstrate best-practice accessible web development using ASP.NET Core

🏗️ Project Architecture

🔧 Technology Stack

Backend

  • ASP.NET Core 7.0 MVC

Frontend

  • HTML5
  • CSS3 (Custom CSS + CSS Variables)
  • JavaScript (ES6+)

UI & Libraries

  • Bootstrap 5.3
  • jQuery 3.6
  • Font Awesome 6.4

Typography

  • Inter (Body text)
  • Space Grotesk (Headings)

🚀 Key Features

♿ Core Accessibility Features

  • Accessibility toolbar (fixed position)
  • Font size adjustment (12px – 30px)
  • High-contrast mode (black/white)
  • Text-to-speech using Web Speech API
  • Stop speech functionality
  • Persistent user preferences (localStorage)

✅ Accessibility Compliance

  • WCAG 2.1 AA compliant
  • Full keyboard navigation
  • Screen-reader friendly (ARIA + semantic HTML)
  • Minimum colour contrast ratio of 4.5:1

🧭 Navigation & User Experience

  • Fully responsive navigation (Bootstrap 5)
  • Active page highlighting
  • Sticky navigation with scroll effects
  • Smooth scrolling for anchor links
  • Back-to-top button
  • Mobile-first responsive design

📄 Content Pages

🏠 Home Page (Index.cshtml)

  • Animated hero section
  • Disability education cards (6 categories)
  • Statistics section with animated counters
  • Inclusion principles and support highlights

🧠 Disability Types (Types.cshtml)

  • Detailed explanations of disability categories
  • Filterable and structured content
  • Interactive cards and tables
  • External resources and references

🛠️ Support Services (Services.cshtml)

Most comprehensive section of the platform

Service Categories

  • Assistive Technology
  • Personal Support
  • Educational Services
  • Employment Support
  • Housing Support
  • Health Services

Additional Features

  • Interactive technology assessment tool
  • South African funding and grant resources
  • Service provider directory (150+ links)
  • Interactive service request forms
  • Downloadable tools and guides

📚 Resources (Resources.cshtml)

  • Educational guides and learning materials
  • Downloadable resources
  • Training calendars
  • Search functionality

🤝 Inclusion Guide (Inclusion.cshtml)

  • Inclusion best practices
  • Accessibility guidelines
  • Community and training resources
  • Organisational inclusion strategies

🚀 Deployment

  • Local development using IIS Express

🛠️ Development Setup

✅ Prerequisites

  • .NET 7.0 SDK or later

  • Visual Studio 2022 or VS Code

  • Node.js (optional – frontend tooling)

  • Modern browser:

    • Chrome 90+
    • Firefox 88+
    • Safari 14+

▶️ Running the Project

  1. Clone the repository
  2. Open the solution in Visual Studio
  3. Restore NuGet packages
  4. Run the project using IIS Express
  5. Navigate to https://localhost:xxxx

📌 Future Enhancements

  • Multi-language support
  • User accounts and profiles
  • CMS-driven content management
  • API integration for live service data
  • Automated accessibility testing

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors