Oscura Vim - My New Favorite Dark Theme
March 28, 2025
Iâve been coding for quite a while now, and one thing that really matters is having a comfortable theme that doesnât strain your eyes. I recently created Oscura Vim, a port of the excellent Oscura Theme for VSCode by the Fey team. The original themeâs meticulously curated accent colors and precisely balanced contrast inspired me to bring this sophisticated coding environment to Vim users. I also sought permission from them before publishing my port.
Of course! đ€ and the port looks great
— T. Costa (@tcosta_co) March 20, 2025
Why Another Dark Theme?
Letâs be honest - there are countless dark themes out there. However, Oscura (originally crafted by the Fey team) stands out because it actually solves real problems. Following the original design principles, Iâve maintained two variants in the Vim port:
- Oscura: A deep, rich dark background (#0B0B0F) thatâs perfect for late-night coding sessions
- Oscura Dusk: A slightly lighter variant (#131419) that works well in various lighting conditions
What I particularly love about this theme is its high contrast and readability. When youâre debugging a tricky issue or reviewing pull requests, the last thing you want is eye strain from poor color choices.
Installation and Setup
Setting up Oscura is straightforward. If youâre using Vim-Plug like I do, just add this to your .vimrc
:
Plug 'vinitkumar/oscura-vim'
For Neovim users with Lazy.nvim (my current setup), you can configure it like this:
{
'vinitkumar/oscura-vim',
lazy = false, -- We want the theme available at startup
}
After installation, activate the theme by adding one of these lines to your .vimrc
:
" I prefer the original dark theme
colorscheme oscura
" Or use the dusk variant if you want slightly higher contrast
colorscheme oscura-dusk
What Makes It Special?
Having used this theme for a while now, hereâs what stands out:
- The syntax highlighting is comprehensive and well-thought-out, especially for TypeScript and JavaScript
- Git diff highlighting is clear and intuitive
- The status line and UI elements are distinct without being distracting
- Search highlighting actually helps you find things instead of hiding them
Real-world Usage
Iâve been using Oscura during my daily coding sessions, and itâs made a noticeable difference. The theme maintains good contrast even during those long debugging sessions when youâre trying to track down a particularly nasty bug. The enhanced TypeScript support is particularly useful since thatâs what I work with most days.
Sometimes, I switch between the original Oscura and Oscura Dusk depending on the time of day and lighting conditions. The Dusk variant works better during daytime, while the original dark theme is perfect for those late-night coding sessions.
A Note on Requirements
Make sure your Vim setup supports true colors - it makes a huge difference in how the theme renders. Youâll need Vim 7.4 or later, but honestly, you should be on a much newer version anyway.
If youâre looking for a comfortable, eye-friendly dark theme that doesnât compromise on readability, give Oscura a try. Itâs become an essential part of my development setup, and I think youâll appreciate it too.
Credits
This Vim colorscheme is based on the Oscura Theme for VSCode created by the Fey team. Their original designâs color palette and principles guided this Vim port. If youâre a VSCode user, I highly recommend checking out their original theme.
Cheers! đ€