phlex-icons-bootstrap 0.14.0 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5826056ba49814337843f2d79a4c920ac300c5303c70febc1e983bf85d068c2b
-  data.tar.gz: 4b8bf9e978cea1a27f6dc8c715003fdb48f7f680398e0c2b723f243eea2d6564
+  metadata.gz: 65f2a34ec60f3f1131a3eeea0113b62fdc306f414d336c72920c8ab94aa86290
+  data.tar.gz: 981994a6bb17777baf92a257ec9bf994b6a6d3c0a66eddab60babc84d10058f5
 SHA512:
-  metadata.gz: 9b3bc31bcad2a6d54bfb455c874f585292fad41907bfa43f03c65f95bd4837e51769e1e59835ca28ae18c9e0772ec6b06fee1f2db6b756f9fd077813401c4612
-  data.tar.gz: bd785c823342e8927242f82b3407fe08aba83db3eeb631ccee5a8f6f93d9eddb1d56288ddfca3d9e8bb4f629a9f7c4d1d29e4fb54fe00c7599d9235be18952c7
+  metadata.gz: 54345d4be5b8ede6217016396bb092348d5cae5d85dc4e73743ad4118ba037e96b25cd191dbcfe00f8753225d7573b0d0c8b5dec07a8a8bfc8ae3702a3c3e3e1
+  data.tar.gz: 469fce25bc84992b1a5583cb94740ac6500aefdb2910c2fb917299fb5ce1d58d24101eb0cbf58a5cba291aa0d921f47f159a638b347626b7da29bd181ea54f88

data/README.md

