Contributions are welcome and will be fully credited.
Please read and understand the contribution guide before creating an issue or pull request.
How to get started
Hey there! You're probably here because you want to help out. Thanks for joining us!
In this document we'll try to outline how to get started contributing to Onramp, and how to perform common tasks, like keeping your local fork of Onramp up to date.
Set up your own fork of the repository
In order to contribute you'll want to make a "fork" of this repository.
fork button at https://github.com/tightenco/onramp and wait for it to complete.
Once the fork is done, clone your fork to your computer by navigating to a folder you'd like to put the site in, and then replacing
[username] in this snippet with your GitHub username and running it from the terminal:
git clone firstname.lastname@example.org:[username]/onramp.git
In order to keep your fork up-to-date with the original repository, you'll also want to add an extra git "remote" that points to the original repo.
Your fork will already be connected to your local repo as the remote named
Let's add your link to the original Tighten repo by running the following command after navigating to the
onramp folder in your local repo:
git remote add upstream email@example.com:tightenco/onramp
This added a remote named
upstream that points to Tighten's repo.
You can fetch the upstream branches by running the following command:
git fetch upstream --prune
Now you have this set up, run the following commands to install the dependencies:
composer install npm install
Check that the
.env file exists; if not, copy the
cp .env.example .env
Each Laravel application needs an unique application key, which can be generated by running the following command:
php artisan key:generate
Set up the database, and run the migrations and seeders
Next, edit the
.env file and fill the
DB_ variables with your correct database configuration details.
If you haven't yet created a database, create a new MySQL database (likely named
onramp, but you can customize this in
Now, migrate and seed the database:
php artisan migrate:fresh --seed
If prompted, choose that it's a
How to perform common tasks
Keep your fork up to date
Using the git remote we set up earlier, we first need to fetch changes that were made upstream:
git fetch upstream --prune
Next, change to your local master branch:
git checkout master
And merge the changes that were made upstream into your local branch.
git merge upstream/master --no-ff
Prepare your pull request
Before actually creating a pull request, you have the chance to clean up your code. Remove debug statements, clean up commented code and refactor if needed.
Look to this blog post for how to write a good git commit message.
Create a pull request
When you have your changes ready in your own branch on your fork, it's time to create a pull request. Try to describe what kind of changes you have made and why you have made them. This helps us in understanding why you are suggesting this change and what your reasoning behind it is.
Look to this blog post for how to create a great pull request.
How to contribute to Onramp
Do you have content you can add?
- You can add an issue referencing the content you'd like to add
Do you want to code on the app itself?
- Open or comment on an issue before starting to code to ensure @mattstauffer (or someone else) isn't already working on it and that you fully understand the goals and scope
- Once ready to code, fork the repo, and PR your changes in, referencing the original issue number
Do you want to help translate Onramp?
- Please check out the translation guide.
Do you have questions about the plans for Onramp?
- Ask any question about how to contribute to or use Onramp in the issues here