⚡ Fkvim

A modern, minimal, and lightning-fast Neovim setup — designed for performance, aesthetics, and developer productivity.

📊 Project Insights

🌟 Stars	🍴 Forks	🐛 Issues	🔔 Open PRs	🔕 Closed PRs	🛠️ Languages	👥 Contributors

✨ 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. 🔥👨‍💻👩‍💻

🚀 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

💡 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

🧠 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.nvim in init.lua
• Use lua/fk_configs/ and lua/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.

🎯 Dashboard

Minimal FKvim Dashboard with project access, recent files, and shortcuts

🔍 Telescope Fuzzy Finder

Fast fuzzy searching for files, text, buffers, and more with Telescope

📁 Fkvim Tree - File Explorer powered by Neo Tree

Modern sidebar with Git integration, diagnostics, and icons

🧠 LSP + Autocomplete

Intelligent suggestions with LSP, snippets, and inline docs

🔔 Noice + Notify UI

Modern notification system and command-line interface using Noice + Notify

📌 Bufferline Navigation

Visual tabs for each open buffer, with Git and diagnostic signs

🧬 Treesitter Highlighting

Accurate and colorful syntax highlighting powered by Treesitter

🧪 Floating Terminal

Run terminals inside Neovim — Python, Git, htop, etc.

🎨 Transparent Theme

FKvim with True transparency and Default Catppuccin Mocha theme

🙏 Credits

FKvim is built with the help of awesome tools:

• lazy.nvim
• catppuccin
• telescope.nvim
• neo-tree.nvim
• noice.nvim
• And many more...

🤝 Contributing

We love contributions from the community! Whether it's a bug report, a new feature, or a documentation improvement, we appreciate your help.

How to Contribute

1. Fork the repository and create a new branch for your changes.
2. Make your changes and ensure everything is working as expected.
3. Submit a pull request with a clear description of your changes.

Found a Bug?

• Check the issue tracker to see if the bug has already been reported.
• If not, open a new issue and provide as much detail as possible.

Have a Feature Idea?

• We'd love to hear it! Open an issue to discuss your idea.

📜 Code of Conduct

Please refer to the Code of Conduct for details on contributing guidelines and community standards.

🤝👤 Contribution Guidelines

We love our contributors! If you'd like to help, please check out our CONTRIBUTE.md file for guidelines.

Thank you once again to all our contributors who has contributed to Fkvim! Your efforts are truly appreciated. 💖👏

See the full list of contributors and their contributions on the GitHub Contributors Graph.

Show some by starring this awesome repository!

💡 Suggestions & Feedback

Feel free to open issues or discussions if you have any feedback, feature suggestions, or want to collaborate!

⭐️🙌 Show Your Support

If you find FKvim project helpful, give it a star! ⭐ to support more such educational initiatives:

• Giving the repo a ⭐ on GitHub
• Sharing it with your developer friends
• Contributing to the project

📄 License

This project is licensed under the MIT License - see the License file for details.

⭐ Stargazers

🍴 Forkers

🧑‍💻Project Admin:

Mayank Kumar Jha

Give us a Star and let's make magic!

👨‍💻 Built with ❤️ by Fkvim Team

❤️ [Mayank Kumar Jha] and [Contributors] ❤️

open an issue | Report Bug

⬆️ Back to Top

Ready to show off your coding achievements? Get started with Fkvim today! 🚀