{"id":48824679,"url":"https://github.com/adapt-ux/neuro-ux-sdk","last_synced_at":"2026-04-14T17:31:39.551Z","repository":{"id":324155056,"uuid":"1096174361","full_name":"adapt-ux/neuro-ux-sdk","owner":"adapt-ux","description":"Adaptive UX toolkit for neurodivergent-friendly interfaces.  Framework-agnostic, research-driven, and fully customizable.","archived":false,"fork":false,"pushed_at":"2026-02-22T02:57:11.000Z","size":581,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-22T10:21:23.972Z","etag":null,"topics":["a11y","accessibility","adaptive-ui","adaptive-ux","design-tokens","framework-agnostic","heuristics","inclusive-design","javascript","lit","neurodivergent","neurodiversity","scss","signals","typescript","user-experience","ux-patterns","ux-research","web-components"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adapt-ux.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":"docs/roadmap/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-14T03:24:22.000Z","updated_at":"2026-01-04T03:13:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/adapt-ux/neuro-ux-sdk","commit_stats":null,"previous_names":["adapt-ux/neuro-ux-sdk"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/adapt-ux/neuro-ux-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adapt-ux%2Fneuro-ux-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adapt-ux%2Fneuro-ux-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adapt-ux%2Fneuro-ux-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adapt-ux%2Fneuro-ux-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adapt-ux","download_url":"https://codeload.github.com/adapt-ux/neuro-ux-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adapt-ux%2Fneuro-ux-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31808505,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T11:13:53.975Z","status":"ssl_error","status_checked_at":"2026-04-14T11:13:53.299Z","response_time":153,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["a11y","accessibility","adaptive-ui","adaptive-ux","design-tokens","framework-agnostic","heuristics","inclusive-design","javascript","lit","neurodivergent","neurodiversity","scss","signals","typescript","user-experience","ux-patterns","ux-research","web-components"],"created_at":"2026-04-14T17:31:37.917Z","updated_at":"2026-04-14T17:31:39.520Z","avatar_url":"https://github.com/adapt-ux.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg width=\"1536\" height=\"1024\" alt=\"Banner \" src=\"https://github.com/user-attachments/assets/48be33dc-bc4d-4257-a16c-9e39f39c5a7c\" /\u003e\n\n# **NeuroUX SDK**\n\n![Build](https://img.shields.io/github/actions/workflow/status/adapt-ux/neuro-ux-sdk/ci.yml?label=build\u0026style=flat)\n![Release](https://img.shields.io/github/v/release/adapt-ux/neuro-ux-sdk?style=flat)\n![License](https://img.shields.io/github/license/adapt-ux/neuro-ux-sdk?style=flat)\n![NPM Version](https://img.shields.io/npm/v/neuro-ux-sdk?style=flat)\n![Downloads](https://img.shields.io/npm/dm/neuro-ux-sdk?style=flat)\n![Discussions](https://img.shields.io/github/discussions/adapt-ux/neuro-ux-sdk?style=flat)\n[![Roadmap](https://img.shields.io/badge/roadmap-available-blue?style=for-the-badge?style=flat)](docs/roadmap/ROADMAP.md)\n\nAdaptive User Experience Framework for Cognitive Diversity\n\n---\n\n## 🌐 Overview\n\n**NeuroUX SDK** is an open, framework-agnostic toolkit designed to make digital experiences more adaptable, inclusive, and comfortable for people with diverse cognitive and sensory processing styles.\n\nInstead of enforcing a one-size-fits-all interface, NeuroUX enables **dynamic UI adjustments** that respect attention patterns, reading styles, sensory thresholds, and cognitive load — without diagnosing, tracking, or labeling users.\n\nBuilt with **TypeScript**, **Web Components**, and optional wrappers for React, Vue, Angular, Svelte, Next and vanilla JavaScript, the SDK can run anywhere: from enterprise platforms to static HTML pages.\n\n---\n\n## ✨ Key Features\n\n### **🔸 Universal Compatibility**\n\nRuns in:\n\n* React\n* Vue\n* Svelte\n* Angular\n* HTML/vanilla JavaScript\n* Next\n* CMS platforms (WordPress, Shopify, etc.)\n\n### **🔸 Evidence-Based Adaptive Engine**\n\nBehavioral signals detect when users may benefit from:\n\n* Reduced visual noise\n* Increased focus\n* Enhanced readability\n* Lower cognitive load\n* Simplified interactions\n\nAll adaptations are **optional**, **transparent**, and **opt-in**.\n\n### **🔸 Web Components UI (NeuroAssist)**\n\nA universal widget that allows users to adjust:\n\n* Motion reduction\n* Focus mode\n* Typography tuning\n* Contrast\n* Spacing\n* Reading aids\n* Highlighting features\n\n### **🔸 Framework Wrappers (Optional)**\n\nLightweight bindings for popular frameworks:\n\n* `@adapt-ux/neuro-react` - React wrapper\n* `@adapt-ux/neuro-vue` - Vue wrapper\n* `@adapt-ux/neuro-angular` - Angular wrapper\n* `@adapt-ux/neuro-svelte` - Svelte wrapper\n* `@adapt-ux/neuro-js` - Vanilla JavaScript loader\n* `@adapt-ux/neuro-next` - Next wrapper\n\n### **🔸 Zero Diagnosis, Zero Tracking**\n\nThe SDK does **not**:\n\n* infer medical conditions\n* store cognitive profiles\n* track identity\n* require accounts\n\nIt only adapts based on **interaction patterns** and **user preference**.\n\n---\n\n## 📦 Packages\n\nThe monorepo contains:\n\n```\nlibs/\n  core/          # @adapt-ux/neuro-core - Adaptive engine (TS)\n  assist/        # @adapt-ux/neuro-assist - Web Components UI\n  styles/        # @adapt-ux/neuro-styles - Tokens, themes, SCSS utilities\n  signals/       # @adapt-ux/neuro-signals - Behavioral detection logic\n  utils/         # @adapt-ux/neuro-utils - Shared utilities\n\n  neuro-react/   # @adapt-ux/neuro-react - React wrapper\n  neuro-vue/     # @adapt-ux/neuro-vue - Vue wrapper\n  neuro-angular/ # @adapt-ux/neuro-angular - Angular wrapper\n  neuro-svelte/  # @adapt-ux/neuro-svelte - Svelte wrapper\n  neuro-js/      # @adapt-ux/neuro-js - Vanilla JavaScript loader\n  neuro-next/    # @adapt-ux/neuro-next - Next wrapper\napps/\n  demo/          # Example app for testing\ndocs/            # Internal documentation\n```\n\n---\n\n## 🚀 Getting Started\n\n### **Install the universal SDK**\n\n```bash\nnpm install @adapt-ux/neuro-core @adapt-ux/neuro-assist\n```\n\n### **Using the NeuroAssist Web Component (HTML/Vanilla JS)**\n\n```html\n\u003cscript type=\"module\" src=\"https://cdn.adaptux.dev/neuro-assist.js\"\u003e\u003c/script\u003e\n\n\u003cneuro-assist\u003e\u003c/neuro-assist\u003e\n```\n\nOr install via npm:\n\n```bash\nnpm install @adapt-ux/neuro-assist @adapt-ux/neuro-core\n```\n\n```javascript\nimport '@adapt-ux/neuro-assist';\n```\n\n---\n\n## 🧩 Framework Examples\n\n### **React**\n\n```bash\nnpm install @adapt-ux/neuro-react\n```\n\n```tsx\nimport { NeuroAssist } from '@adapt-ux/neuro-react';\n\nexport default function Page() {\n  return \u003cNeuroAssist /\u003e;\n}\n```\n\n---\n\n### **Next.js**\n\n```bash\nnpm install @adapt-ux/neuro-next\n```\n\n**app/layout.tsx** (Root Layout):\n```tsx\nimport { NeuroUXProvider } from '@adapt-ux/neuro-next';\n\nexport default function RootLayout({\n  children,\n}: {\n  children: React.ReactNode;\n}) {\n  return (\n    \u003cNeuroUXProvider\u003e\n      {children}\n    \u003c/NeuroUXProvider\u003e\n  );\n}\n```\n\n**app/page.tsx** (Client Component):\n```tsx\n'use client';\n\nimport { NeuroUXToggle } from '@adapt-ux/neuro-next';\n\nexport default function Page() {\n  return (\n    \u003cdiv\u003e\n      \u003ch1\u003eMy Next.js App\u003c/h1\u003e\n      \u003cNeuroUXToggle /\u003e\n    \u003c/div\u003e\n  );\n}\n```\n\n---\n\n### **Vue**\n\n```bash\nnpm install @adapt-ux/neuro-vue\n```\n\n```vue\n\u003ctemplate\u003e\n  \u003cneuro-assist /\u003e\n\u003c/template\u003e\n\n\u003cscript setup\u003e\nimport '@adapt-ux/neuro-vue';\n\u003c/script\u003e\n```\n\n---\n\n### **Angular**\n\n```bash\nnpm install @adapt-ux/neuro-angular\n```\n\n```typescript\n// app.module.ts or standalone component\nimport { Component } from '@angular/core';\nimport '@adapt-ux/neuro-assist';\n\n@Component({\n  selector: 'app-root',\n  template: '\u003cneuro-assist\u003e\u003c/neuro-assist\u003e'\n})\nexport class AppComponent {}\n```\n\n---\n\n### **Svelte**\n\n```bash\nnpm install @adapt-ux/neuro-svelte\n```\n\n```svelte\n\u003cscript\u003e\n  import '@adapt-ux/neuro-svelte';\n\u003c/script\u003e\n\n\u003cneuro-assist /\u003e\n```\n\n---\n\n### **Vanilla JavaScript**\n\n```bash\nnpm install @adapt-ux/neuro-js\n```\n\n```javascript\nimport '@adapt-ux/neuro-js';\n\n// Or via CDN\n// \u003cscript type=\"module\" src=\"https://cdn.adaptux.dev/neuro-js.js\"\u003e\u003c/script\u003e\n\n// The component will be available as a custom element\ndocument.body.innerHTML = '\u003cneuro-assist\u003e\u003c/neuro-assist\u003e';\n```\n\n---\n\n## 🛠 Development\n\n### Run the demo app:\n\n```bash\nnx serve demo\n```\n\n### Build all packages:\n\n```bash\nnx run-many --target=build --all\n```\n\n### Test:\n\n```bash\nnx test core\nnx test assist\nnx test signals\nnx test styles\nnx test utils\n```\n\n### Build a specific package:\n\n```bash\nnx build core\nnx build assist\nnx build react\n# ... etc\n```\n\n---\n\n## 🗺️ Roadmap\n\nOur development plans, research milestones, and long-term goals are documented in the roadmap.\n\n👉 **[Open ROADMAP.md](docs/roadmap/ROADMAP.md)**  \nThis document is frequently updated as the project evolves.\n\n---\n\n## 🔬 Vision \u0026 Philosophy\n\nNeuroUX is guided by these principles:\n\n* **Adaptation over standardization**\n* **Inclusion without identification**\n* **Respect by default**\n* **Evidence-driven design**\n* **Framework-agnostic architecture**\n* **Developer-first ergonomics**\n\nOur goal is simple:\n\n### **Make the web more comfortable for everyone — without assumptions, labels, or friction.**\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions in:\n\n* Accessibility research\n* UI/UX behavior experiments\n* New adaptive patterns\n* Code improvements\n* Documentation\n* Testing \u0026 QA\n\nPlease open a discussion or pull request.\n\n---\n\n## 📜 License\n\nMIT License — freely usable and modifiable for personal or commercial purposes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadapt-ux%2Fneuro-ux-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadapt-ux%2Fneuro-ux-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadapt-ux%2Fneuro-ux-sdk/lists"}