# Contributing to SupplyWave

Thank you for your interest in improving SupplyWave! We welcome contributions of all kinds.

## How to Contribute

### 1. Fork & Clone
```bash
git clone https://github.com/Raphasha27/SupplyWaveSA.git
cd SupplyWaveSA
```

### 2. Create a Feature Branch
```bash
git checkout -b feat/your-feature-name
```

### 3. Make Changes & Commit
Follow the commit message format:
```
feat: short description of the feature
fix: short description of the bug fix
chore: maintenance or tooling changes
```

### 4. Push & Open a PR
```bash
git push origin feat/your-feature-name
```
Then open a Pull Request against the `main` branch.

## Development Setup

### Backend
```bash
cd backend/app
pip install -r ../requirements.txt
uvicorn main:app --reload
```

### Admin Dashboard
```bash
cd frontend/apps/admin
npm install && npm run dev
```

### Flutter Apps
```bash
cd supplywave && flutter pub get
```

## Code Standards
- **Python**: Follow PEP 8. Use `async/await` for all I/O.
- **TypeScript**: No implicit `any`. Use explicit types.
- **Dart/Flutter**: Follow Flutter style guide. Use Riverpod for state.

## Reporting Issues
Use [GitHub Issues](https://github.com/Raphasha27/SupplyWaveSA/issues) with a clear title and reproduction steps.