Rubicons

Rubicons is a lightweight, pure Ruby SVG icon toolkit inspired by React Icons. It provides a simple and consistent way to include beautiful SVG icons in your Ruby and Rails applications without external dependencies.

• Pure Ruby implementation - no JavaScript dependencies
• SVG-based icons - scalable without quality loss
• Multiple icon libraries - access thousands of icons from popular icon sets
• Rails integration - seamlessly works with Rails via helper methods
• Customizable - easily change size, color, and add CSS classes

Add this line to your application's Gemfile:

gem 'rubicons'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install rubicons

Rubicons provides access to 23 popular icon libraries with thousands of icons:

You can use Rubicons in any Ruby application without Rails. First, require the gem:

require 'rubicons'

Then use any of the icon libraries:

# Get an icon with default options (medium size)
svg = Rubicons::Lucide.icon('heart')

# With custom size
svg = Rubicons::Lucide.icon('heart', size: :lg)

# With custom class
svg = Rubicons::Lucide.icon('heart', class: 'text-red-500')

# List all available icons
icon_names = Rubicons::Lucide.available_icons

# Get an icon with default options
svg = Rubicons::Bootstrap.icon('heart-fill')

# With custom size
svg = Rubicons::Bootstrap.icon('heart-fill', size: :xl)

# With custom class
svg = Rubicons::Bootstrap.icon('heart-fill', class: 'text-danger')

# Font Awesome 5
svg = Rubicons::FontAwesome5.icon('solid-paper-plane')

# Font Awesome 6
svg = Rubicons::FontAwesome6.icon('solid-user-nurse')

# Heroicons v1
svg = Rubicons::Heroicons.icon('outline-folder-remove')

# Heroicons v2
svg = Rubicons::Heroicons2.icon('16-solid-tv')

In a Rails application, Rubicons automatically integrates with ActionView to provide helper methods for each icon library:

<%# Lucide Icons %>
<%= lucide_icon 'heart', class: 'text-red-500', size: :lg %>

<%# Radix Icons %>
<%= radix_icon 'heart', class: 'icon-primary' %>

<%# Bootstrap Icons %>
<%= bootstrap_icon 'heart-fill', class: 'text-danger' %>

<%# Box Icons %>
<%= box_icon 'bx-home' %>

<%# Font Awesome 5 %>
<%= fa5_icon 'solid-paper-plane', size: :xl %>

<%# Font Awesome 6 %>
<%= fa6_icon 'solid-user-nurse' %>

<%# Heroicons v1 %>
<%= heroicon 'outline-folder-remove' %>

<%# Heroicons v2 %>
<%= heroicon2 '16-solid-tv' %>

<%# Circum Icons %>
<%= circum_icon 'arrow' %>

<%# Feather Icons %>
<%= feather_icon 'activity' %>

<%# Ionicons 4 %>
<%= ion4_icon 'home' %>

All icons support the following size options:

Bug reports and pull requests are welcome on GitHub at https://github.com/insomnius/rubicons.

Code of conduct is based on the Contributor Covenant, version 2.0. Please read it to understand our expectations for participants.

The gem is available as open source under the terms of the MIT License.