# Contributing to Studio CRM

Thank you for your interest in contributing to Studio CRM! 🎉

We welcome contributions from the community and are grateful for any help you can provide.

## 🐛 Found a Bug?

1. **Check existing issues**: Search [GitHub Issues](https://github.com/Poli-International/studio-crm/issues) to see if it's already reported
2. **Create a new issue** if it hasn't been reported:
   - Use a clear, descriptive title
   - Describe the steps to reproduce
   - Include expected vs actual behavior
   - Add screenshots if applicable
   - Mention your environment (OS, PHP version, Laravel version)

## 💡 Have an Idea or Feature Request?

1. **Start a discussion**: Open a [GitHub Discussion](https://github.com/Poli-International/studio-crm/discussions) first
2. **Explain your idea**: Describe the feature and why it would be useful
3. **Get feedback**: We'll discuss feasibility and implementation

## 🔧 Want to Contribute Code?

### Getting Started

1. **Fork the repository**
2. **Clone your fork**:

   ```bash
   git clone https://github.com/YOUR-USERNAME/studio-crm.git
   cd studio-crm
   ```

3. **Create a feature branch**:

   ```bash
   git checkout -b feature/your-feature-name
   ```

### Development Guidelines

- **Follow Laravel conventions**: Use Laravel best practices and coding standards
- **Write clean code**: Keep functions small and focused
- **Comment complex logic**: Help others understand your code
- **Test your changes**: Ensure everything works before submitting
- **Update documentation**: If you change functionality, update the README

### Submitting Changes

1. **Commit your changes**:

   ```bash
   git add .
   git commit -m "feat: Add your feature description"
   ```

   Use conventional commit messages:
   - `feat:` for new features
   - `fix:` for bug fixes
   - `docs:` for documentation
   - `style:` for formatting
   - `refactor:` for code restructuring
   - `test:` for adding tests

2. **Push to your fork**:

   ```bash
   git push origin feature/your-feature-name
   ```

3. **Create a Pull Request**:
   - Go to the original repository
   - Click "New Pull Request"
   - Select your fork and branch
   - Provide a clear description of your changes
   - Link any related issues

### Code Review Process

- We'll review your PR as soon as possible
- We may request changes or improvements
- Once approved, we'll merge your contribution
- You'll be credited in the release notes!

## 📖 Documentation

Help improve our documentation:

- Fix typos or unclear explanations
- Add examples or use cases
- Improve installation instructions
- Translate documentation (future)

## 🎨 Design Contributions

- UI/UX improvements
- Icon suggestions
- Color scheme enhancements
- Accessibility improvements

## 🌍 Community

- Help answer questions in [Discussions](https://github.com/Poli-International/studio-crm/discussions)
- Share your Studio CRM setup or customizations
- Report security vulnerabilities privately to [patrick@poli-international.com](mailto:patrick@poli-international.com)

## 📧 Questions?

If you have questions about contributing:

- **Email**: [patrick@poli-international.com](mailto:patrick@poli-international.com)
- **Discussions**: [GitHub Discussions](https://github.com/Poli-International/studio-crm/discussions)

## 🙏 Thank You

Every contribution, no matter how small, helps make Studio CRM better for everyone in the tattoo and piercing community.

---

**Happy Contributing!** 🚀

*Built with ❤️ by [Poli International](https://poliinternational.com)*
