update readme

Author: vinitkumar

README.md

@@ -1,74 +1,225 @@
-# Oscura Vim Colorscheme
+# Oscura Vim Colorscheme Collection
 
-A dark colorscheme for Vim based on a VSCode theme. Oscura provides a comfortable, eye-friendly dark theme that maintains good contrast and readability.
+A comprehensive collection of colorschemes for Vim/Neovim based on the popular VSCode Oscura theme. This collection provides comfortable, eye-friendly themes that maintain excellent contrast and readability for both dark and light environments.
 
-Based on this great Theme [Oscura](https://marketplace.visualstudio.com/items?itemName=Fey.oscura) for VScode. Please go and add a star there https://github.com/narative/oscura
+> **Based on:** [Oscura](https://marketplace.visualstudio.com/items?itemName=Fey.oscura) for VSCode by Fey. Please show your support by starring the [original repository](https://github.com/narative/oscura)!
 
-## Screenshot
+## 🌟 Available Themes
 
-![screenshot](./nvim2.png)
-![screenshot](./nvim3.png)
+### 🌙 Dark Themes
 
-## Features
+#### `oscura` - Classic Dark
+The original dark theme, perfect for low-light environments and extended coding sessions. Features a balanced color palette with excellent contrast.
 
-- Dark theme optimized for long coding sessions
-- High contrast for better readability
-- Syntax highlighting for multiple programming languages
-- Support for common Vim UI elements (status line, line numbers, etc.)
-- Git diff highlighting
-- Search and visual mode highlighting
+#### `oscura-dusk` - Dark Dusk
+A warmer dark variant with dusk-inspired colors. Ideal for those who prefer warmer tones while maintaining the dark aesthetic.
 
-## Installation
+### ☀️ Light Themes
 
-### Manual Installation
+#### `oscura-light` - Classic Light
+A clean, modern light theme designed for bright environments. Provides excellent readability with a professional appearance.
 
-1. Download the `oscura.vim` file
-2. Place it in your `~/.vim/colors/` directory (create the directory if it doesn't exist)
+#### `oscura-dusk-light` - Light Dusk
+A warm light variant with dusk-inspired colors. Perfect for users who want the benefits of a light theme with warmer, more comfortable tones.
 
-```bash
-mkdir -p ~/.vim/colors
-cp oscura.vim ~/.vim/colors/
-```
+## 📸 Screenshots
+
+### Dark Themes
+| oscura (Dark) | oscura-dusk (Dark Dusk) |
+|---------------|-------------------------|
+| ![oscura dark](./nvim2.png) | ![oscura dark](./nvim3.png) |
+
+### Light Themes
+| oscura-light | oscura-dusk-light |
+|--------------|-------------------|
+| ![oscura light](./oscura-light.png) | ![oscura dusk light](./oscura-dusk-light.png) |
+
+## ✨ Features
+
+- **4 Complete Themes**: 2 dark + 2 light variants
+- **Optimized for Productivity**: Designed for long coding sessions
+- **High Contrast**: Excellent readability in all lighting conditions
+- **Comprehensive Syntax Highlighting**: Support for 50+ programming languages
+- **Modern UI Support**: Status lines, line numbers, popup menus, and more
+- **Git Integration**: Enhanced diff highlighting and merge conflict markers
+- **Search & Visual Mode**: Clear highlighting for search results and selections
+- **Plugin Compatibility**: Works with popular plugins like LSP, Treesitter, and more
 
-### Using a Plugin Manager
+## 🚀 Installation
+
+### Method 1: Plugin Manager (Recommended)
 
 #### Vim-Plug
-Add this to your `.vimrc`:
+Add to your `.vimrc`:
 ```vim
 Plug 'vinitkumar/oscura-vim'
 ```
 
-#### Packer
-Add this to your Neovim config:
+#### Packer.nvim
+Add to your Neovim config:
 ```lua
 use 'vinitkumar/oscura-vim'
 ```
 
 #### Lazy.nvim
-Add this to your Neovim config:
+Add to your Neovim config:
 ```lua
 {
   'vinitkumar/oscura-vim',
-  lazy = false, -- Load during startup
+  lazy = false, -- Load during startup for immediate availability
 }
 ```
 
-## Usage
+#### Vundle
+Add to your `.vimrc`:
+```vim
+Plugin 'vinitkumar/oscura-vim'
+```
+
+### Method 2: Manual Installation
+
+1. **Clone or download** this repository
+2. **Copy the theme files** to your colors directory:
+
+```bash
+# For Vim
+mkdir -p ~/.vim/colors
+cp colors/oscura*.vim ~/.vim/colors/
+
+# For Neovim
+mkdir -p ~/.config/nvim/colors
+cp colors/oscura*.vim ~/.config/nvim/colors/
+```
+
+### Method 3: Download Individual Themes
+
+If you only want specific themes, download them individually:
+
+```bash
+# Download specific themes
+curl -o ~/.vim/colors/oscura.vim https://raw.githubusercontent.com/vinitkumar/oscura-vim/main/colors/oscura.vim
+curl -o ~/.vim/colors/oscura-light.vim https://raw.githubusercontent.com/vinitkumar/oscura-vim/main/colors/oscura-light.vim
+# ... and so on for other themes
+```
+
+## 🎨 Usage
+
+### Basic Usage
+
+Add one of these lines to your `.vimrc` or Neovim config:
 
-Add this line to your `.vimrc`:
 ```vim
+" Dark themes
+colorscheme oscura          " Classic dark
+colorscheme oscura-dusk     " Dark dusk variant
+
+" Light themes  
+colorscheme oscura-light    " Classic light
+colorscheme oscura-dusk-light " Light dusk variant
+```
+
+### Advanced Configuration
+
+#### Auto-switching Based on Time
+```vim
+function! SetOscuraTheme()
+  let hour = str2nr(strftime('%H'))
+  if hour >= 6 && hour < 18
+    " Daytime - use light theme
+    colorscheme oscura-light
+  else
+    " Nighttime - use dark theme
+    colorscheme oscura
+  endif
+endfunction
+
+" Call on startup
+call SetOscuraTheme()
+
+" Optional: Auto-switch every hour
+autocmd CursorHold * call SetOscuraTheme()
+```
+
+#### Neovim Lua Configuration
+```lua
+-- In your init.lua or colorscheme config
+local function set_oscura_theme()
+  local hour = tonumber(os.date('%H'))
+  if hour >= 6 and hour < 18 then
+    vim.cmd('colorscheme oscura-light')
+  else
+    vim.cmd('colorscheme oscura')
+  end
+end
+
+-- Set theme on startup
+set_oscura_theme()
+
+-- Optional: Auto-switch every hour
+vim.timer.start(3600000, set_oscura_theme, {repeat = true})
+```
+
+#### Terminal Integration
+For better terminal integration, ensure your terminal supports true colors:
+
+```vim
+" Add to your .vimrc
+set termguicolors
+set background=dark  " or 'light' for light themes
 colorscheme oscura
 ```
 
-## Requirements
+## 🔧 Requirements
+
+- **Vim**: 7.4 or later
+- **Neovim**: 0.5 or later
+- **Terminal**: True color support (recommended)
+- **GUI**: Any Vim GUI (GVim, MacVim, etc.)
+
+### Checking True Color Support
+```bash
+# Test if your terminal supports true colors
+curl -s https://raw.githubusercontent.com/termstandard/colors/master/256colors2.pl | perl
+```
+
+## 🎯 Plugin Compatibility
+
+These themes work well with popular plugins:
+
+- **LSP**: Language Server Protocol highlighting
+- **Treesitter**: Advanced syntax highlighting
+- **Git**: Fugitive, Gitsigns, etc.
+- **Status Lines**: Lightline, Airline, Lualine
+- **File Explorers**: NERDTree, Nvim-tree
+- **Fuzzy Finders**: FZF, Telescope
+
+## 🤝 Contributing
+
+Contributions are welcome! Here's how you can help:
+
+1. **Report Issues**: Found a bug or have a suggestion? Open an issue!
+2. **Submit Pull Requests**: Improvements, new features, or bug fixes
+3. **Share Screenshots**: Show off your setup with different themes
+4. **Improve Documentation**: Help make the README even better
+
+### Development Setup
+```bash
+git clone https://github.com/vinitkumar/oscura-vim.git
+cd oscura-vim
+# Make your changes
+# Test with: vim -u NONE -c 'colorscheme oscura'
+```
+
+## 📄 License
 
-- Vim 7.4 or later
-- True color support (recommended)
+MIT License - see [LICENSE](LICENSE) file for details.
 
-## License
+## 🙏 Acknowledgments
 
-MIT License - see LICENSE file for details
+- **Original Theme**: [Oscura](https://github.com/narative/oscura) by Fey
+- **VSCode Extension**: [Oscura](https://marketplace.visualstudio.com/items?itemName=Fey.oscura)
+- **Community**: All contributors and users who provide feedback
 
-## Contributing
+---
 
-Contributions are welcome! Please feel free to submit a Pull Request.
+**⭐ If you like this colorscheme collection, please give it a star!**