Fork & Clone
Fork the repository on GitHub and clone it to your local machine. Create a descriptive branch for your contribution — e.g. feat/improved-swipe-animation or fix/watchlist-sort-bug.
Open SourceBuild CineMatch
Build CineMatch
With Us
CineMatch is built by movie lovers, for movie lovers. We welcome contributions from developers, designers, film critics, and anyone passionate about improving how people discover cinema.
How to ContributeThree Steps to Your
Three Steps to Your
First Pull Request
Pick an Issue
Browse our open issues on GitHub. Look for tags like "good first issue" for beginner-friendly tasks, or "help wanted" for features where we actively need contributions. Comment to claim an issue before starting.
Submit a Pull Request
Open a pull request with a clear title, description of your changes, and screenshots or screen recordings where relevant. Reference any related issues with "Closes #123". Our team reviews all PRs within 5 working days.
Ways to HelpYou Don‘t Have to
You Don‘t Have to
Code to Contribute
Frontend Development
Build new features, improve performance, or fix UI bugs. We use Next.js 16, React 19, and CSS Modules.
Backend & AI
Work on our recommendation engine, API performance, or data pipeline. Python, Node.js, and PostgreSQL.
Bug Reports
Found something broken? File a detailed bug report with steps to reproduce. Clear reports are contributions too.
Design
Help improve our UI/UX with Figma mockups, accessibility improvements, or animation ideas.
Film Curation
Suggest films missing from our catalogue, improve metadata accuracy, or write editorial descriptions.
Documentation
Improve our developer docs, write tutorials, or translate existing documentation into other languages.
Testing & QA
Write unit tests, improve test coverage, or manually test new features across devices and browsers.
Community Support
Help other users in our Discord, answer GitHub discussions, or moderate community film lists.