🚀 Getting Started
███████████ ███████████ █████ █████ █████ ██████ ██████
░░███░░░░░░█░█░░░███░░░█░░███ ░░███ ░░███ ░░██████ ██████
░███ █ ░ ░ ░███ ░ ░███ ░███ ░███ ░███░█████░███
░███████ ░███ ░███ ░███ ░███ ░███░░███ ░███
░███░░░█ ░███ ░░███ ███ ░███ ░███ ░░░ ░███
░███ ░ ░███ ░░░█████░ ░███ ░███ ░███
█████ █████ ░░███ █████ █████ █████
░░░░░ ░░░░░ ░░░ ░░░░░ ░░░░░ ░░░░░
Welcome to FtVim! 🎉
FtVim is a modern Neovim distribution designed for developers. Originally created for 42 Barcelona students, it provides a complete IDE experience out of the box with sensible defaults, easy customization and tools for the 42 curriculum.
✨ Features
- Modern Plugin Management - Powered by lazy.nvim
- Fast Fuzzy Finding - File search, grep, and more with snacks.nvim, which also powers the dashboard, notifications and terminal
- LSP Support - Auto-completion, diagnostics, and code actions with blink.cmp
- Linting and Formatting - nvim-lint and conform.nvim, with format on save one keymap away (
<leader>uf) - Git Integration - Git signs, blame, and diff with gitsigns.nvim
- Beautiful UI - Catppuccin colorscheme, bufferline, and statusline
- 42 School Tools - Norminette while you type, 42 header, exam mode, pre-submission checks, valgrind, a smart clangd and more (42 extra)
- Extras - Optional packs for C++, Docker, web, Python, debugging and Copilot, enabled with
:FtVimExtras
🛠️ Prerequisites
Before installing FtVim, ensure you have the following:
| Requirement | Minimum Version | Notes |
|---|---|---|
| Neovim | 0.11.0 | Required for modern LSP features |
| Git | 2.19.0 | For plugin management |
| Nerd Font | Any | For proper icon rendering |
| ripgrep | Any | For fast file searching |
| C compiler | Any | To build treesitter parsers (cc, gcc or clang) |
The installer takes care of Neovim, ripgrep and the Nerd Font for you, without root. It works on 42 campus machines.
⭐ Quick Install Commands
Everything at once
curl -fsSL https://raw.githubusercontent.com/FtVim/FtVim/main/scripts/install.sh | bash
Only Neovim
bash <(curl -s https://raw.githubusercontent.com/FtVim/FtVim/main/scripts/install-neovim.sh)
Only ripgrep
bash <(curl -s https://raw.githubusercontent.com/FtVim/FtVim/main/scripts/install-ripgrep.sh)
Both scripts install into ~/.local/bin (no root needed), verify the download checksum and work on Linux and macOS (x86_64 and arm64).
Install a Nerd Font
The installer adds JetBrainsMono Nerd Font. To pick another one, download a Nerd Font of your choice. Popular options include:
- JetBrainsMono Nerd Font
- FiraCode Nerd Font
- Hack Nerd Font
After installation, configure your terminal to use the Nerd Font.
🚀 Next Steps
Ready to install? Head to the Installation guide!