Skip to content

Commit 2d1da28

Browse files
committed
update readme
1 parent 510747d commit 2d1da28

File tree

3 files changed

+122
-27
lines changed

3 files changed

+122
-27
lines changed

README.md

+120-25
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,130 @@
1-
# LithiumGit
1+
# 🚀 LithiumGit
22

3-
**Download and install latest version from [releases](https://github.com/TulshiDas39/LithiumGit/releases)..**
3+
![GitHub release (latest by date)](https://img.shields.io/github/v/release/tulshidas39/lithiumgit)
44

5-
This is a cross platform Git GUI application.
65

7-
# Architecture
6+
**LithiumGit** is an advanced desktop application designed to simplify and supercharge your Git workflow. Whether you're a seasoned Git user or just getting started, Lithium Git Client provides you with a seamless, feature-rich, and customizable experience while managing your repositories.
87

9-
common_library: This is a local npm package which is used in both backend and ui. Functions,classes,types etc needed both in backend and ui are exported from here.
8+
---
109

11-
ui: This is a react app built with create-react-app template. This is the application ui.
10+
## ✨ Key Features
1211

13-
# Steps to run
14-
15-
build and install the common library:
16-
-navigate to common_library folder and run "npm run build"
17-
18-
run the ui:
19-
-navigate to ui folder and run "npm start"
12+
- **🌟 User-Friendly Interface**: Manage your repositories with ease using our intuitive GUI. No more memorizing complex Git commands – it's all here at your fingertips!
2013

21-
run the backend:
22-
-open ./src/config.ts file
23-
-ensure static readonly ENV:'development'|'production' = 'development';
24-
-npm start
14+
- **⚙️ Advanced Git Operations**: Perform even the most complex Git tasks effortlessly. From branching to cherry-picking, we've got you covered.
15+
16+
- **📈 Interactive Graph View**: Visualize the history and structure of your repositories with a sophisticated graph view.
17+
![Graph View](https://lithiumgit.github.io/_next/static/media/graph.e4449400.png)
18+
19+
- **💻 Cross-Platform Support**: Lithium Git Client works everywhere you code: Windows, macOS, and Linux.
20+
21+
- **⚡ Customizable Workflows**: Tailor the application to fit your unique development needs. Customize shortcuts, automate repetitive tasks, and more!
22+
23+
---
24+
25+
## 🛠️ Installation
26+
27+
Follow these steps to install LithiumGit Client on your machine:
28+
29+
### Windows
30+
1. Download the latest release for Windows from the [Releases Page](https://github.com/tulshidas39/lithiumgit/releases).
31+
2. Run the installer and follow the on-screen instructions.
32+
3. Launch **LithiumGit** and start exploring Git like never before!
33+
34+
### macOS
35+
1. Download the `.dmg` file from the [Releases Page](https://github.com/tulshidas39/lithiumgit/releases).
36+
2. Open the `.dmg`, drag the app into your `Applications` folder, and you're ready to go!
37+
38+
### Linux
39+
1. Download the appropriate `.AppImage` or `.deb` file for your distribution.
40+
For AppImage:
41+
```bash
42+
chmod +x [LithiumGit].AppImage
43+
./[LithiumGit].AppImage
44+
```
45+
For Debian/Ubuntu:
46+
```bash
47+
sudo dpkg -i [lithiumgit].deb
48+
```
49+
2. Run and enjoy a powerful Git experience.
50+
51+
---
52+
53+
## 🚦 How to Use
54+
55+
1. Open **LithiumGit** and select a repository you'd like to manage or clone a repository from any Git URL.
56+
2. Perform various Git operations such as:
57+
- View commit history through the **Interactive Graph View**.
58+
- Stage/Unstage changes with a few clicks.
59+
- Branch creation and merging made simple.
60+
3. Customize your workflows through settings and shortcuts for efficiency.
61+
62+
_Enjoy lightning-fast Git operations from one central tool!_
63+
64+
---
65+
66+
67+
## 🤝 Contributing
68+
69+
Contributions are more than welcome! Please feel free to:
70+
71+
- Submit bug reports or feature requests on [GitHub Issues](https://github.com/tulshidas39/lithiumgit/issues).
72+
- Fork the repository, make your changes, and open a Pull Request to get your contributions merged.
73+
74+
### Local Development Setup
75+
1. Clone the repository:
76+
```bash
77+
git clone https://github.com/tulshidas39/lithiumgit.git
78+
cd lithiumgit
79+
```
80+
2. Install dependencies:
81+
```bash
82+
npm install # Or yarn install
83+
```
84+
3. Start the main process:
85+
```bash
86+
npm start
87+
```
88+
4. Navigate to ui:
89+
```bash
90+
cd ui
91+
```
92+
5. Install dependencies of ui:
93+
```bash
94+
npm install # Or yarn install
95+
```
96+
6. Start the renderer process:
97+
```bash
98+
npm start
99+
```
100+
101+
---
102+
103+
## 📜 License
104+
105+
This project is licensed under the **MIT License**. See the [LICENSE](./LICENSE) file for full details.
106+
107+
---
108+
109+
## 🌐 Website
110+
111+
For detailed usage instructions, and resources, visit our website:
112+
👉 **[Lithium Git Client Documentation & Guide](https://lithiumgit.github.io/)**
113+
114+
---
115+
116+
## 📬 Questions or Feedback?
117+
118+
If you have any questions, feedback, or feature requests, feel free to reach out to:
119+
120+
- **GitHub Issues**: [GitHub Issues](https://github.com/tulshidas39/lithiumgit/issues)
121+
122+
We welcome users and contributors alike. Let's build the best Git client experience together! 🚀
123+
124+
---
25125

26-
# Steps to create distribution
27-
-navigate to common_library folder and run "npm run build"
28-
-open ./src/config.ts file
29-
-ensure static readonly ENV:'development'|'production' = 'production';
30-
-delete ./dist/db and ./dist/log folders if exist.
31-
-run "npm run package" in root directory.
126+
## 🌟 Support the Project
32127

33-
## License
128+
If you find **Lithium Git Client** helpful, please consider giving this repository a ⭐ on GitHub. It helps others discover the project!
34129

35-
[MIT](LICENSE)
130+
---

package.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "lithiumgit",
3-
"version": "1.0.4",
3+
"version": "1.0.5",
44
"description": "A git gui application",
55
"scripts": {
66
"build": "tsc && npm run copy_src_assets",

src/config.ts

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
import { Env } from "./types";
22

33
export class Config{
4-
static readonly env:Env=Env.DEVELOPMENT;
4+
static readonly env:Env=Env.PRODUCTION;
55
static readonly UI_PORT = 57631;
66
}

0 commit comments

Comments
 (0)