Contributing Using VS Code¶
Install VS Code¶
Fork Project in Github¶
This is making a duplicate of the code under your Github that you can edit.
Add your (forked) repo to VS Code¶
Login to your Github.
Choose local folder.
Install extra VS Code Extensions¶
Remote - SSH
Configure a remote for your fork (in VS Code)¶
Configure your local fork and tell it where the original code repo is so you can compare and merge updates later when official repo is updated.
git remote -v
Add upstream repo:
git remote add upstream https://github.com/amidaware/tacticalrmm
git remote -v
Make changes to something.
Commit(update something) and notate what you did.
Push(from your local VS Code to your github fork).
Open your browser and look at your repo (It should reflect your commit).
Request your changes to be pulled into the primary repo (Pull Request)¶
In your browser, create a pull request.
Sync your local fork¶
Bring changes from original repo to your local VS Code copy so you're current with changes made in original Github repo:
In VS Code open TERMINAL:
Tell git to pull from the GitHub upstream repo all new changes into your local directory:
git pull --rebase upstream develop
Push your local updated copy to your Github fork¶
pushing that updated local repo to your online Github fork:
Verify and Repeat¶
Check your Github fork in browser, it should be up to date now with original. Repeat 6 or 7 as necessary.
Customizing the Admin Web Interface¶
Created using Quasar, it's all your .vue files in
Learn stuff here: