Contributing

Thank you for your interest in contributing to EthioWDS. We welcome contributions from the community to help improve the design system for Ethiopian government digital services.

How to Contribute

  1. Fork the repository on GitHub and clone it locally.
  2. Create a branch for your change: git checkout -b feature/your-feature-name or fix/your-fix-name.
  3. Make your changes following our code standards and design guidelines.
  4. Test your changes — see our testing guide.
  5. Commit with clear messages, e.g. feat: add new button variant or fix: contrast in dark theme.
  6. Push to your fork and open a Pull Request against the main repository.

What We Welcome

  • New components that align with the design system
  • Accessibility improvements (WCAG 2.1 AA)
  • Ethiopian localization (Amharic, other languages)
  • Documentation and examples
  • Bug fixes and performance improvements
  • Design token or theme enhancements

Reporting Issues

Before opening an issue, check existing issues and discussions. When reporting bugs, please include:

  • Steps to reproduce
  • Expected vs actual behavior
  • Browser and OS (and version if relevant)
  • Screenshots or code samples when helpful

Open an issue on GitHub.

Code of Conduct

Be respectful and inclusive. We aim to maintain a welcoming environment for everyone contributing to Ethiopian digital government standards.

Questions?

Use GitHub Discussions for questions, ideas, or feedback.