{"id":13398568,"url":"https://github.com/ionic-team/ionicons","last_synced_at":"2025-09-09T20:25:36.393Z","repository":{"id":11116146,"uuid":"13473768","full_name":"ionic-team/ionicons","owner":"ionic-team","description":"Premium hand-crafted icons built by Ionic, for Ionic apps and web apps everywhere 🌎","archived":false,"fork":false,"pushed_at":"2025-07-30T15:27:42.000Z","size":28682,"stargazers_count":17875,"open_issues_count":53,"forks_count":2062,"subscribers_count":380,"default_branch":"main","last_synced_at":"2025-09-05T12:00:07.207Z","etag":null,"topics":["icon-pack","icons","iconset","ionic","ionicons","stenciljs","webcomponents"],"latest_commit_sha":null,"homepage":"http://ionicons.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ionic-team.png","metadata":{"files":{"readme":"readme.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-10-10T14:34:18.000Z","updated_at":"2025-09-04T20:01:28.000Z","dependencies_parsed_at":"2024-03-13T22:45:31.823Z","dependency_job_id":"4d85532d-7507-4693-9340-26b77b43b0ec","html_url":"https://github.com/ionic-team/ionicons","commit_stats":{"total_commits":628,"total_committers":62,"mean_commits":"10.129032258064516","dds":0.7834394904458599,"last_synced_commit":"d55d438ef033e9f8d95cb894214419460c6c2463"},"previous_names":["driftyco/ionicons"],"tags_count":138,"template":false,"template_full_name":null,"purl":"pkg:github/ionic-team/ionicons","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionic-team%2Fionicons","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionic-team%2Fionicons/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionic-team%2Fionicons/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionic-team%2Fionicons/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ionic-team","download_url":"https://codeload.github.com/ionic-team/ionicons/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ionic-team%2Fionicons/sbom","scorecard":{"id":356260,"data":{"date":"2025-08-11","repo":{"name":"github.com/ionic-team/ionicons","commit":"a9d1b7e23d7b9dec29f2041897ab14b2cef55064"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5.5,"checks":[{"name":"Code-Review","score":1,"reason":"Found 5/30 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Maintained","score":10,"reason":"13 commit(s) and 5 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/build.yml:1","Warn: no topLevel permission defined: .github/workflows/dev-build.yml:1","Warn: no topLevel permission defined: .github/workflows/release.yml:1","Warn: no topLevel permission defined: .github/workflows/update-screenshots.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":1,"reason":"dependency not pinned by hash detected -- score normalized to 1","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/build.yml:51: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/dev-build.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/dev-build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/dev-build.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/dev-build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/release.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/update-screenshots.yml:10: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/update-screenshots.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/update-screenshots.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/update-screenshots.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/update-screenshots.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/ionic-team/ionicons/update-screenshots.yml/main?enable=pin","Info:   0 out of   9 GitHub-owned GitHubAction dependencies pinned","Info:   1 out of   1 npmCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: github.com/ionic-team/.github/SECURITY.md:1","Info: Found linked content: github.com/ionic-team/.github/SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: github.com/ionic-team/.github/SECURITY.md:1","Info: Found text in security policy: github.com/ionic-team/.github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 5 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":8,"reason":"2 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-76c9-3jph-rj3q"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-18T09:41:44.686Z","repository_id":11116146,"created_at":"2025-08-18T09:41:44.687Z","updated_at":"2025-08-18T09:41:44.687Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274357586,"owners_count":25270675,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-09T02:00:10.223Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["icon-pack","icons","iconset","ionic","ionicons","stenciljs","webcomponents"],"created_at":"2024-07-30T19:00:28.639Z","updated_at":"2025-09-09T20:25:36.379Z","avatar_url":"https://github.com/ionic-team.png","language":"TypeScript","readme":"# Ionicons\n\n[Ionicons](http://ionicons.com/) is a completely open-source icon set with 1,300 icons crafted for web, iOS, Android, and desktop apps. Ionicons was built for [Ionic Framework](https://ionicframework.com/), so icons have both Material Design and iOS versions.\n\nNote: All brand icons are trademarks of their respective owners. The use of these trademarks does not indicate endorsement of the trademark holder by Ionic, nor vice versa.\n\nWe intend for this icon pack to be used with [Ionic](http://ionicframework.com/), but it’s by no means limited to it. Use them wherever you see fit, personal or commercial. They are free to use and licensed under [MIT](http://opensource.org/licenses/MIT).\n\n\n## Contributing\n\nThanks for your interest in contributing! Read up on our guidelines for\n[contributing](https://github.com/ionic-team/ionicons/blob/main/CONTRIBUTING.md)\nand then look through our issues with a [help wanted](https://github.com/ionic-team/ionicons/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22)\nlabel.\n\n\n## Using the Web Component\n\nThe Ionicons Web Component is an easy and performant way to use Ionicons in your app. The component will dynamically load an SVG for each icon, so your app is only requesting the icons that you need.\n\nAlso note that only visible icons are loaded, and icons that are \"below the fold\" and hidden from the user's view do not make fetch requests for the svg resource.\n\n### Installation\n\nIf you're using [Ionic Framework](https://ionicframework.com/), Ionicons is packaged by default, so no installation is necessary. Want to use Ionicons without Ionic Framework? Place the following `\u003cscript\u003e` near the end of your page, right before the closing `\u003c/body\u003e` tag, to enable them.\n\n```html\n\u003cscript type=\"module\" src=\"https://esm.sh/ionicons@latest/loader\"\u003e\u003c/script\u003e\n\u003cscript nomodule src=\"https://esm.sh/ionicons@latest/loader\"\u003e\u003c/script\u003e\n```\n\nyou can replace `latest` to pick any version of Ionicon, e.g.:\n\n```html\n\u003cscript type=\"module\" src=\"https://esm.sh/ionicons@8.0.0/loader\"\u003e\u003c/script\u003e\n\u003cscript nomodule src=\"https://esm.sh/ionicons@8.0.0/loader\"\u003e\u003c/script\u003e\n```\n\n### Basic usage\n\nTo use a built-in icon from the Ionicons package, populate the `name` attribute on the ion-icon component:\n\n```html\n\u003cion-icon name=\"heart\"\u003e\u003c/ion-icon\u003e\n```\n\n### Custom icons\n\nTo use a custom SVG, provide its url in the `src` attribute to request the external SVG file. The `src` attribute works the same as `\u003cimg src=\"...\"\u003e` in that the url must be accessible from the webpage that's making a request for the image. Additionally, the external file can only be a valid svg and does not allow scripts or events within the svg element.\n\n```html\n\u003cion-icon src=\"/path/to/external/file.svg\"\u003e\u003c/ion-icon\u003e\n```\n\n#### Custom Asset Path\n\nIf you have a different set of icons you would like to load or if the Ionicon icons are hosted on a different page or path, you can set the asset url from which Ionicons pulls the icons via:\n\n```ts\nimport { setAssetPath, addIcons } from 'ionicons';\nimport { add, logoIonic, save } from 'ionicons/icons';\n\n// set root path for loading icons to \"\u003croot\u003e/public/svg\"\nsetAssetPath(`${window.location.origin}/public/svg/`);\n\n// only load specific icons\naddIcons({ add, logoIonic, save });\n```\n\nThis allows the use of named icons like this:\n\n```html\n\u003c!-- now pulls the svg from \"\u003croot\u003e/public/svg/heart.svg\" --\u003e\n\u003cion-icon name=\"heart\"\u003e\u003c/ion-icon\u003e\n```\n\n## Variants\nEach app icon in Ionicons has a `filled`, `outline` and `sharp` variant. These different variants are provided to make your app feel native to a variety of platforms. The filled variant uses the default name without a suffix. Note: Logo icons do not have outline or sharp variants.\n\n```html\n\u003cion-icon name=\"heart\"\u003e\u003c/ion-icon\u003e \u003c!--filled--\u003e\n\u003cion-icon name=\"heart-outline\"\u003e\u003c/ion-icon\u003e \u003c!--outline--\u003e\n\u003cion-icon name=\"heart-sharp\"\u003e\u003c/ion-icon\u003e \u003c!--sharp--\u003e\n```\n\n### Platform specificity\nWhen using icons in Ionic Framework you can specify different icons per platform. Use the `md` and `ios` attributes and provide the platform-specific icon/variant name.\n\n```html\n\u003cion-icon ios=\"heart-outline\" md=\"heart-sharp\"\u003e\u003c/ion-icon\u003e\n```\n\n## Size\n\nTo specify the icon size, you can use the size attribute for our pre-defined font sizes.\n\n```html\n\u003cion-icon size=\"small\"\u003e\u003c/ion-icon\u003e\n\u003cion-icon size=\"large\"\u003e\u003c/ion-icon\u003e\n```\n\nOr you can set a specific size by applying the `font-size` CSS property on the `ion-icon` component. It's recommended to use pixel sizes that are a multiple of 8 (8, 16, 32, 64, etc.)\n\n```css\nion-icon {\n  font-size: 64px;\n}\n```\n\n## Color\n\nSpecify the icon color by applying the `color` CSS property on the `ion-icon` component.\n\n```css\nion-icon {\n  color: blue;\n}\n```\n\n## Stroke width\nWhen using an `outline` icon variant it is possible to adjust the stroke width, for improved visual balance relative to the icon's size or relative to the width of adjacent text. You can set a specific size by applying the `--ionicon-stroke-width` CSS custom property to the `ion-icon` component. The default value is 32px.\n\n```html\n\u003cion-icon name=\"heart-outline\"\u003e\u003c/ion-icon\u003e\n```\n\n```css\nion-icon {\n  --ionicon-stroke-width: 16px;\n}\n```\n\n## Migrating from v4\n\nSee the [5.0 release notes](https://github.com/ionic-team/ionicons/releases/tag/5.0.0) for a list of icon deletions/renames.\n\n## License\n\nIonicons is licensed under the [MIT license](http://opensource.org/licenses/MIT).\n\n\n## Related\n\n* [Ionicons Homepage](http://ionicons.com/)\n* [Ionic Framework](https://ionicframework.com/)\n* [Ionic Discord](https://ionic.link/discord)\n* [Ionic Forum](https://forum.ionicframework.com/)\n* [Stencil](https://stenciljs.com/)\n* [Capacitor](https://capacitorjs.com/)\n","funding_links":[],"categories":["HTML","TypeScript","Icons","others","IconSet Included","General"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fionic-team%2Fionicons","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fionic-team%2Fionicons","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fionic-team%2Fionicons/lists"}