Skip to content

Commit d9f3670

Browse files
authored
Update README.md
1 parent abdc1bf commit d9f3670

1 file changed

Lines changed: 106 additions & 9 deletions

File tree

README.md

Lines changed: 106 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,106 @@
1-
# Installer
2-
Automatically installs GarudaNvim with a single command
3-
</br>
4-
Run the following command to install GarudaNvim:
5-
```
6-
wget -q https://raw.githubusercontent.com/GarudaNvim/Installer/main/installGarudaNvim.sh
7-
chmod +x installGarudaNvim.sh && ./installGarudaNvim.sh
8-
rm installGarudaNvim.sh
9-
```
1+
# GarudaNvim Installer
2+
3+
Welcome to the **GarudaNvim Installer** repository! This repository contains scripts to easily install and uninstall **GarudaNvim**, a powerful and efficient Neovim configuration, tailored for macOS.
4+
5+
---
6+
7+
## Table of Contents
8+
9+
- [Introduction](#introduction)
10+
- [Installation](#installation)
11+
- [Features](#features)
12+
- [Uninstallation](#uninstallation)
13+
- [Feedback and Issues](#feedback-and-issues)
14+
15+
---
16+
17+
## Introduction
18+
19+
**GarudaNvim** is a custom configuration for Neovim designed to boost productivity, tailored specifically for macOS users. With easy-to-use installer and uninstaller scripts, you can manage your GarudaNvim setup seamlessly.
20+
21+
---
22+
23+
## Installation
24+
25+
### Steps to Install GarudaNvim
26+
27+
To install GarudaNvim on your macOS system, simply follow these steps:
28+
29+
1. Run the following command in your terminal:
30+
```sh
31+
wget -q https://raw.githubusercontent.com/GarudaNvim/Installer/main/installGarudaNvim.sh
32+
chmod +x installGarudaNvim.sh && ./installGarudaNvim.sh
33+
rm installGarudaNvim.sh
34+
```
35+
36+
2. Follow the on-screen prompts:
37+
- If an existing Neovim configuration is found, you'll be given two options:
38+
- **Delete** your current Neovim configuration and proceed with the GarudaNvim installation.
39+
- **Backup(Automatic/Manual)** your current configuration and install GarudaNvim.
40+
41+
- If you choose to **delete** your current configuration, the installer will remove your Neovim configuration along with related directories in `~/.local/share`, `~/.local/state`, and `~/.cache`.
42+
43+
- If you choose to **automatically backup** your configuration, the installer will create backups of your current setup (e.g., `~/.config/nvim.bak`, `~/.local/share/nvim.bak`, etc.), and then proceed with the installation of GarudaNvim.
44+
45+
- If you choose to **manually backup** your configuration, then go ahead and move(or rename) your current config. After that, run this script again.
46+
47+
4. Once the installation is complete, you’ll see a success message, and you can start using GarudaNvim by opening Neovim.
48+
49+
---
50+
51+
## Features
52+
53+
The **GarudaNvim Installer** and **Uninstaller** come with several convenient features to ensure an easy and smooth user experience:
54+
55+
1. **Automatic Configuration Detection**:
56+
- The installer script automatically checks whether a Neovim configuration already exists in the system (i.e., in `~/.config/nvim`).
57+
- If a configuration is found, the installer will prompt the user with two options:
58+
- **Backup**: Automatically backs up the existing configuration so it can be restored later if needed.
59+
- **Delete**: Deletes the existing configuration to install GarudaNvim from scratch.
60+
61+
2. **Safe Backup Option**:
62+
- The installer provides the option to back up the existing configuration before installing GarudaNvim.
63+
- The backup includes not only `~/.config/nvim` but also other related directories like `~/.local/share/nvim`, `~/.local/state/nvim`, and `~/.cache/nvim`.
64+
65+
3. **Complete Uninstallation**:
66+
- The uninstallation script checks for the presence of GarudaNvim (`~/.config/nvim/lua/garudanvim`) and confirms with the user before proceeding.
67+
- If confirmed, the script removes all related GarudaNvim configurations and associated directories (`~/.config/nvim`, `~/.local/share/nvim`, `~/.local/state/nvim`, `~/.cache/nvim`) to ensure a clean uninstall.
68+
69+
These features make it easy to manage Neovim setups, providing flexibility for users who may want to switch between different configurations without losing their previous setup.
70+
71+
---
72+
73+
## Uninstallation
74+
75+
### Steps to Uninstall GarudaNvim
76+
77+
If you wish to uninstall GarudaNvim and remove all related configuration, follow these steps:
78+
79+
1. Run this uninstaller script in your terminal using the following command:
80+
```sh
81+
wget -q https://raw.githubusercontent.com/GarudaNvim/Installer/main/uninstallGarudaNvim.sh
82+
chmod +x uninstallGarudaNvim.sh && ./uninstallGarudaNvim.sh
83+
rm uninstallGarudaNvim.sh
84+
```
85+
86+
2. The script will first check if GarudaNvim is installed by looking for the `garudanvim` directory inside your Neovim configuration (`~/.config/nvim/lua/garudanvim`).
87+
88+
- If found, you will be prompted to confirm the uninstallation process.
89+
90+
- If GarudaNvim is not found, the uninstaller will exit, as there is no GarudaNvim configuration to remove.
91+
92+
3. If you confirm the uninstallation, the following directories will be permanently deleted:
93+
- `~/.config/nvim`
94+
- `~/.local/share/nvim`
95+
- `~/.local/state/nvim`
96+
- `~/.cache/nvim`
97+
98+
4. Once the uninstallation is complete, you will see a success message.
99+
100+
---
101+
102+
## Feedback and Issues
103+
104+
If you encountered any issues while using **GarudaNvim**, or if you have suggestions for improvements, please raise an issue on the [Installer's Issue Page](https://github.com/GarudaNvim/Installer/issues)
105+
106+
Thank you for using GarudaNvim!

0 commit comments

Comments
 (0)