search

vim-fall / fall.vim

🍂 Yet Another Fuzzy Finder designed for Vim and Neovim and to be programmer-friendly
MIT License
68 stars 3 forks source link
denops fuzzy-finder neovim vim vim-fall

readme

🍂 Fall

Test Deno codecov MIT License Vim Help

![CleanShot 2024-11-17 at 15 17 46](https://github.com/user-attachments/assets/f19fe70e-1b6f-4493-90da-45fcfdd5cd57)
Fall with [vim-glyph-pallet](https://github.com/lambdalisue/vim-glyph-palette) (Colors on glyphs) on [NordFox](https://github.com/EdenEast/nightfox.nvim) (Vim's colorscheme)

Fall is a fuzzy finder for Vim and Neovim, implemented in Denops, and stands for "Filter All."

See Features for more information about Fall's features.

[!WARNING]

This is a beta version. Please be aware that there might be backward-incompatible changes.

Requirements

Users must install Deno version 2.x. Additionally, the nerdfont renderer is enabled by default, so configure your terminal to use a NerdFont, or disable it by removing the builtin.renderer.nerdfont renderer from the custom file and use non builtin.theme.modern.MODERN_THEME theme (:FallCustom).

Note that Deno version 1.x is not tested and not supported.

Installation

To install Denops and this plugin using your preferred plugin manager, such as vim-plug, add the following lines to your Vim configuration:

Plug 'vim-denops/denops.vim'
Plug 'vim-fall/fall.vim'

Usage

Use the :Fall command to open the fuzzy finder. The command accepts the following arguments:

Fall {source} {source_args}...

For example, if you'd like to use the file source, you can use the following:

Fall file

Or use the line source with README.md as an argument:

Fall line README.md

Mappings

Fall Vim README Image

Users can view available mappings by pressing <F1> in the picker window. See the Mappings page for more details.

Configuration

In Fall, settings that utilize Vim’s built-in functionality are categorized as “Configuration.” This includes key mappings, highlights, and buffer option modifications.

Refer to the Configuration page on the GitHub Wiki for more details.

Customization

In Fall, settings written in TypeScript to enhance Fall’s functionality are categorized as “Customization.” These specifically refer to modifications made to the user customization file, which can be accessed via the FallCustom command.

Visit the Customization page on the GitHub Wiki for more information.

Related Projects

Repository Package Description
vim-fall/deno-fall-core @vim-fall/core Core types for Fall. Not meant for external use.
vim-fall/deno-fall-custom @vim-fall/custom Library to customize Fall.
vim-fall/deno-fall-std @vim-fall/std Standard library for using Fall.
vim-fall/deno-fall-extra @vim-fall/extra Extra library for using Fall.

Similar Projects

License

The code in this repository follows the MIT license, as detailed in LICENSE. Contributors must agree that any modifications submitted to this repository also adhere to the license.