iB-theme

IBM-inspired code editor theme for Cursor IDE, GNU Emacs and VIM.

🎨 Overview

iB-theme is a professional color scheme based on IBM's Carbon Design System, providing both dark and light variants optimized for coding productivity and visual comfort. Designed with enterprise development environments in mind, it offers exceptional readability and a modern aesthetic.

✨ Features

• 🎯 IBM Carbon Design System inspired color palette
• 🌓 Dark and Light variants for different preferences and lighting conditions
• 👁️ Optimized for readability with high contrast and carefully selected colors
• 🔧 Multi-editor support - Works with Cursor IDE, GNU Emacs, and VIM/Neovim
• 💼 Professional appearance suitable for enterprise development environments
• ♿ Accessibility focused with WCAG compliant color contrasts
• 🚀 Performance optimized for smooth editing experience

📦 Installation

Method 1: VS Code Marketplace (Coming Soon)

# Will be available via VS Code marketplace
code --install-extension ib-theme.ib-theme

Method 2: Manual Installation

Cursor IDE / VS Code

1. Download the latest release:

   # Clone the repository
   git clone https://github.com/JohnThre/iB-theme.git
   cd iB-theme
   

2. Install using the provided script:

   chmod +x install.sh
   ./install.sh
   

3. Or install manually:

   • Copy the theme folder to your extensions directory:
     • macOS: ~/.vscode/extensions/ or ~/.cursor/extensions/
     • Windows: %USERPROFILE%\.vscode\extensions\ or %USERPROFILE%\.cursor\extensions\
     • Linux: ~/.vscode/extensions/ or ~/.cursor/extensions/

4. Activate the theme:

   • Restart your editor
   • Go to File > Preferences > Color Theme (or Cmd/Ctrl + K, Cmd/Ctrl + T)
   • Select "iB-theme Dark" or "iB-theme Light"

GNU Emacs

GNU ELPA (Recommended):

;; Coming soon to GNU ELPA!
;; Once available, install via:
M-x package-install RET ib-theme RET

;; Then load a theme:
(load-theme 'ib-theme-dark t)
;; or
(load-theme 'ib-theme-light t)

Automatic Installation (Current):

cd emacs
./install-emacs.sh

Manual Installation:

# Copy theme files
mkdir -p ~/.emacs.d/themes
cp emacs/ib-theme-*-theme.el ~/.emacs.d/themes/

# Add to your init.el
echo "(add-to-list 'custom-theme-load-path \"~/.emacs.d/themes\")" >> ~/.emacs.d/init.el
echo "(load-theme 'ib-theme-dark t)  ; or 'ib-theme-light" >> ~/.emacs.d/init.el

Interactive Loading:

M-x load-theme RET ib-theme-dark RET

For detailed Emacs installation and usage instructions, see emacs/README.md.

GNU ELPA Submission Status: The iB-theme package has been prepared for GNU ELPA submission with proper copyright assignment and package formatting. See GNU-ELPA-SUBMISSION.md for details.

VIM/Neovim

Automatic Installation (Recommended):

cd vim
chmod +x install-vim.sh
./install-vim.sh

Manual Installation:

# Create colors directory
mkdir -p ~/.vim/colors

# Copy theme files
cp vim/colors/ib-theme-dark.vim ~/.vim/colors/
cp vim/colors/ib-theme-light.vim ~/.vim/colors/

# Add to your .vimrc
echo "colorscheme ib-theme-dark" >> ~/.vimrc
# or for light theme
echo "colorscheme ib-theme-light" >> ~/.vimrc

Plugin Manager Installation:

" Vim-Plug
Plug 'JohnThre/iB-theme', {'rtp': 'vim/'}

" Vundle
Plugin 'JohnThre/iB-theme'

Interactive Loading:

:colorscheme ib-theme-dark
" or
:colorscheme ib-theme-light

For detailed VIM installation and usage instructions, see vim/README.md.

🎨 Color Palette

Dark Theme

Light Theme

🔧 Supported Languages

The theme provides optimized syntax highlighting for:

Web Technologies: JavaScript, TypeScript, HTML, CSS, SCSS, JSON, YAML
Systems Programming: C, C++, Rust, Go
Mobile Development: Swift, Dart, Java, Kotlin
Data Science: Python, R, SQL
Documentation: Markdown, reStructuredText
Configuration: TOML, INI, XML
And many more...

🚀 Development

Building from Source

# Clone the repository
git clone https://github.com/JohnThre/iB-theme.git
cd iB-theme

# Install VS Code Extension Manager
npm install -g @vscode/vsce

# Package the extension
vsce package

# Install locally
code --install-extension ib-theme-1.0.0.vsix

Testing

# Validate JSON files
npm install -g jsonlint
jsonlint themes/ib-theme-dark.json
jsonlint themes/ib-theme-light.json

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Quick Start for Contributors

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes and test thoroughly
4. Commit your changes: git commit -m 'Add amazing feature'
5. Push to the branch: git push origin feature/amazing-feature
6. Open a Pull Request

📋 Roadmap

• [x] VS Code/Cursor IDE support
• [x] Dark and Light themes
• [x] GNU Emacs support (v1.0.0) ✨ NEW!
• [x] GNU ELPA preparation (v1.0.0) ✨ NEW!
• [x] VIM/Neovim support (v1.1.0) ✨ NEW!
• [ ] GNU ELPA submission (pending FSF copyright assignment)
• [ ] JetBrains IDEs support (v1.2.0)
• [ ] Sublime Text support (v1.2.0)
• [ ] Additional color variants (v2.0.0)

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

👨‍💻 Author

iB-theme Team
📧 Email: jnc@freew.org
🐙 GitHub: @JohnThre

🙏 Acknowledgments

• 🎨 Inspired by IBM's Carbon Design System
• 🎯 Colors based on IBM Design Language
• 💡 Built for modern development workflows
• 🇺🇸 Made with ❤️ in the USA

📊 Stats

⭐ Star this repository if you find it useful!