A modern platform to discover and track "good first issues" in open source projects.
mAfi (Me And First Issue) is a web application designed to help developers find their first open source contributions. It aggregates "good first issues" from GitHub repositories, making it easier for newcomers to start their open source journey.
- 🔍 Browse through curated "good first issues"
- ⭐ Save favorite issues for later
- 🏷️ Filter issues by labels and difficulty
- 🎯 Real-time GitHub integration
- 📱 Responsive design for all devices
- React 18
- TypeScript
- Vite
- TailwindCSS
- React Query
- React Router
- GitHub API
- Lucide Icons
- Node.js (v16 or higher)
- npm or yarn
- Git
- Clone the repository:
git clone https://github.com/yourusername/mafi.git
cd mafi- Install dependencies:
npm install
# or
yarn install- Create a
.envfile in the root directory:
GITHUB_TOKEN=your_github_token_here- Start the development server:
npm run dev
# or
yarn devThe application will be available at http://localhost:5173
We welcome contributions from everyone! Here's how you can help:
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
- Follow the existing code style and conventions
- Write meaningful commit messages
- Update documentation as needed
- Add comments for complex logic
- Test your changes thoroughly
Please read our Code of Conduct before contributing to the project.
This project is licensed under the MIT License - see the LICENSE file for details.
- Thanks to all contributors who help improve mAfi
- GitHub API for making this possible
- The open source community for inspiration
Made with ❤️ for the open source community