Skip to content

dougdevitre/cognitive-load-ui-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🧠 Cognitive Load Reducer UI Kit

"Design system for stressed users"

A purpose-built UI component library designed to reduce cognitive overload and technostress for people navigating high-stakes legal and court processes.


🔍 Problem

People interacting with the justice system are often stressed, overwhelmed, and cognitively depleted. Standard UI patterns — dense forms, legal jargon, information overload — make things worse. Research shows cognitive overload leads to errors, abandonment, and worse outcomes for the most vulnerable users.

💡 Solution

The Cognitive Load Reducer UI Kit provides step-by-step flows, plain language interfaces, progress tracking, and "Explain Like I'm 12" toggles — a complete design system built specifically for users under stress.

🎯 Impact

  • Self-represented litigants complete tasks without overwhelm
  • Parents in crisis navigate complex processes with clarity
  • Courts see higher completion rates and fewer errors
  • Developers ship accessible, human-centered justice tools faster

🏗️ Architecture

┌─────────────────────────────────────────┐
│        Cognitive Load UI Kit            │
├──────────┬──────────┬───────────────────┤
│  Step    │  Plain   │   Progress        │
│  Flows   │ Language │   Tracking        │
│          │  Toggle  │                   │
├──────────┼──────────┼───────────────────┤
│  Info    │  Error   │   "ELI12"         │
│  Chunking│ Recovery │   Explainer       │
├──────────┴──────────┴───────────────────┤
│     Accessible Component Primitives     │
│       (WCAG 2.1 AA Compliant)           │
├─────────────────────────────────────────┤
│    Theming + Customization Layer        │
└─────────────────────────────────────────┘

🛠️ Tech Stack

Layer Technology
Components React + TypeScript
Styling Tailwind CSS + CSS custom properties
Accessibility WCAG 2.1 AA compliant
Documentation Storybook
Testing Jest + React Testing Library + axe-core
Design Tokens Standardized spacing, typography, color

📦 Components

Component Description
StepFlow Multi-step wizard with progress bar and save state
PlainLanguageToggle Switch between legal language and plain English
ELI12 Explainer "Explain Like I'm 12" popup for any legal term
ChunkedForm Break long forms into digestible sections
ErrorRecovery Friendly, non-punitive error messages with guidance
ProgressTracker Visual progress through multi-step processes
CalmAlert Non-alarming notifications for stressed users
ReadingLevelIndicator Shows content reading level in real time

🚀 Quick Start

git clone https://github.com/yourusername/cognitive-load-ui-kit.git
cd cognitive-load-ui-kit
npm install
npm run storybook

👥 Who This Helps

  • Parents under stress navigating custody processes
  • Self-represented litigants completing court forms for the first time
  • Elderly users interacting with court technology
  • People with cognitive disabilities who need simplified interfaces
  • Justice tech developers building empathetic applications

🗺️ Roadmap

  • Core component library (StepFlow, PlainLanguageToggle, ELI12)
  • Storybook documentation
  • WCAG 2.1 AA audit and compliance
  • Design token system
  • Reading level detection engine
  • Anxiety-reduction animation patterns
  • Dark mode / high contrast themes

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

📄 License

MIT License — See LICENSE for details.


⚠️ Disclaimer

This project is provided for informational and educational purposes only and does not constitute legal advice, legal representation, or an attorney-client relationship. No warranty is made regarding accuracy, completeness, or fitness for any particular legal matter. Always consult a licensed attorney in your jurisdiction before making legal decisions. Use of this software does not create any professional-client relationship.


Built by Doug Devitre

I build AI-powered platforms that solve real problems. I also speak about it.

CoTrackPro · admin@cotrackpro.com

Hire me: AI platform development · Strategic consulting · Keynote speaking

AWS AI/Cloud/Dev Certified · UX Certified (NNg) · Certified Speaking Professional (NSA) Author of Screen to Screen Selling (McGraw Hill) · 100,000+ professionals trained

About

Cognitive Load Reducer UI Kit — UX patterns and components designed to reduce cognitive burden for users in high-stress legal and justice contexts.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors