You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: readme.md
+42-1Lines changed: 42 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -15,6 +15,8 @@
15
15
## **Requirements**
16
16
- Have at least **git version 2.24.3** installed
17
17
- Have [npm](https://www.npmjs.com/get-npm) installed
18
+
- We do not recommend using [iTerm2](https://iterm2.com/) for GitGud due to rendering issues. [Hyper](https://hyper.is/) or the default terminal are good alternatives.
19
+
18
20
19
21
---
20
22
@@ -36,6 +38,7 @@ $ GitGud
36
38
- Navigate through the UI with either the 'tab' button or left/right arrow keys
37
39
- Press 'enter/return' button to select/click an option
38
40
- Throughout the app you can hit the 'esc'(escape) button to go back
41
+
- You can exit the app by running ctrl + c
39
42
40
43
---
41
44
## **Functionality**
@@ -61,11 +64,49 @@ $ GitGud
61
64
*### **Access Full Log Tree**
62
65
- It will render the entire log tree overlaying the gitgud GUI.
63
66
- Press 'ESC' to exit out of log tree
64
-
### **FAQ**
67
+
68
+
---
69
+
## **Styling**
70
+
Gitgud allows users to customize both the look and feel of the app by editing the 'stylefile.'
71
+
72
+
To access the 'stylefile' of a globally installed GitGud, you will first need to find out where NPM is saving your globally installed files. To do so, run the following command:
73
+
```
74
+
npm root -g
75
+
```
76
+
This will return the location of your globally installed NPM packages.
77
+
78
+
On Mac you should see something like this: */usr/local/lib/node_modules*
79
+
80
+
On Windows, you may get this: *C:\Users\YOU\AppData\Roaming\npm\node_modules
81
+
82
+
Navigate to where your global packages are stored, open the gitgud folder, and then open the styleFile in an editor (the command: `nano styleFile.js` will open it in most mac/linux systems).
- By default this is set to `false`, but if you want to have the GitGud logo on top of your GUI you can change this to `true`.
90
+
91
+
*### **`defaultColor`:**
92
+
- This is the color for the main text blocks throughout the app.
93
+
94
+
*### **`accentColor`:**
95
+
- This is the color for the app borders as well as some text headers throughout the app.
96
+
97
+
*### **`appResize`:**
98
+
- This enables the app to be responsive, allowing users to resize their console windows without having to restart the app. This may decrease performance for some users.
99
+
100
+
---
101
+
102
+
### **FAQs**
103
+
---
65
104
### **Contributing**
66
105
GitGud is a fully open source project and contributions are welcome!
67
106
68
107
When submitting a pull request, please clearly explain the feature you added or the bug you fixed.
69
108
109
+
First-time contributors are welcome as well! There are some issues marked with the `good first issue` tag. These might be a good place for beginners to start!
110
+
70
111
71
112
Thanks to [`Joseph Garrone`](https://github.com/JosephGarrone) for giving us the NPM package name.
0 commit comments