@@ -21,6 +21,16 @@ General icons extension for [Phlex](https://phlex.fun). Includes more than 🎨
 
 And happy to extend to other icon packs!
 
+If you don't want to add all icon packs to your application, you can add a specific icon pack by using one (or multiple) of the following gems:
+
+- [phlex-icons-bootstrap](https://rubygems.org/gems/phlex-icons-bootstrap)
+- [phlex-icons-flag](https://rubygems.org/gems/phlex-icons-flag)
+- [phlex-icons-hero](https://rubygems.org/gems/phlex-icons-hero)
+- [phlex-icons-lucide](https://rubygems.org/gems/phlex-icons-lucide)
+- [phlex-icons-radix](https://rubygems.org/gems/phlex-icons-radix)
+- [phlex-icons-remix](https://rubygems.org/gems/phlex-icons-remix)
+- [phlex-icons-tabler](https://rubygems.org/gems/phlex-icons-tabler)
+
 Thanks [nejdetkadir](https://github.com/nejdetkadir) for creating [Phlex::Heroicons](https://github.com/nejdetkadir/phlex-heroicons) as it was the base for this gem.
 
 Other Phlex icon gems:
@@ -41,16 +51,6 @@ If bundler is not being used to manage dependencies, install the gem by executin
 gem install phlex-icons
 ```
 
-If you don't want to add all icon packs to your application, you can add a specific icon pack by using one (or multiple) of the following gems:
-
-- [phlex-icons-bootstrap](https://rubygems.org/gems/phlex-icons-bootstrap)
-- [phlex-icons-flag](https://rubygems.org/gems/phlex-icons-flag)
-- [phlex-icons-hero](https://rubygems.org/gems/phlex-icons-hero)
-- [phlex-icons-lucide](https://rubygems.org/gems/phlex-icons-lucide)
-- [phlex-icons-radix](https://rubygems.org/gems/phlex-icons-radix)
-- [phlex-icons-remix](https://rubygems.org/gems/phlex-icons-remix)
-- [phlex-icons-tabler](https://rubygems.org/gems/phlex-icons-tabler)
-
 ## Configuration
 
 The gem provides global configuration options, and per icons pack configuration options.
@@ -124,7 +124,7 @@ Phlex::Icons::Tabler.configuration.default_variant = :outline # or :filled
 ### With `Phlex::Kit`
 
 ```ruby
-require 'phlex_icons'
+require 'phlex-icons'
 
 class PhlexIcons < Phlex::HTML
   include Phlex::Icons
@@ -146,7 +146,7 @@ end
 ### Without `Phlex::Kit`
 
 ```ruby
-require 'phlex_icons'
+require 'phlex-icons'
 
 class PhlexIcons < Phlex::HTML
   def view_template
@@ -163,6 +163,71 @@ class PhlexIcons < Phlex::HTML
 end
 ```
 
+### Specific icon pack(s)
+
+Let's say you want to use only Heroicons and Flag Icons, you can use the following gems:
+- [phlex-icons-flag](https://rubygems.org/gems/phlex-icons-flag)
+- [phlex-icons-hero](https://rubygems.org/gems/phlex-icons-hero)
+
+Then, in your application, you can use the icons like this:
+
+```ruby
+require 'phlex-icons-flag'
+require 'phlex-icons-hero'
+
+class PhlexIcons < Phlex::HTML
+  include Phlex::Icons # If you want to use Phlex::Kit.
+
+  def view_template
+    div do
+      # With Phlex::Kit.
+      Flag::Sa(variant: :rectangle, classes: 'size-4')
+      Hero::Home(variant: :solid, classes: 'size-4')
+
+      # Without Phlex::Kit.
+      render Phlex::Icons::Flag::Sa.new(variant: :rectangle, classes: 'size-4')
+      render Phlex::Icons::Hero::Home.new(variant: :solid, classes: 'size-4')
+    end
+  end
+end
+```
+
+### Add custom icons to your Rails application
+
+You can extend the gem in your Rails application to add new icons by creating a `phlex/icons/custom` directory inside `views/components` directory. Then, you can create a new component for each icon you want to add. For example:
+
+```ruby
+# app/views/components/phlex/icons/custom/icon_class_name.rb
+
+module Phlex
+  module Icons
+    module Custom
+      class IconClassName < Phlex::Icons::Base
+        def view_template
+          # SVG code here.
+        end
+      end
+    end
+  end
+end
+```
+
+Finally, you will need to create a `Phlex::Icons::Custom` module in `phlex/icons/custom.rb` file to include your custom icons and make them a `Phlex::Kit`:
+
+```ruby
+# app/views/components/phlex/icons/custom.rb
+
+module Phlex
+  module Icons
+    module Custom
+      extend Phlex::Kit
+    end
+  end
+end
+```
+
+Now, you can use your custom icons like any other icon pack as described above.
+
 ## Update icon packs
 
 All icon packs provided in this gem are auto-generated by their generator under [`generators`](/generators) directory. You just need to clone the repo and run the generator for the icon pack you want to update. In future, I'm planning to add GitHub Actions to automatically generate the icon packs and update the gem.

data/lib/phlex/icons/version.rb

@@ -2,6 +2,6 @@
 
 module Phlex
   module Icons
-    VERSION = '0.14.0'
+    VERSION = '0.15.0'
   end
 end

data/lib/{phlex_icons_bootstrap.rb → phlex-icons-bootstrap.rb}

@@ -1,3 +1,6 @@
+# rubocop:disable Naming/FileName
+# rubocop:enable Naming/FileName
+
 # frozen_string_literal: true
 
 require 'phlex'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: phlex-icons-bootstrap
 version: !ruby/object:Gem::Version
-  version: 0.14.0
+  version: 0.15.0
 platform: ruby
 authors:
 - Ali Hamdi Ali Fadel
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-09-02 00:00:00.000000000 Z
+date: 2024-09-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: phlex
@@ -49,6 +49,7 @@ files:
 - generators/radix.rb
 - generators/remix.rb
 - generators/tabler.rb
+- lib/phlex-icons-bootstrap.rb
 - lib/phlex/icons/base.rb
 - lib/phlex/icons/bootstrap.rb
 - lib/phlex/icons/bootstrap/activity.rb
@@ -2104,7 +2105,6 @@ files:
 - lib/phlex/icons/bootstrap/zoom_out.rb
 - lib/phlex/icons/configuration.rb
 - lib/phlex/icons/version.rb
-- lib/phlex_icons_bootstrap.rb
 - phlex-icons.png
 - sig/phlex/icons.rbs
 homepage: https://github.com/AliOsm/phlex-icons