simple icons

.ex_icon.exs

@@ -6,5 +6,13 @@
     module_path: "output/lucide.ex",
     module_name: MyAppWeb.Components.Lucide,
     attrs: ["stroke"]
+  ],
+  simple_icons: [
+    icons: ["helix", "mastodon"],
+    provider: ExIcon.SimpleIcons,
+    version: "16.15.0",
+    module_path: "output/simple_icons.ex",
+    module_name: MyAppWeb.Components.SimpleIcons,
+    attrs: []
   ]
 ]

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 ## Unreleased
 
+## [0.3.0] - 2026-04-10
+
+### Added
+
+- Add provider for Simple Icons.
+- Add `--icon-set` flag to `mix ex_icon.gen.icons`.
+
+### Changed
+
+- Change `c:ExIcon.Provider.svg_folder/0` to `c:ExIcon.Provider.svg_folder/1`,
+  with the argument being the version.
+
 ## [0.2.0] - 2026-04-10
 
 ### Changed

README.md

@@ -18,7 +18,7 @@ Add `ex_icon` to your list of dependencies in `mix.exs`:
 ```elixir
 def deps do
   [
-    {:ex_icon, "~> 0.2.0", only: :dev}
+    {:ex_icon, "~> 0.3.0", only: :dev}
   ]
 end
 ```
@@ -111,8 +111,10 @@ substantially by adding attributes.
 ## Providers
 
 Providers for specific icon libraries are based on the `ExIcon.Provider`
-behaviour. Currently, ExIcon includes a single provider for
-[Lucide](https://lucide.dev/).
+behaviour. The library currently supports these providers:
+
+- [Lucide](https://lucide.dev/)
+- [Simple Icons](https://simpleicons.org/)
 
 ## Contributing
 

lib/ex_icon.ex

@@ -235,7 +235,7 @@ defmodule ExIcon do
     provider_name = provider_name(provider)
 
     tmp_dir = Path.join([tmp_dir, provider_name, version])
-    tmp_svg_dir = Path.join(tmp_dir, provider.svg_folder())
+    tmp_svg_dir = Path.join(tmp_dir, provider.svg_folder(version))
 
     clear_folder!(tmp_dir)
 

lib/ex_icon/lucide.ex

@@ -1,6 +1,8 @@
 defmodule ExIcon.Lucide do
   @moduledoc """
   ExIcon provider for Lucide icons.
+
+  https://lucide.dev
   """
 
   @behaviour ExIcon.Provider
@@ -11,7 +13,7 @@ defmodule ExIcon.Lucide do
   end
 
   @impl true
-  def svg_folder do
+  def svg_folder(_) do
     "icons"
   end
 end

lib/ex_icon/provider.ex

@@ -14,5 +14,5 @@ defmodule ExIcon.Provider do
   @doc """
   Returns the folder that contains the SVG files in the unpacked release.
   """
-  @callback svg_folder() :: String.t()
+  @callback svg_folder(version) :: String.t() when version: String.t()
 end

lib/ex_icon/simple_icons.ex

@@ -0,0 +1,19 @@
+defmodule ExIcon.SimpleIcons do
+  @moduledoc """
+  ExIcon provider for Simple Icons.
+
+  https://simpleicons.org
+  """
+
+  @behaviour ExIcon.Provider
+
+  @impl true
+  def release_url(version) when is_binary(version) do
+    "https://github.com/simple-icons/simple-icons/archive/refs/tags/#{version}.zip"
+  end
+
+  @impl true
+  def svg_folder(version) do
+    "simple-icons-#{version}/icons"
+  end
+end

lib/mix/tasks/ex_icon.gen.icons.ex

@@ -8,20 +8,36 @@ defmodule Mix.Tasks.ExIcon.Gen.Icons do
 
   ## Usage
 
-      mix ex_icon.gen
+  Download and generate icons for all configured providers:
+
+      mix ex_icon.gen.icons
+
+  Download and generate icons for a single named provider:
+
+      mix ex_icon.gen.icons --icon-set lucide
+
+  The value must reference one of the top level keys in your configuration
+  file.
   """
 
   use Mix.Task
 
+  @switches [
+    strict: [
+      icon_set: :string
+    ]
+  ]
+
   @tmp_dir "ex_icon"
 
   @impl Mix.Task
-  def run(_) do
+  def run(args) do
+    {opts, []} = OptionParser.parse!(args, @switches)
+
     case ExIcon.read_config() do
       {:ok, config} ->
         tmp_dir = Path.join([System.tmp_dir!(), @tmp_dir])
-        download_and_generate_all(config, tmp_dir)
-
+        do_run(config, tmp_dir, opts[:icon_set])
         IO.puts("Done.")
 
       {:error, reason} ->
@@ -35,6 +51,28 @@ defmodule Mix.Tasks.ExIcon.Gen.Icons do
     end
   end
 
+  defp do_run(config, tmp_dir, nil) do
+    download_and_generate_all(config, tmp_dir)
+  end
+
+  defp do_run(config, tmp_dir, icon_set) when is_binary(icon_set) do
+    icon_set = String.to_atom(icon_set)
+
+    if opts = Keyword.get(config, icon_set) do
+      download_and_generate({icon_set, opts}, tmp_dir)
+    else
+      IO.puts("""
+      Icon set #{icon_set} not found in configuration.
+
+      Available icon sets:
+
+          #{inspect(Keyword.keys(config))}
+      """)
+
+      exit({:shutdown, 1})
+    end
+  end
+
   defp download_and_generate_all(config, tmp_dir) do
     Enum.each(config, &download_and_generate(&1, tmp_dir))
   after

mix.exs

@@ -2,7 +2,7 @@ defmodule ExIcon.MixProject do
   use Mix.Project
 
   @source_url "https://github.com/woylie/ex_icon"
-  @version "0.2.0"
+  @version "0.3.0"
 
   def project do
     [