Skip to content

Latest commit

 

History

History
149 lines (117 loc) · 5.59 KB

CONTRIBUTING.md

File metadata and controls

149 lines (117 loc) · 5.59 KB
Raw

Contributing to DogeHouse

We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:

  • Reporting an issue
  • Discussing the current state of the code
  • Submitting a fix
  • Proposing new features
  • Becoming a maintainer

Code of Conduct

The code of conduct is described in CODE_OF_CONDUCT.md.

Our Development Process

All changes happen through pull requests. Pull requests are the best way to propose changes. We actively welcome your pull requests and invite you to submit pull requests directly here, and after review, these can be merged into the project.

Using the Project's Standard Commit Messages

This project is using the conventional commits standard. Please follow these steps to ensure your commit messages are standardized:

  1. Make sure your shell path is in the root of the project (not inside any of the packages).
  2. Run npm i.
  3. Stage the files you are commiting with git add [files].
  4. Run npm run commit. This will start an interactive prompt that generates your commit message:
    1. Select the type of change.
    2. Type the scope. This is either global for project-wide changes or one of the packages (kibbeh, shawarma etc.).
    3. Write a short, imperative tense description of the change.
    4. If the above was not sufficient, you may now write a longer description of your change (otherwise press enter to leave blank).
    5. y or n for wheather there are any breaking changes (e.g. changing the props of a component, changing the JSON structure of an API response).
    6. y or n for wheather this change affects and open issue, if positive you will be prompted to enter the issue number.
  5. Your commit message has now been created, you may push to your fork and open a pull request (read below for further instructions).

Pull Requests

  1. Fork the repo and create your branch (usually named patch-%the number of PRs you've already made%) from staging.
  2. If you've added code that should be tested, add some test examples.
  3. Ensure to describe your pull request.

Quickstart Local Frontend Development

Do this if you only want to do React stuff and don't want to touch Elixir:

Navigate to /kofta

  • Run npm i
  • Run npm run start:staging (this tells React to connect to a hosted version of the backend for development purposes)

Full Local Development

How to run locally:

Backend

RabbitMQ

Install RabbitMQ:

  • macOS: Run brew install rabbitmq.
  • Windows: Run choco install rabbitmq.
  • Linux: Follow their installation guide here.

Start RabbitMQ

  • macOS: Run brew services start rabbitmq.
  • Windows: Setup guide here.
  • Linux: Setup guide here.

PostgreSQL

Install PostgreSQL:

  • macOS: Run brew install postgresql.
  • Windows: Follow this guide.
  • Linux: Follow this guide.

Start PostgreSQL:

  • macOS: Run brew services start postgresql.
  • Windows: Start PostgreSQL through the control panel or run net start postgresql-{version}.
  • Linux: Run /etc/rc.d/init.d/postgresql start.

Create a DB named kousa_repo2:

$ psql postgres

$ CREATE DATABASE kousa_repo2;

Elixir

Elixir installation guide here.

kousa

Navigate to /kousa and set the following environment variables:

export DATABASE_URL=postgres://user:password@localhost/kousa_repo2
export BEN_GITHUB_ID=7872329
export RABBITMQ_URL=amqp://user:password@yourinternalip:5672
export ACCESS_TOKEN_SECRET=
export REFRESH_TOKEN_SECRET=
export GITHUB_CLIENT_ID=
export TWITTER_API_KEY=
export TWITTER_SECRET_KEY=
export TWITTER_BEARER_TOKEN=
export GITHUB_CLIENT_SECRET=
export SENTRY_DNS=
export API_URL=http://localhost:4001
export WEB_URL=http://localhost:3000
export PORT=4001

You can save these variables in a .txt and run source path/to/file.txt

Run the following commands:

$ mix deps.get
$ mix ecto.migrate

Start the server

$ iex -S mix

shawarma

Navigate to /shawarma and run npm i.

Mediasoup requires node >=0.8 <=14 and has specific requirements on Windows.

Create an .env file and set the following environment variable:

WEBRTC_LISTEN_IP=127.0.0.1

Then run npm run build and npm start.

Frontend

kofta

Navigate to /kofta and create an .env file based on .env.example.

Run npm i and then npm start.

Issues

We use GitHub issues to track public bugs. Please ensure your description is clear and has sufficient instructions to be able to reproduce the issue. Report a bug by opening a new issue; it's that easy!

Frequently Asked Questions (FAQs)

- Q: [The Question?]
- A: [The Answer!]

Feature Request

Great Feature Requests tend to have:

  • A quick idea summary.
  • What & why you wanted to add the specific feature.
  • Additional context like images, links to resources to implement the feature etc, etc.

License

By contributing to DogeHouse, you agree that your contributions will be licensed under the LICENSE file.