Practical human factors and accessibility guidance for product teams. An open-source, community-driven resource for building technology that truly serves people.
Human Standards is a comprehensive guide covering the human side of product design:
- Cognition — Attention, cognitive load, working memory
- Perception — Vision, hearing, touch
- Emotions & Motivation — Trust, stress, motivation models
- Decision-Making — Biases, errors, defensive design
- Ergonomics — Posture, touch targets, anthropometrics
- Accessibility — WCAG guidelines, assistive technologies
- Interaction Patterns — Forms, navigation, notifications
- Research Methods — Usability testing, cognitive walkthroughs
# Clone the repository
git clone https://github.com/aklodhi98/humanstandards.git
cd humanstandards
# Install dependencies
npm install
# Start the development server
npm run devOpen http://localhost:4321 to view the site.
| Command | Action |
|---|---|
npm install |
Install dependencies |
npm run dev |
Start local dev server at localhost:4321 |
npm run build |
Build production site to ./dist/ |
npm run preview |
Preview build locally before deploying |
We welcome contributions from everyone! Here's how you can help:
- Fork the repository
- Create a branch for your changes:
git checkout -b add-new-topic - Add or edit Markdown files in
src/content/docs/ - Submit a Pull Request with a clear description
- Be evidence-based — Cite standards (WCAG, ISO) and reputable sources
- Be practical — Include actionable guidance, not just theory
- Be concise — Use clear, direct language
- Be inclusive — Consider diverse users and contexts
src/content/docs/
├── index.mdx # Homepage
├── cognition/ # Cognitive psychology topics
├── perception/ # Sensory perception
├── accessibility/ # WCAG and assistive tech
├── interaction-patterns/ # UI patterns
└── ... # Other topic areas
Each content file uses this frontmatter structure:
---
title: Your Page Title
description: A brief description for SEO and previews.
---We are committed to providing a welcoming and inclusive environment. Please be respectful and constructive in all interactions.
- Content (documentation): CC BY-NC-SA 4.0 — Share and adapt with attribution, non-commercial use only
- Code (tooling/scripts): MIT License
See LICENSE.md for full details.
© 2024-2026 Adnan Lodhi. All rights reserved for commercial use.
Human Standards builds upon and is inspired by excellent prior work in the UX and accessibility communities.
- Luxor Claude Marketplace by Manu Tej + Claude Code - Real-world UX examples and patterns adapted with permission under MIT license. See THIRD_PARTY_LICENSES.md.
- WCAG 2.2 - W3C Web Content Accessibility Guidelines
- Nielsen's Usability Heuristics - Nielsen Norman Group foundational principles
- iOS Human Interface Guidelines - Apple Inc. design standards
- Material Design - Google LLC design system
Built with Astro and Starlight.
Thank you to researchers in cognitive psychology, human factors engineering, and HCI whose evidence-based work makes this resource possible. Full citations in academic research references.
Thank you to all who advance human-centered design. 🙏
Questions? Open an issue or start a discussion. We'd love to hear from you!