{"id":16988675,"url":"https://github.com/rafaelrcamargo/known.nvim","last_synced_at":"2026-04-13T17:34:50.670Z","repository":{"id":142647124,"uuid":"572573833","full_name":"rafaelrcamargo/known.nvim","owner":"rafaelrcamargo","description":"A config that make you feel like you've known Neovim for ever.","archived":false,"fork":false,"pushed_at":"2024-01-09T00:20:50.000Z","size":55327,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T02:44:40.747Z","etag":null,"topics":["neovim","nvim","nvim-config","nvim-ide","vim"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rafaelrcamargo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-11-30T15:07:48.000Z","updated_at":"2023-03-07T03:18:36.000Z","dependencies_parsed_at":"2024-01-09T02:43:34.256Z","dependency_job_id":null,"html_url":"https://github.com/rafaelrcamargo/known.nvim","commit_stats":{"total_commits":31,"total_committers":2,"mean_commits":15.5,"dds":"0.25806451612903225","last_synced_commit":"f19d8df85b703812a574c99f4a26fe730f404ad4"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rafaelrcamargo/known.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafaelrcamargo%2Fknown.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafaelrcamargo%2Fknown.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafaelrcamargo%2Fknown.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafaelrcamargo%2Fknown.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rafaelrcamargo","download_url":"https://codeload.github.com/rafaelrcamargo/known.nvim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rafaelrcamargo%2Fknown.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31762710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-13T15:25:13.801Z","status":"ssl_error","status_checked_at":"2026-04-13T15:25:09.162Z","response_time":93,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["neovim","nvim","nvim-config","nvim-ide","vim"],"created_at":"2024-10-14T03:04:33.195Z","updated_at":"2026-04-13T17:34:50.655Z","avatar_url":"https://github.com/rafaelrcamargo.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!---------------------------------------------------------------------------------------\u003e\n\n\u003c!-- Header --\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/icon.png\" alt=\"Known.nvim\" width=\"200\" /\u003e\n  \u003ch1\u003eKnown.nvim\u003c/h1\u003e\n\u003c/div\u003e\n\n\u003c!-- Badges --\u003e\n\u003cdiv align=\"center\"\u003e\n\n[![Licence][license-badge]][license] [![Issues][issues-badge]][issues] [![Code Size][code-size-badge]][code_size] [![Neovim Minimum Version][neovim-badge]][neovim]\n\n\u003c/div\u003e\n\n\u003c!-- Outro --\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003eA config that make you feel like you've \u003ci\u003eknown\u003c/i\u003e Neovim for ever.\u003c/p\u003e\n  \u003ca href=\"#what\"\u003eW's\u003c/a\u003e • \u003ca href=\"#principles\"\u003ePrinciples\u003c/a\u003e • \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e • \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e • \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n\u003c/div\u003e\n\n\u003c!---------------------------------------------------------------------------------------\u003e\n\n\u003cbr/\u003e\n\u003cimg src=\"assets/test.gif\" alt=\"Known.nvim\" width=\"100%\" /\u003e\n\n\u003c!---------------------------------------------------------------------------------------\u003e\n\n\u003ch2 id=\"what\"\u003e😶‍🌫️ What?\u003c/h2\u003e\n\nA heavily opinionated, performant, and functional Neovim config. Without forgetting the usability, simplicity, and visual appeal. Every line was carefully written, and every plugin has a reason to be there.\n\n\u003e Crafting a config that is not only **fast**, but also **easy** to use, **and beautiful** to look at.\n\n\u003ch2\u003e🤔 Why?\u003c/h2\u003e\n\nWhen I was looking for a better alternative to modern IDEs, which are _heavy, slow, and bloated with tools I'd never use_. I found out about **Neovim**, some months later and I tried every config out there, and I was not satisfied. I wanted a config that had a motivation behind every **plugin**, and every **keybinding**. I wanted a config that was _fast, and easy to use_. I wanted a config that was _beautiful to look at_, and that made me feel like switching from any other editor.\n\n\u003ch2\u003e⛓ Principles:\u003c/h2\u003e\n\nThis configuration was built following these 2 sets of principles:\n\n\u003cdetails\u003e\n  \u003csummary\u003e🖼 UI (Neovim)\u003c/summary\u003e\n\n\u003cbr/\u003e\n\n- Less is more.\n  - The UI elements should have a purpose, the focus is on the code, and the UI should add information and relevant information.\n- Less information does not mean ugly, raw, or boring.\n- Icons are not just pretty, they are also useful.\n  - Predictable icons are better than text.\n  - Icons are faster to read.\n  - Icons are easier to remember.\n- The UI should be consistent.\n  - The UI should not change drastically from one plugin to another.\n  - CLS (Cumulative Layout Shift) should be avoided.\n- The UI should be lazy and never block the user.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e📄 The Config. (Code)\u003c/summary\u003e\n\n\u003cbr/\u003e\n\n- Never do or accept anything without knowing why.\n  - Plugins should be installed with a reason. And if needed, they should come with an explanation.\n  - Keybindings are only accepted if they are **useful**, not just for the sake of having them.\n    - _Sporadically, once, if a ever need..._ Are **not** good excuses.\n- Errors should not pass silently, they should be annoying, loud, and clear.\n  - If it's bothering you, fix it.\n- Easy use is directly proportional to performance. A Slow environment is a bad environment.\n  - Waiting removes the focus from the task at hand.\n  - Locking changes your focus to check if everything is alright.\n\n\u003c/details\u003e\n\n\u003ch2 id=\"installation\"\u003e⬇️ Installation\u003c/h2\u003e\n\nThe installation is very simple, just run the following command:\n\n```bash\ngit clone --depth 1 https://github.com/rafaelrcamargo/know.nvim.git ~/.config/nvim\n```\n\n\u003e **Warning**:\n\u003e If you already have a `~/.config/nvim` folder, you probably want to back up it first.\n\n\u003ch2 id=\"features\"\u003e💡 Features\u003c/h2\u003e\n\nThe optimization and set of rules that this config follows make it very efficient, and easy to use and remember. The following list is a summary of the features that this config has:\n\n\u003cdetails\u003e\n  \u003csummary\u003e🔮 Neovim\u003c/summary\u003e\n\n- Packer:\n  - A package manager to ease the lazy loading of plugins.\n- Telescope:\n  - A fuzzy finder to find files, buffers, commands, etc.\n- Neoclip:\n  - A clipboard manager to copy and paste from the Neovim buffer.\n- Feline:\n  - A status line to show information about the current buffer.\n- Bufferline:\n  - A tabline to show the open buffers.\n- Nvim-tree:\n  - A file explorer to navigate through the files.\n- Dashboard:\n  - A fancy start screen to welcome you.\n- Copilot:\n  - A AI pair programmer to help you write code.\n- Inyoface:\n  - A better way to find and read comments.\n- TODO-comments:\n  - A highlighter for TODO, FIXME, BUG, etc.\n- Twilight:\n  - A plugin to focus only on the code you are writing.\n- Gitsigns:\n  - A plugin to show git changes in the gutter.\n- Mason:\n  - A helper for the LSP installation process.\n- Neodim:\n  - Don't ever again forget unused code laying around.\n- Null-ls:\n  - A LSP+ experience with a lot of extra features.\n- Coq:\n  - A Fast as F#CK autocomplete engine.\n\n\u003c/details\u003e\n\n\u003e **Note**:\n\u003e Ok, that's a lot of features I got, but these are only the most relevant ones. There are lots of configurations meant only to make your life easier, and to make you feel at home.\n\n\u003ch3\u003e🎨 Colorschemes\u003c/h3\u003e\n\nThe main color scheme used in this config is [material-gruvbox](https://github.com/sainnhe/gruvbox-material), but with this **beautiful** theme comes a huge problem, and a thing avoided by any sane person: **IS VIMSCRIPT**. So, to avoid the performance hit, this config uses [catppuccin](https://github.com/catppuccin/nvim) a modern and one of, if not the most advanced color scheme for Neovim. It is written in Lua and compiled as you need, so it's very fast. And with it we can use the colors and create our material-gruvbox color scheme, jumping from `~12.01ms` to a load time of `~0.03ms`.\n\n\u003e 🍨 Soothing pastel theme for (Neo)vim\n\n\u003c!-- TODO: Catppuccin demo --\u003e\n\nBut this is not all, also nebulous is configured, just not active for now.\n\n\u003e nebulous.nvim: Minimalist Collection of Color schemes for Neovim Written in Lua\n\n\u003c!-- TODO: Nebulous demo --\u003e\n\n\u003ch2\u003e🤝 Contributing\u003c/h2\u003e\n\nIf you want to contribute to this project, you can do it in many ways:\n\n- **Report bugs**:\n  - If you find a bug, please report it in the [issues](issues)\n- **Request features**:\n  - If you have a feature request, please report it in the [discussions](discussions)\n\n\u003e But the biggest one, discuss, discuss, discuss. If you have a problem or a doubt, or just want to talk about something, please do it, I'm always open to talking about anything.\n\n\u003ch2\u003e📝 TODO\u003c/h2\u003e\n\n- [ ] ...\n- [x] ...\n- [ ] ...\n\n\u003ch2\u003e📜 Changelog\u003c/h2\u003e\n\nSee the [CHANGELOG.md](CHANGELOG.md) file for more information.\n\n\u003ch2\u003e🗂 Inspirations\u003c/h2\u003e\n\n- [ChristianChiarulli](https://github.com/LunarVim) for LunarVim, a awesome Neovim configuation, full of features and very well documented.\n  - Definitely the most advanced project for a Neovim configuration out there.\n- [NvChad](https://github.com/NvChad/NvChad) for a _fast_, well documented and easy to use Neovim configuration.\n  - The most starred Neovim configuration on GitHub.\n\nAnd finally, but not least, [quick.nvim](https://github.com/albingroen/quick.nvim) a smaller, faster and simpler Neovim configuration. The one that finally made me want to start my own configuration from scratch, and lose the fear of doing so.\n\n\u003ch2\u003e🔓 License\u003c/h2\u003e\n\nThis project is licensed under the [Apache License 2.0][license].\n\n\u003c!---------------------------------------------------------------------------------------\u003e\n\n\u003c!-- Badges --\u003e\n\n[license-badge]: https://img.shields.io/github/license/rafaelrcamargo/dotfiles?style=flat-square\u0026color=e78a4e\u0026label=License\n[issues-badge]: https://img.shields.io/github/issues/rafaelrcamargo/dotfiles?style=flat-square\u0026color=d8a657\u0026label=Issues\n[code-size-badge]: https://img.shields.io/github/languages/code-size/rafaelrcamargo/dotfiles?style=flat-square\u0026color=a9b665\u0026label=Code%20Size\n[neovim-badge]: https://img.shields.io/badge/Neovim-0.8.0-blueviolet.svg?style=flat-square\u0026color=89b482\n\n\u003c!-- Links --\u003e\n\n[license]: https://github.com/rafaelrcamargo/dotfiles/blob/main/LICENSE\n[issues]: https://github.com/rafaelrcamargo/dotfiles/issues\n[code_size]: https://github.com/rafaelrcamargo/dotfiles/tree/main\n[neovim]: https://github.com/neovim/neovim\n\n\u003c!---------------------------------------------------------------------------------------\u003e\n\n\u003c!-- Notes: --\u003e\n\u003c!-- https://www.lua.org/gems/sample.pdf --\u003e\n\u003c!-- https://neovim.io/doc/user/lua.html --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafaelrcamargo%2Fknown.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frafaelrcamargo%2Fknown.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frafaelrcamargo%2Fknown.nvim/lists"}