Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/willothy/veil.nvim
A blazingly fast, animated, and infinitely customizeable startup / dashboard plugin (currently unmaintained, but with plans for a ground-up rewrite)
https://github.com/willothy/veil.nvim
Last synced: about 2 months ago
JSON representation
A blazingly fast, animated, and infinitely customizeable startup / dashboard plugin (currently unmaintained, but with plans for a ground-up rewrite)
- Host: GitHub
- URL: https://github.com/willothy/veil.nvim
- Owner: willothy
- Created: 2023-03-22T21:01:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-12-25T22:20:03.000Z (5 months ago)
- Last Synced: 2024-01-24T10:38:39.401Z (4 months ago)
- Language: Lua
- Homepage:
- Size: 36.1 KB
- Stars: 119
- Watchers: 8
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Lists
- awesome-neovim - willothy/veil.nvim - A blazingly fast, animated, and infinitely customizable startup / dashboard plugin. (Startup / Cursorline)
- awesome-stars - willothy/veil.nvim - A blazingly fast, animated, and infinitely customizeable startup / dashboard plugin (currently unmaintained, but with plans for a ground-up rewrite) (Lua)
- awesome-neovim - willothy/veil.nvim - A blazingly fast, animated, and infinitely customizable startup / dashboard plugin. (Startup / Cursorline)
- awesome-neovim - willothy/veil.nvim - A blazingly fast, animated, and infinitely customizable startup / dashboard plugin. (Startup / Cursorline)
README
# veil.nvim
A blazingly fast, animated, and infinitely customizeable startup / dashboard plugin
> UPDATE *12/25/2023*:
> Everything below this notice is deprecated, pending a complete rewrite. As seen in #14, I intend to rebuild Veil
as a composable floating-window-based UI library providing rendering, placement, interaction, and query primitives.
The architecture should allow for complex startup screens with widgets and graphs, interactable items, animated headers (like before),
and much more. Floating windows should also make supporting mouse interaction for heretics (/j) much easier.
> **Warning**
> I would not recommend using the current implementation, as I am not maintaining it and it is likely very buggy.
## Features
- [x] Animated sections rendered with virtual text
- [x] Builtin "standard library"
- [x] Buttons builtin
- [x] Oldfiles builtin
- [ ] Current dir builtin
- [ ] Floating widget builtin
- [x] Ascii frame anim builtin
- [x] Vertical padding builtin
- [x] Static text sections
- [x] Dynamic text sections
- [x] Per-section state
- [ ] Simple and extensible API
- [ ] Rendering / API V2 (in progress)
- [x] Interactible components (use buttons with ``)
- [x] Cursor 'hover' events
- [x] Lock cursor to menus
- [x] Highlighting
- [x] Shortcut mappings
- [x] Startup in <1ms
- [ ] Mouse events
- [ ] API for advanced rendering / terminal graphics
## Demo (default config)
https://user-images.githubusercontent.com/38540736/228553706-b68e99a7-c4d6-4803-a06e-4e3bb12109ea.mp4
## Installation
Using lazy.nvim
```lua
{
'willothy/veil.nvim',
lazy = true,
dependencies = {
-- All optional, only required for the default setup.
-- If you customize your config, these aren't necessary.
"nvim-telescope/telescope.nvim",
"nvim-lua/plenary.nvim",
"nvim-telescope/telescope-file-browser.nvim"
}
config = true,
-- or configure with:
-- opts = { ... }
}
```
## Configuration
Veil comes with the following defaults
The defaults assume you have Telescope installed because... you probably do.
```lua
local builtin = require("veil.builtin")
local default = {
sections = {
builtin.sections.animated(builtin.headers.frames_nvim, {
hl = { fg = "#5de4c7" },
}),
builtin.sections.buttons({
{
icon = "",
text = "Find Files",
shortcut = "f",
callback = function()
require("telescope.builtin").find_files()
end,
},
{
icon = "",
text = "Find Word",
shortcut = "w",
callback = function()
require("telescope.builtin").live_grep()
end,
},
{
icon = "",
text = "Buffers",
shortcut = "b",
callback = function()
require("telescope.builtin").buffers()
end,
},
{
icon = "",
text = "Config",
shortcut = "c",
callback = function()
require("telescope").extensions.file_browser.file_browser({
path = vim.fn.stdpath("config"),
})
end,
},
}),
builtin.sections.oldfiles(),
},
mappings = {},
startup = true,
listed = false
}
```
### Configuration Recipes
Days of week header by @coopikoop
```lua
-- in your config:
local current_day = os.date("%A")
require('veil').setup({
sections = {
builtin.sections.animated(builtin.headers.frames_days_of_week[current_day], {
hl = { fg = "#5de4c7" },
}),
-- other sections
-- ...
}
}
```