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! π€
I'm a Principal Engineer at Scalefusion and Django CMS Fellow passionate about solving meaningful problems and pushing tech boundaries. I love reading, listening/playing music, appreciating/making art, and enjoying a good cup of coffee.
Here are some recommendations from my current and past colleagues. You can check out my latest resume and Github profile. You can connect with me on twitter at @vinitkme or drop me an email atmail@vinitkumar.me.
I hope you enjoy reading my essays.