Welcome
OpenSource Together helps people find open-source projects worth contributing to, and helps maintainers find contributors. This site is the documentation for the people building it: you.Run the app in two commands
No database, no Docker, no API keys. Really.
What’s open source
Web App
Open source. Contribute here. Next.js, React and TypeScript: project discovery,
profiles, dashboard, and the Learn knowledge base.
API
Closed source. A private service. You don’t need it: its contract is fully documented
and mocked locally.
AI Engine
The data and machine-learning pipeline that collects and ranks project data. Separate
repository.
So how do you build anything without the API? The repository ships a local mock of it,
with realistic seed data. Every screen works offline. Signing in is the one exception:
instead of OAuth, a toggle switches you between signed in and signed out. See the
Mock API guide.
Start contributing
Get the app running
Clone, install, and start in under five minutes
How to contribute
Branches, commits, pull requests, and what CI checks
Understand the codebase
Feature-based architecture, the data layer, and conventions
Write a Learn chapter
Contribute content instead of code, with no TypeScript required
Join the community
GitHub
Browse issues and open a pull request
Discord
Ask questions and meet the team
𝕏
Follow along with what we ship