|
1 |
| -# LithiumGit |
| 1 | +# 🚀 LithiumGit |
2 | 2 |
|
3 |
| -**Download and install latest version from [releases](https://github.com/TulshiDas39/LithiumGit/releases)..** |
| 3 | + |
4 | 4 |
|
5 |
| -This is a cross platform Git GUI application. |
6 | 5 |
|
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. |
8 | 7 |
|
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 | +--- |
10 | 9 |
|
11 |
| -ui: This is a react app built with create-react-app template. This is the application ui. |
| 10 | +## ✨ Key Features |
12 | 11 |
|
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! |
20 | 13 |
|
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 | +  |
| 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 | +--- |
25 | 125 |
|
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 |
32 | 127 |
|
33 |
| -## License |
| 128 | +If you find **Lithium Git Client** helpful, please consider giving this repository a ⭐ on GitHub. It helps others discover the project! |
34 | 129 |
|
35 |
| -[MIT](LICENSE) |
| 130 | +--- |
0 commit comments