Seed icons is an open-source icon set that makes tracking down and using optimized, quality, consistent brand SVG icons a little less painful.
Seed icons are available in a few different capacities:
Library of optimized SVG files for download on seedicons.com.
A consumable Figma component library for use in your designs. To use the components, log in to your Figma account and duplicate the file to your drafts.
This repository that supplies a simplified API for use in your projects. SVGs can also be imported individually through the seed-icons/dist/icons/...
folder.
View a live CodeSandbox example of fundamental HTML implementation.
<!DOCTYPE html>
<html>
<script src="https://unpkg.com/seed-icons"></script>
<body>
<i data-seed="google-plus"></i>
<i data-seed="github"></i>
<i data-seed="figma" height="60px" width="60px"></i>
<script>
seed.replace()
</script>
</body>
</html>
- Add a link to the icons library to your project using
unpkg
. After including the script,seed
will be available as a global variable.
<script src="https://unpkg.com/seed-icons"></script>
- Add the
data-seed
attribute with the icon name to an element in your HTML.
<i data-seed="figma"></i>
- Call
seed.replace()
method before the closing</body>
tag to replace all elements with thedata-seed
attribute with the corresponding SVG icon.
<script>
seed.replace()
</script>
- Install
npm install seed-icons
- Import
import { ReactComponent as FirefoxIcon } from 'seed-icons/dist/icons/firefox.svg'
- Use
<FirefoxIcon />
An object with information about every icon. A typical icon object looks like:
seed.icons["google-play"]
// returns
{
name: 'google-play',
contents: '<path fill="#1ABCFE...',
tags: ['app', 'browser', 'google'],
attrs: {
class: 'seed seed-google-play',
xmlns: 'http://www.w3.org/2000/svg',
width: 48,
height: 48,
viewBox: '0 0 48 48',
}
}
Replaces all elements that have a data-seed
attribute with SVG markup. You can pass seed.replace() an attrs object. All attributes on the placeholder element (i.e. <i>
) will be copied to the <svg>
tag. All attributes on the placeholder element (i.e. <i>
) will be copied to the <svg>
tag.
<!-- Pass the below attributes in the replace method. -->
<i data-seed="firefox"></i>
<script>
seed.replace({ class: 'foo', height: 40 })
</script>
--
<!-- Returns in this output: -->
<svg
xmlns="http://www.w3.org/2000/svg"
width="100px"
height="100px"
viewBox="0 0 48 48"
class="seed seed-figma foo"
data-seed="figma"
>
<path>...</path>
</svg>
Returns the supplied icon name SVG as a string.
Contributions are always welcome. If you notice and bug or would like to request an icon, use an issue template to kickstart the process.
This project is one big mashup and open-source appropriation of projects from Feather, Ionicons, and Eva Icons. I started this project as something to work on while I practice React/Gatsby and inspecting those projects as I learn has been truly invaluable. Anything impressive is probably code from them I didn't change. Anything that barely functions is probably from yours truly. Please consider contributing.