Accessibility policy
Our commitment
Graupl helps people who may use the web differently than we do. We want people with disabilities, including people who use assistive technology, to be able to use our components, read our documentation, and contribute to our projects.
Accessibility is our highest priority. That includes the people reading our code. We aim to write plainly enough for someone entering the field to follow, with the detail experienced developers need to understand and maintain the work.
We work toward Web Content Accessibility Guidelines 2.2 Level AA for our web content and examples. Components that implement an interaction pattern are designed to follow the relevant ARIA Authoring Practices Guide pattern and WAI-ARIA requirements.
These are our accessibility goals. They are not a claim of verified conformance across every project or example. We use automated checks and human review to assess our work. Contributors remain responsible for what they submit, including work created with AI assistance.
Supported environments
Graupl provides Sass styles, utilities, and JavaScript components built on Accessible Ecosystem Core. A website's markup, content, theme choices, and integration affect the accessibility of the result.
Graupl has automated browser tests configured for Chromium, Firefox, and WebKit. These tests do not establish support for every browser version or assistive technology. Graupl does not currently publish a browser-version or assistive-technology support matrix.
If you encounter an issue in your browser or assistive technology, please report it. You do not need to establish that your environment is officially supported before asking for help.
Known limitations
- Custom colors, styles, and markup can affect contrast, focus visibility, semantics, and other accessibility requirements. Check the finished website after customization.
- Browser tests and screenshots cover selected examples. They do not replace keyboard and assistive-technology testing.
- Graupl does not currently publish a comprehensive record of assistive-technology testing. Compatibility beyond recorded checks remains unverified.
Automated tests cannot establish that an interaction works for every person or assistive technology. A passing test suite is not a guarantee of accessibility.
Confirmed issues and available workarounds are tracked in the project's issues. A limitation that has not been reported or documented may still exist.
Report an accessibility issue
Open an accessibility issue to report an issue in Graupl or its documentation. For another Accessible Ecosystem project, use that project's issue tracker.
Tell us what you were trying to do and what made it difficult or prevented you from continuing. The following details can help, if you have them:
- A link to the affected page, component, or example.
- What happened and what you expected instead.
- Steps to reproduce the problem.
- Your package version, browser, operating system, and assistive technology, including versions where available.
- Any workaround you found.
You do not need to provide a diagnosis, identify a standard, write code, or propose a fix. An incomplete technical report is still useful. Screenshots and recordings are optional.
GitHub issues are public. Share only information you are comfortable making public.
How we respond
Project maintainers are responsible for reviewing accessibility reports and keeping this policy current. We treat reports as evidence of a person's experience and an opportunity to improve the project.
We prioritize issues that prevent people from completing tasks, while considering impact and available workarounds. We explain relevant dependencies and limitations, share workarounds when available, and update the issue as work progresses. We may ask whether a proposed fix resolves the issue you reported.
Resolution time depends on the problem and maintainer availability. When we can provide an expected timeline, we share it in the issue and update it if circumstances change.
Attribution
This policy is based on the Accessibility Toolkit accessibility policy by Open Source Accessibility, adapted for Accessible Ecosystem.
This document is based on Accessible Ecosystem Core, adapted from its corresponding document.