https://github.com/jamescherti/lightvim

Better Vim Defaults
https://github.com/jamescherti/lightvim

vim vim-configuration vimrc

Last synced: 6 months ago
JSON representation

Better Vim Defaults

• Host: GitHub
• URL: https://github.com/jamescherti/lightvim
• Owner: jamescherti
• License: mit
• Created: 2024-12-09T16:12:36.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-02-19T13:02:53.000Z (over 1 year ago)
• Last Synced: 2025-02-19T14:22:32.774Z (over 1 year ago)
• Topics: vim, vim-configuration, vimrc
• Language: Vim Script
• Homepage: https://github.com/jamescherti/jc-vimrc
• Size: 108 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# jc-vimrc - Better Vim Defaults

![License](https://img.shields.io/github/license/jamescherti/jc-vimrc)

The **jc-vimrc** project is a customizable Vim base that provides **better Vim defaults**, intended to serve as a solid foundation for a Vim configuration.

Creating *jc-vimrc* involved extensive research and testing to find the best parameters and optimizations for an vimrc file. The concept behind *jc-vimrc* is to provide a clean, bloat-free base.

By default, only essential features are enabled, providing a minimal base that is optimized. From there, users are encouraged to consult this README.md to customize and extend the configuration based your their specific needs.

## Key bindings

- The default : `,`

### Miscellaneous

Normal mode:

- Toggle wrap: `wr`

- Previous buffer: `A-o`

- Next buffer: `A-i`

### Clipboard:

Visual mode:

- Copy: `C-c`

- Cut: `C-x`

Insert mode:

- Paste: `C-v`

### Files:

Grep:

- Run grep (or rg, if available): `gr` (normal mode)

### Tabs

Normal mode:

- Create a tab: `t`

Insert mode, visual mode, and normal mode:

- Previous tab: `C-k`

- Next tab: `C-j`

- Move tab to the left: ``

- Move tab to the right: ``

Visual and normal mode:

- Close window/split (or tab if there is one window in the current tab): `C-w c`

### External plugins

Normal mode:

- Run MRU (requires mru.vim): `m` or `b`

- Run fzf (requires fzf.vim): `C-p`

## Features

This vimrc enhances defaults that improve the editing experience with Vim, based on extensive research and testing.

1. **Miscellaneous enhancements**:

- Automatically remove unnecessary whitespace before saving files.

- Disables compatibility with Vi and uses Vim-specific settings.

- Prevents loading the configuration multiple times.

2. **Encoding and File Handling**:

- Sets global encoding, file encodings, and script encoding to UTF-8.

- Allows loading an optional pre-configuration script (`~/.vim/before.vim`).

- Allows loading an optional post-configuration script (`~/.vim/after.vim`).

3. **Font Settings**:

- Configures default font and size (`DejaVu Sans Mono` at size 14).

- Offers a method to scale the GUI font size within a defined range (6-30).

4. **Session Management**:

- Defines options for Vim sessions and view settings (e.g., folds, current directory, cursor position).

5. **GUI and Console Configuration**:

- Customizes GUI-specific settings, including window size, font rendering, cursor behavior, and disabling unnecessary UI elements.

- Improves color handling and terminal display with 256-color support and true color.

6. **Syntax, Indentation, and Formatting**:

- Enables syntax highlighting and filetype-based indentation plugins.

- Configures indentation style (spaces instead of tabs, 4 spaces per indentation level).

- Automatically wraps comments and disables smart indenting features for better manual control.

7. **Status Line**:

- Customizes the status line to show relevant information such as paste mode, wrap status, filename, line/column number, and current Git branch.

8. **Window and Layout Settings**:

- Sets split window behavior (e.g., splits right and below).

- Configures window size and scrolling behavior.

9. **Backup and Undo Settings**:

- Disables backup files and sets undo options (e.g., persistent undo with undo files).

10. **Key Mappings and Shortcuts**:

- Assigns useful key mappings (e.g., tabs, grep, for writing files, changing directories, adjusting font size).

- Custom leader key (`,`), allowing for personalized shortcuts.

11. **Search Settings**:

- Configures incremental search, case-sensitive search (`smartcase`), and disables search wrapping.

12. **Language and Spell Check**:

- Configures spell checking and defines custom dictionary and thesaurus files.

13. **Clipboard Integration**:

- Supports clipboard integration (copy/paste between Vim and external applications) when available.

14. **File Type Specific Settings**:

- Defines custom settings for specific file types (e.g., Dockerfile, YAML, Python, Shell, Vim).

15. **Autocommands**:

- Uses autocommands to automate behaviors like adjusting settings when a file type is detected or resizing windows on Vim resize events.

16. **Mouse Configuration**:

- Configures mouse support in various modes, including the ability to drag and select text within Vim without switching to visual mode.

17. **Optimization Settings**:

- Includes optimizations for smooth scrolling and fast terminal connections, including reducing screen redraw times.

18. **Smart Write Function**:

- Defines a function (`smart_write`) to save files intelligently, ensuring proper handling of modified and non-modified files.

## Author and license

Copyright (C) 2000-2025 [James Cherti](https://www.jamescherti.com).

Distributed under terms of the MIT license.

## Links

- [jc-vimrc @GitHub](https://github.com/jamescherti/jc-vimrc)