Skip to content

Commit 8ed4d32

Browse files
authored
Merge pull request #91 from GitGud-org/readme-style-update
Readme style update
2 parents a3c4b51 + 7bb9a2f commit 8ed4d32

File tree

3 files changed

+43
-2
lines changed

3 files changed

+43
-2
lines changed

media/styleFile.png

90 KB
Loading

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "gitgud",
3-
"version": "2.0.0",
3+
"version": "2.1.0",
44
"description": "A CLI git tool",
55
"license": "MIT",
66
"bin": "cli.js",

readme.md

Lines changed: 42 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@
1515
## **Requirements**
1616
- Have at least **git version 2.24.3** installed
1717
- 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+
1820

1921
---
2022

@@ -36,6 +38,7 @@ $ GitGud
3638
- Navigate through the UI with either the 'tab' button or left/right arrow keys
3739
- Press 'enter/return' button to select/click an option
3840
- Throughout the app you can hit the 'esc'(escape) button to go back
41+
- You can exit the app by running ctrl + c
3942

4043
---
4144
## **Functionality**
@@ -61,11 +64,49 @@ $ GitGud
6164
* ### **Access Full Log Tree**
6265
- It will render the entire log tree overlaying the gitgud GUI.
6366
- 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).
83+
84+
When you open the file it will look like this:
85+
86+
<img width="1000" alt="styleFile" src="media/styleFile.png">
87+
88+
* ### **`showLogo`:**
89+
- 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+
---
65104
### **Contributing**
66105
GitGud is a fully open source project and contributions are welcome!
67106

68107
When submitting a pull request, please clearly explain the feature you added or the bug you fixed.
69108

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+
70111

71112
Thanks to [`Joseph Garrone`](https://github.com/JosephGarrone) for giving us the NPM package name.

0 commit comments

Comments
 (0)