FKvim
Fkvim is a custom, lightweight, and beginner-friendly Neovim configuration built to deliver a clean, efficient, and modern editing experience. Whether you're a developer new to Neovim or a power user looking for a fast, extensible setup, FKvim offers a solid foundation designed for customization and productivity.
Install / Use
/learn @thenfks/FKvimREADME
<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%"> <img width="1305" alt="image" src="https://github.com/user-attachments/assets/f083ebfa-d89a-4831-86bf-19aed7fdf309" /> <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%"> <div align="center"> <img src="https://readme-typing-svg.herokuapp.com?font=Fira+Code&weight=600&size=24&duration=3000&pause=1000&color=00C853¢er=true&vCenter=true&width=900&lines=Thanks+for+visiting+Fkvim!+🙌;Start+the+repo+✅;Share+it+with+others+🌍;Contribute+and+grow+🛠️;Happy+Coding+✨!" alt="Thanks Banner Typing SVG" /> </div> <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="150%">A modern, minimal, and lightning-fast Neovim setup — designed for performance, aesthetics, and developer productivity.
📊 Project Insights
<table align="center"> <thead align="center"> <tr> <td><b>🌟 Stars</b></td> <td><b>🍴 Forks</b></td> <td><b>🐛 Issues</b></td> <td><b>🔔 Open PRs</b></td> <td><b>🔕 Closed PRs</b></td> <td><b>🛠️ Languages</b></td> <td><b>👥 Contributors</b></td> </tr> </thead> <tbody> <tr> <td><img alt="Stars" src="https://img.shields.io/github/stars/TheFlashCodes/FKvim?style=flat&logo=github"/></td> <td><img alt="Forks" src="https://img.shields.io/github/forks/TheFlashCodes/FKvim?style=flat&logo=github"/></td> <td><img alt="Issues" src="https://img.shields.io/github/issues/TheFlashCodes/FKvim?style=flat&logo=github"/></td> <td><img alt="Open PRs" src="https://img.shields.io/github/issues-pr/TheFlashCodes/FKvim?style=flat&logo=github"/></td> <td><img alt="Closed PRs" src="https://img.shields.io/github/issues-pr-closed/TheFlashCodes/FKvim?style=flat&color=critical&logo=github"/></td> <td><img alt="Languages Count" src="https://img.shields.io/github/languages/count/TheFlashCodes/FKvim?style=flat&color=green&logo=github"></td> <td><img alt="Contributors Count" src="https://img.shields.io/github/contributors/TheFlashCodes/FKvim?style=flat&color=blue&logo=github"/></td> </tr> </tbody> </table> <img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="150%">✨ Features
- ⚡ Fast Startup – Powered by
lazy.nvim - 🎨 Modern UI – Beautiful, transparent, and distraction-free
- 🧠 LSP Ready – Language Server Protocol and smart completion via
nvim-cmp - 📁 Neo-tree – Smooth file browsing with Git indicators
- 🔍 Telescope – Blazing fast fuzzy finder
- 🧩 Treesitter – Powerful syntax highlighting & better code understanding
- 🔔 Custom Notifications – Unified Noice UI with minimal alerts
- 🛠️ Modular Structure – Easy to configure, extend, and maintain
- 🧪 Built-in Terminal, breadcrumbs, Git signs, and much more...

