Sadly we can no longer update this file as it reached 100MB and that's the max size allowed on GitHub to have files, we could only increase it further by paying for the bandwidth
Added icons for perplexity.ai
➕ perplexity-light.svg - full logo for lightmode
➕ perplexity-dark.svg - full logo for darkmode
➕ perplexity-book-light.svg - logo without wordmark for lightmode
➕perplexity-book-dark.svg - logo without wordmark for lightmode
description:Use this template to add a new icon to the project. Monochrome icons need both light and dark versions.
title:"feat(icons): add [NAME]"
labels:["monochrome-icon"]
body:
- type:markdown
attributes:
value:|
Hello and thank you for contributing to the project! Please fill out the following information to add a new icon to the project.
Once you've submitted the issue, sombody from the team will review it, before adding a label which automatically creates a pull request with the other filetypes.
If you submit a PNG icon, please note, that the SVG can not be generated from it.
- type:input
attributes:
label:Icon name
description:The name has to be unique and should be kebab-case.
placeholder:e.g. "icon-name"
- type:textarea
attributes:
label:Paste light mode icon
description:|
Please paste the icon here. It will automatically upload it to github. This icon should be visible on a light background.
- type:textarea
attributes:
label:Paste dark mode icon
description:|
Please paste the icon here. It will automatically upload it to github. This icon should be visible on a dark background.
- type:dropdown
attributes:
label:Icon type
options:
- SVG
- PNG
- type:dropdown
attributes:
label:Categories
multiple:true
options:
- Animal
- Cloud
- Communication
- Design
- Development
- E-Commerce
- Education
- File
- Finance
- Food
- Gaming
- Hardware
- Health
- Location
- Logistics
- Media
- Music
- Nature
- News
- Organization
- Search
- Security
- SocialMedia
- Streaming
- Travel
- Video
- type:input
attributes:
label:Aliases
description:A comma separated list of aliases
placeholder:e.g. "icon-alias, icon-alias-2"
- type:textarea
attributes:
label:Additional information
description:|
Add additional informations like a link to the application.
description:Use this template to add a new icon to the project. Normal icons work for both light and dark themes.
title:"feat(icons): add [NAME]"
labels:["normal-icon"]
body:
- type:markdown
attributes:
value:|
Hello and thank you for contributing to the project! Please fill out the following information to add a new icon to the project.
Once you've submitted the issue, sombody from the team will review it, before adding a label which automatically creates a pull request with the other filetypes.
If you submit a PNG icon, please note, that the SVG can not be generated from it.
- type:input
attributes:
label:Icon name
description:The name has to be unique and should be kebab-case.
placeholder:e.g. "icon-name"
- type:textarea
attributes:
label:Paste icon
description:|
Please paste the icon here. It will automatically upload it to github.
- type:dropdown
attributes:
label:Icon type
options:
- SVG
- PNG
- type:dropdown
attributes:
label:Categories
multiple:true
options:
- Animal
- Cloud
- Communication
- Design
- Development
- E-Commerce
- Education
- File
- Finance
- Food
- Gaming
- Hardware
- Health
- Location
- Logistics
- Media
- Music
- Nature
- News
- Organization
- Search
- Security
- SocialMedia
- Streaming
- Travel
- Video
- type:input
attributes:
label:Aliases
description:A comma separated list of aliases
placeholder:e.g. "icon-alias, icon-alias-2"
- type:textarea
attributes:
label:Additional information
description:|
Add additional informations like a link to the application.
Thank you for your interest in contributing to our icon repository! To ensure smooth collaboration, please make sure to read and agree to our [Contribution Guidelines](https://github.com/walkxcode/dashboard-icons/blob/main/CONTRIBUTING.md) before submitting your request.
- type:checkboxes
attributes:
label:Contribution Guidelines
options:
- label:"I have read and agree to the [Contribution Guidelines](https://github.com/walkxcode/dashboard-icons/blob/main/CONTRIBUTING.md)"
required:true
- type:textarea
id:icon-name
attributes:
label:Icon Name
description:What is the name of the icon you are requesting or suggesting?
placeholder:Enter icon name here
validations:
required:true
- type:textarea
id:icon-details
attributes:
label:Icon Details
description:Provide any additional details or context for the icon request.
@@ -23,8 +23,8 @@ Thank you for your interest in contributing to the icon repository! To ensure sm
### Format
- **SVG Format Required**: All icons must be submitted in SVG format.
- **Automatic PNG and WEBP Generation**: PNG and WEBP versions are generated automatically from the SVG files using the following settings:
- **SVG Format Required**: All icons should be submitted in SVG format. If an SVG version is unavailable, a PNG version will suffice, and a WEBP version will be generated accordingly.
- **Automatic PNG and WEBP Generation**: PNG and WEBP versions are generated automatically from the SVG (or PNG) files using the following settings:
- **Dimensions**:
- Height: 512 pixels
- Width: Auto (maintaining aspect ratio)
@@ -62,6 +62,32 @@ Thank you for your interest in contributing to the icon repository! To ensure sm
## Contribution Process
### Adding an icon
To add an icon to the repository, follow these steps:
1.**Create issue**: Create an issue from one of the add [templates](https://github.com/homarr-labs/dashboard-icons/issues/new/choose):
- **Light & dark icon**: Use this template to request a new icon with both light and dark versions.
- **Normal icon**: Use this template to request a new icon with a single version.
2.**Fill out the template**: Provide the requested information in the template. You can upload the icons directly to the issue.
3.**Wait for approval**: Wait for the issue to be approved by a maintainer. If any changes are needed, they will be requested in the issue.
4.**Maintainer approves & merges**: Once the issue is approved, a pull request with all the necessary changes will be created and merged by a maintainer.
### Updating an icon
To update an icon in the repository, follow these steps:
1.**Create issue**: Create an issue from the update [template](https://github.com/homarr-labs/dashboard-icons/issues/new/choose).
- **Light & dark icon**: Use this template to request a new icon with both light and dark versions.
- **Normal icon**: Use this template to request a new icon with a single version.
2.**Fill out the template**: Provide the requested information in the template. You can upload the icons directly to the issue.
3.**Wait for approval**: Wait for the issue to be approved by a maintainer. If any changes are needed, they will be requested in the issue.
4.**Maintainer approves & merges**: Once the issue is approved, a pull request with all the necessary changes will be created and merged by a maintainer.
### Change metadata / any other change
To change the metadata of an existing icon or any other change, follow these steps:
1.**Fork the Repository**: Create a fork of this repository on your GitHub account.
2.**Clone the Repository**: Clone your forked repository to your local machine.
3.**Add Your Icons**: Place your SVG icon(s) into the appropriate directory, following the specifications above.
> The repository has been migrated from `walkxcode` to `homarr-labs`, because I do not have the capacity/time to keep maintaining it. The Homarr team will take over all management and maintenance, whilst keeping all functionality for you, the user, the same. The project will always be usable outside of Homarr itself and breaking changes will not be made. ^Bjorn
> The repository has been migrated from `walkxcode` to `homarr-labs` as I no longer have the capacity to maintain it. The Homarr team will now handle management and maintenance, ensuring that functionality remains unchanged. The project will always be usable outside of Homarr and no breaking changes will be introduced.
> ― *Bjorn*
>
> The license and guidelines have changed, so please review them. If you want to help with maintenance, reach out to [homarr-labs@proton.me](mailto:homarr-labs@proton.me).
> The license and guidelines have been updated, so please review them. To help with maintenance, contact us at [homarr-labs@proton.me](mailto:homarr-labs@proton.me).
@@ -18,19 +23,19 @@ The best source for dashboard icons.<br />
- [Usage and Details](#usage-and-details)
- [Direct Links](#direct-links)
- [Base URL](#base-url)
- [Name](#name)
- [Icon Name](#icon-name)
- [Formats](#formats)
- [Dark/Light Versions](#darklight-versions)
- [Dark/Light Variants](#darklight-variants)
- [Downloading Icons](#downloading-icons)
- [Disclaimer](#disclaimer)
## Icon Requests
If you're looking to add a new icon, please read the [Contribution Guidelines](CONTRIBUTING.md). Afterwards, submit a Pull Request or open an issue.
If you’d like to add a new icon, please review our [Contribution Guidelines](CONTRIBUTING.md) and then submit a request using [our issue templates](https://github.com/homarr-labs/dashboard-icons/issues/new/choose).
## Supported Dashboards
Several dashboards offer seamless integration with Dashboard Icons. Here are some of the most popular options:
Dashboard Icons integrate seamlessly with several popular dashboards, including:
Icons are named using kebabcase (lowercase words separated by hyphens). For example, "Nextcloud Calendar" becomes `nextcloud-calendar`.
Icons follow kebab-case formatting (all lowercase words separated by hyphens). For example, "Nextcloud Calendar" becomes `nextcloud-calendar`.
#### Formats
Icons are available in the following formats:
Icons are available in these formats:
- SVG
- PNG
- WEBP
All icons are generated from the SVG file as the base.
*All icons are generated from the base SVG file. For more details, see the [Contribution Guidelines](CONTRIBUTING.md).*
*Read more about the specifics and standards of icons in the [Contribution Guidelines](CONTRIBUTING.md).*
### Dark/Light Variants
### Dark/Light Versions
Some icons may have very light or dark colors, which might reduce visibility on certain backgrounds. In such cases, a `-light` or `-dark` suffix is appended—for instance, "2fauth" becomes `2fauth-light`.
In some cases, an icon might have very light or dark colors, making it hard to see on certain backgrounds. In this situation, a `-light` or `-dark` version will be added to the end of the icon's name, with colors adjusted accordingly.
For example, "2fauth" becomes `2fauth-light`.
*Read more about the specifics and standards of icons in the [Contribution Guidelines](CONTRIBUTING.md).*
*More specifics are available in the [Contribution Guidelines](CONTRIBUTING.md).*
### Downloading Icons
To download icons from the [icons page](ICONS.md), simply Right-click the icon link and select "Save link as".
1.**Browse & Download:**
Visit [https://icons.homarr.dev](https://icons.homarr.dev) to easily view and download icons.
**Warning**: Visiting the icons page will load every icon in the repository. This may result in:
2.**Using the Browser:**
On the icons page ([ICONS.md](ICONS.md)), right-click any icon link and select "Save link as".
**Note:** Loading the icons page displays every icon in the repository, which may lead to high data usage, slow performance, or even browser crashes on less powerful devices. For faster access, use the direct links or download icons individually.
- High data usage.
- System slowdowns.
- Browser crashes on some devices.
If you prefer not to load all icons at once, consider using the direct links or downloading icons individually.
To download icons using the terminal, use `curl` or `wget`. Refer to [Direct Links](#direct-links) for details on the link structure.
3.**Using the Terminal:**
Download icons via `curl` or `wget` by using the following structure:
Unless otherwise indicated, all images and assets in this repository, including product names, trademarks, and registered trademarks, are the property of their respective owners. These images and assets are used for identification purposes only, and their use does not imply endorsement.
Unless stated otherwise, all images and assets in this repository—including product names, trademarks, and registered trademarks—belong to their respective owners and are used solely for identification purposes. Their inclusion does not imply endorsement.
Read the [LICENSE](LICENSE) for more information about the project itself. For questions or concerns, contact us at [homarr-labs@proton.me](mailto:homarr-labs@proton.me).
For more details, please review the [LICENSE](LICENSE). If you have any questions or concerns, contact us at [homarr-labs@proton.me](mailto:homarr-labs@proton.me).
Some files were not shown because too many files have changed in this diff
Show More
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.