-
Notifications
You must be signed in to change notification settings - Fork 1.5k
How to contribute to this project
For this, you just need to install git on your system.
Open one of the following based on your operating system.
Install git on Windows
-
First, go here and download the Windows version.
-
Then unzip the downloaded file and install it.
-
Then follow the installation wizard to the end with
Next
andYes
. It is recommended not to change the default settings. -
By default, the installation location of
git
is in this path.
C:/Program Files/Git
-
It means that in the next stages, the projects will be placed in this direction. The work is done.
-
To check the version of
git
installed, opencommand prompt
and run the following command.
git version
- By default,
git
is installed in the user'sHome
folder.
Install git on Mac
- First, go here and download the Mac version.
- Then run it. It has a very simple installation.
- After installation, to check the installed
git
version, open the terminal and run the following command.
git version
Install git on Linux
In most distributions of the Linux operating system, git is installed by default and you do not need to do anything special. But if you need to install it for any reason, you should search and find the appropriate command for that distribution. Next is the installation command related to the famous Ned distribution.
Debian/Ubuntu
sudo apt-get install git-all
Fedora
dnf install git-all
Arch
pacman -Syu git-all
In all distributions, git is installed in the Home
path of the user.
- Run this command to check the version of git installed in the terminal.
git version
- First you need to
fork
the project. For this, if you intend tofork
the project, execute the following command.
git clone https://github.com/hiddify/hiddify-next.git
- Wait a while for the project files to be copied.
- Now you have to create a branch of the project to work on it. To do this, first choose a name for the branch. For example, suppose we choose the branch name
Hiddify-develop
. Now run the following commands.
git branch Hiddify-develop
git checkout Hiddify-develop
- Now apply your desired changes to the files using any tool. It is recommended to use
VSCode
. - Do not forget that the path of all the files in the mentioned folders is in the installation stage.
- Now, when you have applied your desired changes, you must also register the changes in
git
. Therefore, run the following commands in the terminal in order. - First, announce the changes to
git
with the following command.
git add
- Then commit the changes. You need to provide an explanation for the changes here.
git commit -m "a short description of the change"
For example, if the changes you are looking for are related to the core department, you can write such an explanation.
git commit -m "add some features to the core"
There is no problem if the explanations of this section are many, and by the way, it is recommended that the explanations be as complete and comprehensive as possible.
At this point, the changes have been successfully imported into the git
system. Now you need to push the changes to GitHub
. To do this, run the following command.
git push
Here, your GitHub account details will be asked. You need to enter your username
and password
on GitHub.
- Now log in to your GitHub account and open the forked project. It has a path as follows:
https://github.com/<your_username>/hiddify-next
- Now you will see a
banner
that informs you that yourbranch
is one step ahead of the main project. Tomerge
the changes with the main project, clickContribute
andOpen a pull request
. - It's done, the changes have been sent to the project. Now, after the approval of the project manager, your changes will be added to the project.
The app is developed using Flutter and Go. For more information you can read through our Contribution Guidelines for development.