Lira - Free VS Code Theme

A completely free and customizable dark theme for Visual Studio Code. Lira offers beautiful syntax highlighting, extensive customization options, and a rich set of folder icons - all without any licensing restrictions.

✨ Features

🎨 Multiple Theme Variants

• 6 Built-in Variants: Teal, Carbon, Deepforest, Graphene, Ocean, and Palenight
• High Contrast Support: Each variant includes a high contrast version
• Consistent Design: Carefully crafted color schemes optimized for readability

🎯 Customizable Accent Colors

• 14 Predefined Colors: Teal, Coral, White, Tomato, Orange, Yellow, Acid Lime, Lime, Bright Teal, Cyan, Blue, Indigo, Purple, Pink
• Custom Colors: Set any hex color as your accent
• Live Preview: See changes instantly in the status bar
• Easy Access: Click the paintcan icon in the status bar to change colors

📁 Rich Icon Theming

• Folder Icons: Over 47 specialized folder types (api, assets, components, config, docs, etc.)
• Two Styles: Choose between filled or outlined folder icons
• Accent Matching: Folder icons automatically match your selected accent color
• File Icons: Comprehensive file type icons for better file recognition

⚙️ Advanced Customization

• Borders: Toggle UI element borders on/off
• Shadows: Hide or show widget shadows
• Tab Contrast: Enable contrasted tab backgrounds
• Line Highlights: Choose between subtle or solid line highlighting
• Explorer Arrows: Hide or show folder collapse arrows

🚀 Easy to Use

• Status Bar Integration: Quick access to theme settings
• Command Palette: All features accessible via VS Code commands
• Real-time Updates: Changes apply immediately without restart
• No Configuration Required: Works great out of the box

🛠️ Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X or Cmd+Shift+X)
3. Search for "Lira"
4. Click Install
5. Select your preferred Lira theme from the Command Palette (Ctrl+Shift+P → "Preferences: Color Theme")

🎨 Usage

Changing Accent Colors

• Status Bar: Click the paintcan icon in the status bar
• Command Palette: Run "Lira: Select Accent Color"
• Custom Colors: Choose "Use custom accent" and enter a hex color

Theme Customization

Access all customization options through the Command Palette:

• Lira: Toggle Borders
• Lira: Toggle Shadows
• Lira: Toggle Contrasted Tabs
• Lira: Toggle Line Highlights
• Lira: Toggle Explorer Arrows

Icon Styles

• Switch between filled and outlined folder icons
• All folder icons automatically match your accent color
• Specialized icons for common project folders

⚙️ Extension Settings

This extension contributes the following settings:

• liraTheme.accent: The selected accent color
• liraTheme.customAccent: Custom hex color for accent
• liraTheme.showBorders: Enable/disable UI borders
• liraTheme.hidesShadows: Hide widget shadows
• liraTheme.contrastedTabs: Enable contrasted tab backgrounds
• liraTheme.solidLineHighlight: Use solid line highlighting
• liraTheme.hidesExplorerArrows: Hide explorer folder arrows
• liraTheme.useOutlinedIcons: Use outlined folder icons

🚫 No Restrictions

Lira is completely free with no:

• ❌ Trial periods
• ❌ License keys
• ❌ Feature limitations
• ❌ Watermarks
• ❌ Ads or promotions

🐛 Known Issues

None currently reported. Please file issues on the GitHub repository if you encounter any problems.

📝 Release Notes

0.0.1

• Initial release of Lira theme
• 6 theme variants with high contrast support
• 14 accent colors + custom color support
• Complete folder icon set with accent matching
• Advanced customization options
• Status bar integration

🤝 Contributing

Contributions are welcome! Please feel free to submit issues and enhancement requests.

📄 License

This project is completely free and open source.

---

Enjoy coding with Lira! 🎉