Thank you for your interest in contributing to MediTrack! This document provides guidelines for contributing to the project.
- Fork the repository
- Create a branch for your feature (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- Follow modern TypeScript and React conventions
- Use functional components and hooks
- Adhere to the project's folder structure
- React Components: PascalCase (e.g.,
Button.tsx) - Hooks: camelCase with "use" prefix (e.g.,
useAuth.ts) - Utilities: camelCase (e.g.,
dateUtils.ts) - Constants: UPPER_SNAKE_CASE for global constants
Place new components in the appropriate location according to these rules:
- If the component is used in a single feature → place it in that feature
- If the component is used across multiple features → place it in
src/components - For basic UI components → place them in
src/components/ui
- Write unit tests for all new components
- Place tests next to the files they test
- Run all tests before submitting a PR
- Use clear and descriptive commit messages
- Reference issues in the commit messages when applicable
- Update documentation when you add or modify features
- Document APIs for new reusable components
Thank you for contributing to MediTrack!