# Contributing to LibreUIUX

Thank you for your interest in improving UI/UX development with Claude Code! This guide will help you contribute effectively.

## Before You Contribute

1. **Read the [README](../README.md)** - Understand the project structure and philosophy
2. **Check the [VOICE_GUIDE](../VOICE_GUIDE.md)** - Maintain consistent tone (45% technical, 30% wonder, 20% playful, 5% encouragement)
3. **Search existing issues** - Avoid duplicates
4. **Test with Claude Code** - Verify your contributions work

## Types of Contributions

### Prompt Templates
- New component templates for `beginner/prompts/`
- Improved specificity and modern patterns
- Before/after examples with exact prompts

### Design System Templates
- CLAUDE.md templates for different use cases
- Color schemes, typography, spacing systems
- Component library integrations

### Plugins
- New skills, agents, or commands
- Improvements to existing plugins
- Documentation and examples

### Documentation
- Workflow guides and tutorials
- Troubleshooting solutions
- Case studies and examples

## Contribution Process

### 1. Issues First
For significant changes, create an issue first:
- Use the appropriate template
- Describe the problem you're solving
- Propose your solution

### 2. Pull Requests
- Fork and create a feature branch
- Follow existing file structure
- Test everything with Claude Code
- Include usage examples

### 3. Quality Standards

**For Templates:**
- [ ] Uses modern design patterns (2024+)
- [ ] Includes responsive breakpoints
- [ ] Has hover/focus/active states
- [ ] Follows accessibility guidelines
- [ ] Works with Tailwind CSS

**For Documentation:**
- [ ] Follows voice guide
- [ ] Includes practical examples
- [ ] Explains "why" not just "what"
- [ ] Copy-paste ready code

## What We Accept

- ✅ Modern UI patterns and techniques
- ✅ Working, tested examples
- ✅ Accessibility improvements
- ✅ Clear documentation
- ✅ Tool integrations

## What We Don't Accept

- ❌ Untested templates
- ❌ Outdated design patterns
- ❌ Low-quality or spammy content
- ❌ Content violating our Code of Conduct

## Recognition

Quality contributors will be:
- Acknowledged in release notes
- Listed in CONTRIBUTORS.md
- Invited to maintain specific areas

---

**Questions?** Open a discussion or issue. We're here to help.

*The craft grows when knowledge flows.*
