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.

Features

• 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

Installation

Add this line to your application's Gemfile:

gem 'rubicons'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install rubicons

Icon Collections

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

Icon Library	Version	License	Count	Example Icons
Bootstrap	v1.11.3	MIT	2,050	alarm, heart, calendar, circle, house
Box Icons	Latest	MIT/CC 4.0	1,634	bx-home, bx-search, bx-menu, bx-user, bxl-github
Circum Icons	Latest	MPL-2.0	288	alarm-on, align-center-h, arrow, check, user
Devicon	v2.16.0	MIT	1520	aarch64-line.svg, aarch64-original.svg, aarch64-plain.svg, adonisjs-original-wordmark.svg, adonisjs-original.svg
Feather	v4.29.1	MIT	287	activity, alert-circle, airplay, message-square, star
Font Awesome 5	v5.15.4	Multiple	1,612	brands-github, solid-user, regular-heart, solid-home, solid-star
Font Awesome 6	v6.5.2	Multiple	2,045	brands-github, solid-user, solid-house, solid-flag, solid-shield
Heroicons v1	v1.0.6	MIT	460	outline-academic-cap, outline-archive, solid-home, outline-menu, solid-user
Heroicons v2	v2.1.3	MIT	1,176	16-solid-academic-cap, 24-outline-home, 24-solid-user, 20-solid-calendar, 16-outline-bell
Ionicons 4	v4.6.4-1	MIT	696	ios-add, ios-alarm, ios-home, md-mail, md-menu
Ionicons 5	v5.5.4	MIT	1,332	accessibility, add-circle, home, mail, menu
Line Awesome	Latest	MIT/Good Boy	1,544	500px, accessible-icon, github, user-solid, heart
Lucide	Latest	ISC	1,565	heart, activity, book, check, user
Material Design	v4.0.0	Apache 2.0	6862	action-3d-rotation, action-accessibility, action-account-circle, content-home, action-settings
Octicons	v18.3.0	MIT	576	accessibility-16, alert-16, check-16, code-16, mark-github-16
Phosphor Icons	Latest	MIT	9,072	acorn-bold, user-bold, heart-fill, house-line, calendar
Radix UI	Latest	MIT	318	accessibility, activity-log, align-bottom, align-center-horizontally, bookmark
Remix Icon	v4.2.0	Apache 2.0	2,860	arrow-down-circle-fill, home-line, user-fill, search-line, check-line
Tabler Icons	v3.31.0	MIT	5,880	filled-accessible, filled-home, filled-user, filled-search, brand-github
Themify	v1.0.1	SIL OFL/MIT	352	angle-down, agenda, alarm-clock, alert, align-center
Typicons	v2.1.2	SIL OFL	336	anchor, adjust-brightness, adjust-contrast, archive, heart
Weather Icons	v2.0.12	SIL OFL 1.1	219	wi-alien, wi-barometer, wi-celsius, wi-cloud-refresh, wi-cloud-down

Usage

Standalone Usage

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

require 'rubicons'

Then use any of the icon libraries:

Using Lucide Icons

# 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

Using Bootstrap 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')

Using Font Awesome Icons

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

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

Using Heroicons

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

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

Rails Integration

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' %>

Available Sizes

All icons support the following size options:

Size	Dimensions
:xs	12×12
:sm	16×16
:md	20×20 (default)
:lg	24×24
:xl	32×32
:2xl	40×40

Contributing

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

Code of Conduct

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

License

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