🌟 Exciting News...
🚀 This project is now an official part of GirlScript Summer of Code – GSSoC'25! 💃🎉💻 We're thrilled to welcome contributors from all over India and beyond to collaborate, build, and grow Fkvim! Let’s make learning and career development smarter – together! 🌟👨💻👩💻
👩💻 GSSoC is one of India’s largest 3-month-long open-source programs that encourages developers of all levels to contribute to real-world projects 🌍 while learning, collaborating, and growing together. 🌱
🌈 With mentorship, community support, and collaborative coding, it's the perfect platform for developers to:
- ✨ Improve their skills
- 🤝 Contribute to impactful projects
- 🏆 Get recognized for their work
- 📜 Receive certificates and swag!
🎉 I can’t wait to welcome new contributors from GSSoC 2025 to this Fkvim project family! Let's build, learn, and grow together — one commit at a time. 🔥👨💻👩💻
<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="150%">🚀 Commands
FKvim provides the following custom commands:
| Command | Description | Keybinding |
|---------------------|---------------------------------------------------|-----------------|
| :FkGemini | Opens the Gemini AI assistant in a split window. | <leader>g |
| :FkGemini update | Updates the Gemini CLI to the latest version. | |
| :FkInstall Gemini | Installs the Gemini CLI. | |
📦 Requirements
Make sure you have the following installed:
| Tool | Version | Description |
|---------------|-------------|---------------------------------------------|
| Neovim | >= 0.9.0 | Core editor |
| Git | Latest | For managing FKvim and plugin cloning |
| Nerd Font | Recommended | For icons in status line and UI |
| Curl/Wget | Optional | For automated installation scripts |
<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">💡 Use a terminal that supports true color and transparency for best visuals.
📥 Installation
git clone https://github.com/Flash-codes/fkvim.git ~/.config/nvim
nvim
<img src="https://user-images.githubusercontent.com/74038190/212284100-561aa473-3905-4a80-b561-0d28506553ee.gif" width="100%">🧠 On first launch, FKvim will auto-install all plugins via
lazy.nvim. 📘 Need help? Visit the FKvim Wiki
📁 Directory Structure
~/.config/nvim/
├── init.lua
├── lua/
│ ├── fk_plugins/
│ ├── fk_configs/
│ └── fk_autoscripts.lua
All configs are organized under lua/ with proper namespaces for easy maintenance.
🔧 Configuration
FKvim is fully modular and easy to customize:
- Themes, transparency, keymaps, and plugins are modular
- Add plugins via
lazy.nvimininit.lua - Use
lua/fk_configs/andlua/fk_plugins/for custom configuration
📚 Wiki
Explore the 📘 GitHub Wiki to learn:
- ✅ Getting Started
- 🎨 Theme Customization
- 🔌 Plugin Development
- 🧠 LSP and Auto Completion
- 🛠️ Troubleshooting
- ❓ FAQ
🖼️ Preview
Below are interactive previews of FKvim features. Click to expand each section.
<details><summary>🎯 Dashboard</summary> <br> <img width="1687" alt="image" src="https://github.com/user-attachments/assets/e3c0002a-ae74-417d-8391-bb7094f20f06" width="800"/> <br> <em>Minimal FKvim Dashboard with project access, recent files, and shortcuts</em> </details> <details> <summary>🔍 Telescope Fuzzy Finder</summary> <br> <img width="1695" alt="image" src="https://github.com/user-attachments/assets/ffd945c2-1b43-48dc-9b19-cb8f7f3d02d8" /> <br> <em>Fast fuzzy searching for files, text, buffers, and more with Telescope</em> </details> <details> <summary>📁 Fkvim Tree - File Explorer powered by Neo Tree</summary> <br> <img width="1707" alt="image" src="https://github.com/user-attachments/assets/8bd5ce1e-a206-4616-821d-8f55301c5288" /> <br> <em>Modern sidebar with Git integration, diagnostics, and icons</em> </details> <details> <summary>🧠 LSP + Autocomplete</summary> <br> <img width="1423" alt="image" src="https://github.com/user-attachments/assets/b932361a-b5d1-4f13-b303-b0115c58e47f" /> <br> <em>Intelligent suggestions with LSP, snippets, and inline docs</em> </details> <details> <summary>🔔 Noice + Notify UI</summary> <br> <img width="1674" aRelated Skills
clearshot
Structured screenshot analysis for UI implementation and critique. Analyzes every UI screenshot with a 5×5 spatial grid, full element inventory, and design system extraction — facts and taste together, every time. Escalates to full implementation blueprint when building. Trigger on any digital interface image file (png, jpg, gif, webp — websites, apps, dashboards, mockups, wireframes) or commands like 'analyse this screenshot,' 'rebuild this,' 'match this design,' 'clone this.' Skip for non-UI images (photos, memes, charts) unless the user explicitly wants to build a UI from them. Does NOT trigger on HTML source code, CSS, SVGs, or any code pasted as text.
openpencil
2.1kThe world's first open-source AI-native vector design tool and the first to feature concurrent Agent Teams. Design-as-Code. Turn prompts into UI directly on the live canvas. A modern alternative to Pencil.
openpencil
2.1kThe world's first open-source AI-native vector design tool and the first to feature concurrent Agent Teams. Design-as-Code. Turn prompts into UI directly on the live canvas. A modern alternative to Pencil.
ui-ux-designer
Use this agent when you need to design, implement, or improve user interface components and user experience flows. Examples include: creating new pages or components, improving existing UI layouts, implementing responsive designs, optimizing user interactions, building forms or dashboards, analyzing existing UI through browser snapshots, or when you need to ensure UI components follow design system standards and shadcn/ui best practices.\n\n<example>\nContext: User needs to create a new dashboard page for team management.\nuser: "I need to create a team management dashboard where users can view team members, invite new members, and manage roles"\nassistant: "I'll use the ui-ux-designer agent to design and implement this dashboard with proper UX considerations, using shadcn/ui components and our design system tokens."\n</example>\n\n<example>\nContext: User wants to improve the user experience of an existing form.\nuser: "The signup form feels clunky and users are dropping off. Can you improve it?"\nassistant: "Let me use the ui-ux-designer agent to analyze the current form UX and implement improvements using our design system and shadcn/ui components."\n</example>\n\n<example>\nContext: User wants to evaluate and improve existing UI.\nuser: "Can you take a look at our pricing page and see how we can make it more appealing and user-friendly?"\nassistant: "I'll use the ui-ux-designer agent to take a snapshot of the current pricing page, analyze the UX against Notion-inspired design principles, and implement improvements using our design tokens."\n</example>
