Releases: uhs-robert/oasis.nvim
Release v2.1.0
✨ New Features
- Add three new light palette variants for light mode options that increase in warmth from
Dawn>Daybreak>Day>Dusk
![]() Daybreak |
![]() Day |
![]() Dusk |
- Add kitty and ghostty extras to support new variants
- Add transparent background toggle
- Add terminal colors toggle
- Add configurable text styling options for
italics,bold,underline,strikethrough, and more.
🔧 Improvements
- Refactor background sync using TokyoNight approach for better reliability
- Standardize color adjustments across all palettes
- Extensive documentation improvements and restructuring
🐛 Bug Fixes
- Prevent stale background value from blocking manual changes
Full Changelog: v2.0.0...v2.1.0
v2.0.0 - Light and Dark Mode (w/ Breaking Changes)! 🎉
🚨 Breaking Changes
📦️ Setup Behavior Changed
setup() no longer automatically applies the theme.
Users must now call vim.cmd.colorscheme('oasis') after setup().
Before:
require('oasis').setup()After:
require('oasis').setup()
vim.cmd.colorscheme('oasis')Note
This aligns Oasis with standard Neovim colorscheme conventions (Catppuccin, Tokyonight, etc.) .
It also gives users more control over the theme application.
🌓 Dark and Light Mode
The style attribute has been upgraded. You no longer need to define style (unless you want to!).
Oasis now respects your system's light/dark mode and will adapt when your background changes in Neovim.
Before:
require('oasis').setup({ style = "lagoon" })After:
require('oasis').setup({ dark_style = "lagoon" , light_style = "dawn" })✨ New Features / Bug Fixes
-
Native support for terminal background detection (DEC mode 2031)
-
Works with Neovim 0.10+ and modern terminals (Kitty, Alacritty, WezTerm, iTerm2)
-
Automatic palette switching based on vim.o.background changes
-
Circular triggering prevention for reliable operation
-
Ghostty: Full theme support for all 14 palette variants
-
Kitty: Complete theme support with refined colors
-
Well-documented extras directory with setup guides
-
Auto-select dark/light style when style is not explicitly configured
-
Defaults: dark_style="lagoon", light_style="dawn"
-
Works seamlessly with auto light/dark mode switching
-
lazy.nvim: Added LazyH1 and LazyH2 highlight groups
-
Modular plugin integration architecture for better maintainability
-
Consolidated plugin highlight loading system
-
Improved background change detection in auto-switch
-
Refined bright terminal colors for better visibility
-
Dawn variant terminal color improvements
-
Standardized formatting and indentation across codebase
-
Better visual palette completion
-
Comprehensive automatic light/dark mode switching guide
-
Extras directory documentation with installation guides
-
Kitty extras setup guide with step-by-step instructions
-
Improved README formatting and clarity
-
Better style switching instructions
-
Refactored to modular integrations/plugins structure
-
Replaced palette_name checks with light_mode flag for clarity
-
Consolidated plugin highlight loading into integrations/init.lua
This release represents a significant evolution of Oasis with better terminal
integration, smarter configuration, and improved reliability. The breaking
change brings Oasis in line with ecosystem standards while the new features
make it more powerful and flexible than ever!
Full Changelog: v1.4.0...v2.0.0
v1.4.0 - Dawn Variant and Terminal Colors
✨ New Features
🌅 Dawn Variant - First Light Mode Theme
Introducing oasis_dawn, the first light mode variant featuring warm yellow-beige tones inspired by dusty desert sand at daybreak.
- Complete light palette with carefully tuned contrast for readability
- Dedicated Lualine theme support
- Available via
:colorscheme oasis-dawnor:Oasis oasis_dawn
🎨 Terminal Color Support
Added comprehensive terminal color definitions (terminal_color_0 through terminal_color_15) to all 14 palette variants for consistent terminal emulator theming within Neovim.
💪 Enhanced Typography
Restructured foreground colors across all palettes with new fg.strong variant for improved text hierarchy (headings, emphasis).
🔧 Improvements
- Config Naming: Standardized configuration option to snake_case (
useLegacyComments) for consistency with Lua conventions - Documentation: Enhanced README with header badges, reorganized layout, and refined project description
- Screenshots: Added Dawn variant screenshots and updated Midnight variant assets
🐛 Bug Fixes
- Fixed hyphen format support in Lualine and Tabby integrations (e.g.,
oasis-desert) - Corrected identifier color in
oasis_nightpalette
📦 Variant Count
Now includes 14 total variants covering the full spectrum from deep blacks to warm light mode.
Full Changelog: v1.3.0...v1.4.0
v1.3.0 - Midnight Theme
🌙 What's New
New Theme Variant
- Midnight - Off-black theme with dark slate tones for deep contrast and maximum readability
Integrations
- Added Kitty terminal integration for midnight variant (
extras/kitty/oasis_midnight.conf) - Added Lualine theme for midnight variant
- Added missing Lualine theme for abyss variant
Documentation
- Added screenshots and gallery entry for midnight variant
- Restructured README theme gallery to 4-column layout
- Clarified Night and Midnight variant color descriptions
📦 Installation
-- lazy.nvim
{ "uhs-robert/oasis.nvim" }Then set the colorscheme:
vim.cmd.colorscheme('oasis-midnight')
-- or use the default (lagoon) and switch with :Oasis oasis_midnightFull Changelog: v1.2.0...v1.3.0
v1.2.0
What's New
Features
- Configuration System: Add comprehensive user configuration with palette and highlight group overrides
- Style Shorthand: New
styleconfig option for convenient palette selection (e.g.,style = "lagoon") - Auto-apply Theme: Theme now applies automatically when
setup()is called
Improvements
- Fix palette name format conversion to use hyphens in
vim.g.colors_name(Neovim convention) - Enhance README with detailed configuration and setup examples
- Refactor comment color handling for oasis_desert palette
- Update file path reference for desert variant
Configuration Example
```lua
require('oasis').setup({
style = "lagoon", -- Shorthand for "oasis_lagoon"
palette_overrides = {
oasis_lagoon = {
bg = { core = "#001122" }
}
},
highlight_overrides = {
Comment = { italic = true }
}
})
```
Full Changelog: v1.1.0...v1.2.0
v1.0.0: Complete Oasis Colorscheme
Oasis v1.0.0 🏜️
Complete Neovim colorscheme with 12 desert-themed palette variants.
Features
- 12 palette variants covering the entire color spectrum with desert inspiration
- Zero dependencies - Works out of the box without external plugins
- Fast loading - Direct highlight application using
vim.api.nvim_set_hl() - Comprehensive coverage - LSP, Tree-sitter, diagnostics, and plugin support
- Plugin integrations - Automatic Lualine and Tabby theme support
- Easy switching -
:Oasis <variant>command with tab completion - Semantic color organization - Cold/warm/neutral structure for intuitive theming
Available Variants
From darkest to lightest:
oasis_night- Deep desert night sky (off black)oasis_abyss- Deep, dark variant with mysterious depths (black)oasis_starlight- Desert abyss illuminated by brilliant starlight (black vivid)oasis_desert- Classic vim desert theme inspired (grey)oasis_sol- Hot, scorching desert sun (red)oasis_canyon- Rich oranges of desert canyon walls (orange)oasis_dune- Sandy beiges and warm yellow earth tones (yellow)oasis_cactus- Fresh greens of desert vegetation (green)oasis_mirage- Cool teals of shimmering desert mirages (teal)oasis_lagoon- Cool blues of the oasis lagoon (blue) [Default]oasis_twilight- Evening desert with purple and indigo hues (purple)oasis_rose- Soft pinks of the warm desert rose (pink)
Installation
-- lazy.nvim
{ "uhs-robert/oasis.nvim" }
-- Set colorscheme
vim.cmd.colorscheme('oasis')
-- Optional: Set default palette
vim.g.oasis_palette = 'oasis_lagoon'Usage
:colorscheme oasis
:Oasis oasis_desert " Switch to desert variant
:Oasis oasis_rose " Switch to rose variantWhat's Changed
- Refactored architecture removing deprecated Shipwright export system
- Enhanced documentation with comprehensive theme showcase
- Improved README organization with visual examples
- Added plugin integrations section for Lualine and Tabby
- Reorganized theme variants by darkness level for better navigation


