Metadocumentation
clone
clonemasteropen-collectiveredirect
clone
clonemasteropen-collectiveredirect
  • Welcome
  • About
    • Company
    • Pricing
    • Community Guidelines
    • Team
    • Investors
    • Contributing
    • Terminology
  • The Open Collective Way
    • Values
    • Community Guidelines
    • Core Contributors Guidelines
    • Core Contributors: Communication
    • Core Contributors: Expenses
    • Core contributors: Leave
    • Core Contributors: Compensation
  • Product
    • Roadmap
    • Comparison
    • User Profile
    • Currencies
    • Log-in System
  • Collectives
    • Creating a Collective
    • Quick Start Guide
    • Customize Collective
    • Change Core Contributors
    • Tiers & Goals
    • Add Fiscal Host
    • Change Fiscal Host
    • Transparent Budget
    • Expense Policy
    • Approving Expenses
    • Updates & Comms
    • Events
    • Funding Options
    • Data Export
    • Buttons & Banners
    • Integrations
    • Zero Collective Balance
    • Closing a Collective
  • Backers & Sponsors
    • Sponsor FAQ
    • Payments
    • Collective to Collective donations
    • Organizations
    • Gift Cards
    • Bulk Transfers
    • Website Badge
    • Sustainer Resources
  • Expenses & Getting Paid
    • Submitting Expenses
    • Expense Comments
    • Edit an Expense
    • Tax Information
  • Fiscal Hosts
    • Becoming a Fiscal Host
    • Create a Fiscal Host
    • Fiscal Host Settings
    • Invoices
    • Payouts
    • Host Dashboard
    • Add Funds Manually
    • Refunds
    • Host Fees
    • Local Tax Support
    • Agreement Templates
    • Open Source Collective
  • Developers
    • Contribution Guide
    • Best Practice Guidelines
    • Bounties
    • API
      • Members
      • Users / Emails
      • Collectives
      • Events
    • README Integration
    • Architecture
    • Postgres Database
    • PayPal
    • Post-Donation Redirect
    • Custom Tweets
    • Manual Reporting
    • Github Permissions
    • Translations
    • Testing with Cypress
    • Collective's locations
  • Internal
    • Team Retreats
    • Brussels Summer Team Retreat
    • Host Admin Manual
    • Newsletter
    • Support
    • Issue Labels
    • DNS Troubleshooting
    • Developer Guidelines
    • Architecture
    • Testing
    • Queries
      • Gift Cards
      • Transactions
      • Ops
      • Collectives
      • Hosts
      • Analytics
      • Emails
    • Style Guide
  • Projects
    • Maintainerati Berlin 2019
    • Season of Docs 2019
  • Design
    • Design Workflow
    • Design Contribution Guidelines
  • Translators
  • Contributing
    • Documentation
      • Style guide
      • Suggesting changes
Powered by GitBook
On this page
  • Technical Requirements
  • Project Structure
  • Project Setup
  • Frontend
  • API
  • Others
  • Design Contribution
  • Commit conventions
  • Bounty Program
  • Ask for Help
  1. Developers

Contribution Guide

We're happy to have you contributing to our codebase! We recommend you go through the following guide.

Technical Requirements

You'll need to have some basic programming experience with the technologies and tools we use.

Tools

  • Git & Github - clone, commit, open a PR using Git with GitHub. Check out the following tutorials:

    • Introduction to git

    • Introduction to GitHub

    • Popular git commands and how to use them

    • Git commands in depth

    • Mastering Markdown

    • Markdown Tutorial

Languages & Frameworks

  • JavaScript/Nodejs - We recommend having basic experience working with Node, which Open Collective is written in (frontend & backend). Check out these free JavaScript & Node tutorials:

    • Javascript

      • Introduction to basic principles of Javascript

      • Introduction to Javascript - w/ Advanced concepts

      • An interactive Javascript tutorial

    • Nodejs

      • Quick introduction to Nodejs

      • Introduction to Nodejs - w/ quizzes

      • When, how and why to use Nodejs

      • Differences between Javascript and Nodejs

  • GraphQL - Our API uses GraphQL, powered by Sequelize and PostgreSQL. Understanding how these work is important to contributing to or fixing the majority of the issues on our API. To learn more, check out these tutorials & articles:

    • What is GraphQL and how to use it

    • Basic concept of GraphQL

    • Getting GraphQL running

    • Practical GraphQL tutorial

  • React & Nextjs - You'll need to understand React and Nextjs to contribute to issues on the frontend. Check out the following links:

    • React

      • Basic React Concepts

      • The Beginner react roadmap - path to mastering react

      • React Official documentation

    • Nextjs

      • Basic introduction to Nextjs

      • Nextjs Official Documentation

      • Basic concepts in Nextjs

      • Introduction to Nextjs - w/ Advanced concepts

Project Structure

The project's core repositories are divided into three:

  • opencollective/opencollective - Here is where we manage issues and community discussions. Our issues are all labelled with a complexity label. We recommend starting with simple issues ( complexity -> simple).

  • opencollective/opencollective-frontend - This repository contains our frontend code. You can find more information in the setup section of this guide.

  • opencollective/opencollective-api - This contains our API code. If you enjoy working on the backend, you can set up our API locally. To learn about setting it up, check out the setup section below.

Project Setup

This section explains how you can get Open Collective running locally on your computer.

Frontend

Setting up the frontend is straightforward. We've provided a comprehensive guide in a seperate document that explains how to set up the project.

Setup guide

https://github.com/opencollective/opencollective-frontend/blob/master/README.md

NOTE: If you're only contributing frontend code, you don't need to setup the API.

API

The API setup requires more effort than the frontend, as it requires installing the PostgreSQL and PostGIS extensions. You might experience difficulty setting up the API on a Windows environment. We recommend using a Unix environment. (We're currently working to make it easier on Windows).

Just like the frontend, we have a seperate document for the setup.

Setup guide

https://github.com/opencollective/opencollective-api/blob/master/README.md

Others

Design Contribution

Like to contribute to our design? Checkout our design contribution guidelines.

Commit conventions

Before you make your first commit, read through our commit convention, provided in the link below:

https://github.com/opencollective/opencollective-frontend/blob/master/CONTRIBUTING.md

Bounty Program

We recommend you learn more about our bounty program through the link below:

https://docs.opencollective.com/help/developers/bounties

Ask for Help

If you stuck or you have a question, join our slack #engineering channel through the link below:

https://slack.opencollective.com/

We're trying our best to make our documentation better. We encourage you to give suggestions on how we can improve it.

PreviousDevelopersNextBest Practice Guidelines

Last updated 5 years ago