@a11yuikit/wc 🧩

Accessible Web Components that just work — out of the box.

🚀 Why @a11yuikit/wc?

Most UI libraries prioritize visuals first and accessibility later — if ever.
@a11yuikit/wc flips that philosophy. It’s a growing collection of modern, lightweight, and accessible Web Components that are:

• ♿ Accessible by default (WCAG 2.1 AA compliant)
• ⌨️ Fully keyboard navigable
• 🧭 Framework-agnostic (works with any frontend stack)
• ⚡ Lightweight and dependency-free
• 🧪 Built with accessibility as a non-negotiable baseline

📦 Installation

pnpm install @a11yuikit/wc

or

yarn add @a11yuikit/wc

You can also use it via CDN for quick experiments.

🧩 Planned Components

| Component | Description | Status | |-------------------|-------------------------------------------|---------------| | <a11y-modal> | Accessible modal with focus trap | ✅ Stable (coming soon) | | <a11y-tooltip> | Tooltip with ARIA support | 🧪 In progress | | <a11y-tabs> | Tabs with keyboard navigation | 🧪 In progress | | <a11y-toast> | Non-blocking toast notifications | 🚧 Planned | | <a11y-dialog> | Dialog with auto focus management | 🚧 Planned |

🧠 Philosophy

Accessibility isn’t a “nice to have.” It’s a requirement.

This project is guided by a simple principle:

If it’s not accessible, it’s broken.

Every component will:

• Comply with accessibility standards by default
• Work seamlessly with assistive technologies
• Be usable with a keyboard alone
• Respect user preferences and motion settings

🛠️ Development

git clone https://github.com/humayunkabir/a11y-wc.git
cd a11y-wc
pnpm install
pnpm run dev

Build for production:

pnpm run build

Run tests:

pnpm test

🧭 Roadmap

• [ ] Release first stable components
• [ ] Automated accessibility testing integration
• [ ] Theming support
• [ ] Documentation site
• [ ] Dark mode support
• [ ] Community contributions & starter templates

🤝 Contributing

Contributions are very welcome.
If you believe accessibility should be the default, join in.
See CONTRIBUTING.md for details once the repo opens for contributions.

📄 License

MIT © Humayun Kabir

🌍 Join the Movement

@a11yuikit/wc isn’t just a package — it’s a push toward a more inclusive web.
If you like the mission, star the repo, share it, and let’s build something that matters.