A collection of elegant, cohesive themes for Neovim by Black Atom Industries
This repository is a Neovim adapter for the Black Atom theme ecosystem. In the Black Atom architecture:
- The core repository is the single source of truth for all theme definitions
- Each adapter implements these themes for a specific platform (Neovim, VS Code, Alacritty, etc.)
- The adapter uses templates to transform core theme definitions into platform-specific files
This modular approach ensures consistent colors and styling across all supported platforms while allowing for platform-specific optimizations.
Black Atom includes multiple theme collections, each with its own distinct style:
| Collection | Themes | Description |
|---|---|---|
| Stations | engineering, operations, medical, research | Space station-inspired themes |
| JPN | koyo-hiru, koyo-yoru, tsuki-yoru | Japanese-inspired themes |
| Terra | seasons (spring, summer, fall, winter) × time (day, night) | Earth season-inspired themes |
| CRBN | null, supr | Minimalist carbon themes |
All themes are available in both dark and light variants.
Install the plugin with your preferred package manager:
{
"black-atom-industries/nvim",
name = "black-atom",
priority = 1000, -- Load before other start plugins
opts = {
-- Configuration options
theme = "black-atom-jpn-koyo-yoru", -- Default theme
transparent = false, -- Enable transparent background
contrast = false, -- Enable high contrast mode
},
}Plug 'black-atom-industries/nvim'
" In your init.vim or .vimrc
lua << EOF
require('black-atom').setup({
theme = "black-atom-jpn-koyo-yoru",
transparent = false,
contrast = false,
})
EOFrequire('black-atom').setup({
-- Default theme (will be used when Neovim starts)
theme = "black-atom-jpn-koyo-yoru",
-- Enable transparent background
transparent = false,
-- Enable high contrast mode
contrast = false,
-- Override specific highlight groups
overrides = {
-- Add your highlight overrides here
-- Example: Normal = { bg = "#000000" }
},
})Click to expand supported plugins list
This theme supports the following plugins:
Contributions are welcome! If you'd like to add support for additional plugins or improve existing themes:
- Fork the repository
- Create a feature branch
- Make your changes
- Create a pull request
See CONTRIBUTION.md for detailed guidelines.
- Minimize default highlight assignments
- The default assignment and links should be used as far as possible
- Make API stable
- Dediated Black Atom Colorscheme Picker
Clone the repository:
git clone https://github.com/black-atom-industries/nvim.git
cd nvimsh check.shThe theme files are adapted from templates using the Black Atom Core CLI. To modify themes:
- Edit the template files in
lua/black-atom/themes/{collection}/ - Run the Core CLI to adapt the theme files:
cd /path/to/black-atom-core black-atom-core adapt
MIT - See LICENSE for details
- Black Atom Core - Core theme definitions
- Black Atom for Ghostty - Ghostty terminal adapter
- Black Atom for Zed - Zed editor adapter
- Black Atom for Obsidian - Obsidian adapter