Skip to content

Latest commit

 

History

History
96 lines (64 loc) · 2.3 KB

CONTRIBUTION.md

File metadata and controls

96 lines (64 loc) · 2.3 KB

CONTRIBUTING

When contributing to this repository, please first discuss the change you wish to make via issues.

Please note if you are working on a certain issue then make sure to stay active with development.

Git Commit, Branch, and PR Naming Conventions

When you are working with git, please be sure to follow the conventions below on your pull requests, branches, and commits:

PR: #[ISSUE ID] Title of the PR
Branch: [ISSUE ID]-title-of-the-pr (shorter)
Commit: [[ISSUE ID]] [ACTION]: what was done

Examples:

PR: #2 Add a new feature / layer
Branch: 2-add-new-layer
Commit: [2] feat: add new layer

Installation

To get started with Projectify locally, follow these steps

  1. Fork the repo

  2. Clone your fork

     git clone https://github.com/<YOUR_GITHUB_ACCOUNT_NAME>/projectify.git
  3. Navigate to the project directory

    cd projectify
  4. Create a .env file inside the project's root directory.

  5. Copy and paste variables from .env.example into .env

  6. Install NPM packages

    npm i
  7. Start the app dev server

    npm run dev
  8. Start the convex backend

    npm run convex dev
  9. Open your browser and visit http://localhost:3000 to see the application running.

Working on New Features

If you're new to Github and working with open source repositories, Cody made a video a while back which walks you through the process: How to make a pull request on an open source project

There is also a new video explaining how you can contribute to this project:
How to contribute to open source projects (our community project walkthrough)

If you want to work on a new feature, follow these steps.

  1. Fork the repo
  2. Clone your fork
  3. Checkout a new branch
  4. Do your work
  5. Commit
  6. Push your branch to your fork
  7. Go into github UI and create a PR from your fork & branch, and merge it into upstream MAIN

Pulling in changes from upstream

You should pull in the changes that we add in daily, preferably before you checkout a new branch to do new work.

git checkout main
git pull upstream main