CONTRIBUTING GUIDELINES.
Every contribution matters. Whether you're submitting bug fixes, adding new repo scrapers, or refining UI components.
1. The OpenSourceHub Git Flow
Fork & Clone
Fork the repository on GitHub and clone your fork locally. Run npm install.
Create a Feature Branch
Create a branch named after the issue: git checkout -b fix/issue-number.
Implement & Test
Write clean TypeScript code, follow existing UI patterns, and run npm test and npm run build to ensure zero type errors.
2. Design & Engineering Standards
OpenSourceHub follows a clean, modern developer aesthetic designed for high signal and effortless readability:
Clean surfaces (#FCFCFD / #090D16) and hairline borders (border-slate-200 / 800).
Deep Slate-950 / White text with curated Emerald (#10B981) and Indigo accents.
Plus Jakarta Sans for display headings and Space Mono for metrics, code snippets, and badges.
Fully responsive, keyboard-navigable components compliant with WCAG AA standards.
3. Pull Request Checklist
feat:, fix:, docs:.Join our Builder Community
Explore the team on GitHub and review contribution instructions for the repository you want to help with. Joining the Hub directory is separate from submitting a pull request.