|
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