--- /dev/null
+name: Icon request
+description: Suggest an icon to be included in Font Awesome
+labels: ["new icon"]
+title: "Icon request: "
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for taking the time to request a new icon!
+ - type: textarea
+ id: use-case
+ attributes:
+ label: Use case
+ description: Describe how this icon could be used.
+ - type: textarea
+ id: example
+ attributes:
+ label: Example image
+ description: Insert the example image here if necessary. A good example is a single color image which plays well at small sizes (16px)
+ - type: checkboxes
+ id: icon-request-checklist
+ attributes:
+ label: Icon request checklist
+ options:
+ - label: 'The title starts with "Icon request: " and is followed by the requested icon name'
+ required: true
+ - label: 'This icon does not represent a brand'
+ required: true
+ - label: 'This is a single icon or matched pair (Ex: `lock` / `unlock`)'
+ required: true
+ - label: The request is for a concrete object, or I've included an example image
+ required: true
+ - label: 'I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate'
+ required: true
+ - label: 'I have [understood how requests work](https://fontawesome.com/community/leaderboard/new#faqs)'
+ required: true
--- /dev/null
+name: Brand request
+description: Suggest a brand to be included in Font Awesome
+labels: ["brand icon"]
+title: "Brand request: "
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for taking the time to request a new brand!
+ - type: textarea
+ id: description
+ attributes:
+ label: Description
+ description: Please enter a brief description of this brand and why it is important to have it in the core of Font Awesome
+ - type: input
+ id: official-website
+ attributes:
+ label: Official website
+ description: Please provide the official website of this brand. The website must be in production and reachable from the public internet
+ validations:
+ required: true
+ - type: input
+ attributes:
+ label: Brand guidelines
+ description: "Link to brand guidelines, if available (e.g.: https://about.twitter.com/en/who-we-are/brand-toolkit)"
+ - type: checkboxes
+ id: icon-request-checklist
+ attributes:
+ label: Icon request checklist
+ options:
+ - label: 'The title starts with "Brand request: ", is followed by the requested brand name'
+ required: true
+ - label: 'I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate'
+ required: true
+ - label: 'I have [understood how requests work](https://fontawesome.com/community/leaderboard/brands#faqs)'
+ required: true
--- /dev/null
+name: Bug report (Web - CSS - JS)
+description: Report a bug which occurs in a web application
+title: "Bug: "
+labels: ["bug", "needs-triage"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for taking the time to fill up this bug report!
+
+ There are a lot of different ways of using Font Awesome. In order to help us
+ debugging, please provide as much information as you can.
+
+ A reduced reproducible test case would definitely help the process.
+ - type: textarea
+ id: description
+ attributes:
+ label: Bug description
+ description: What happened? What are you seeing? How did you arrive here?
+ validations:
+ required: true
+ - type: input
+ id: reproducible-test-case
+ attributes:
+ label: Reproducible test case
+ description: Provide a URL to a reproducible use case. Use codepen.io, jsfiddle.net, jsbin.com, codesandbox.io, or whatever.
+ - type: textarea
+ id: screenshots
+ attributes:
+ label: Screenshots
+ description: Add screenshots to help explain your problem
+ - type: input
+ id: version
+ attributes:
+ label: Font Awesome version
+ description: Provide the version of Font Awesome affected by this bug
+ placeholder: v6.0.0
+ validations:
+ required: true
+ - type: dropdown
+ id: serving
+ attributes:
+ label: Serving
+ multiple: true
+ options:
+ - Kit
+ - Font Awesome CDN
+ - Self-hosted
+ - Other (as specified in the bug description)
+ validations:
+ required: true
+ - type: dropdown
+ id: implementation
+ attributes:
+ label: Implementation
+ multiple: true
+ options:
+ - CSS
+ - SVG+JS
+ - SVG Sprites
+ - Other (as specified in the bug description)
+ validations:
+ required: true
+ - type: textarea
+ id: browser-operating-system
+ attributes:
+ label: Browser and Operating System
+ description: Provide information about the browser and operating system affected by this bug. [List of supported browsers](https://fontawesome.com/v6/docs/web/dig-deeper/browser-support)
+ placeholder: |
+ - Chrome 94 on Windows 10
+ - Firefox 92 on macOS
+ validations:
+ required: true
+ - type: checkboxes
+ id: web-bug-report-checklist
+ attributes:
+ label: Web bug report checklist
+ options:
+ - label: 'I have included a test case because my odds go _way_ up that the team can fix this when I do'
+ - label: 'I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate'
+ required: true
--- /dev/null
+name: Bug report (Desktop / Native / Other)
+description: Report a bug which occurs outside of a web application
+title: "Bug: "
+labels: ["bug", "needs-triage"]
+body:
+ - type: markdown
+ attributes:
+ value: |
+ Thanks for taking the time to fill up this bug report!
+ - type: textarea
+ id: description
+ attributes:
+ label: Bug description
+ description: What happened? What are you seeing? How did you arrive here?
+ validations:
+ required: true
+ - type: input
+ id: version
+ attributes:
+ label: Font Awesome version
+ description: Provide the version of Font Awesome affected by this bug
+ placeholder: v6.0.0
+ validations:
+ required: true
+ - type: textarea
+ id: application-operating-system
+ attributes:
+ label: Application and Operating System
+ description: Provide information about the application and operating system affected by this bug
+ placeholder: |
+ - GIMP on Windows 10
+ - Adobe Photoshop on macOS
+ validations:
+ required: true
+ - type: checkboxes
+ id: web-bug-report-checklist
+ attributes:
+ label: Web bug report checklist
+ options:
+ - label: 'I have included a test case because my odds go _way_ up that the team can fix this when I do'
+ - label: 'I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate'
+ required: true
--- /dev/null
+name: Feature request
+description: Suggest an idea for Font Awesome
+title: "Feature request: "
+labels: ['feature']
+body:
+ - type: markdown
+ attributes:
+ value: Thanks for taking the time to request a new feature!
+ - type: textarea
+ id: use-case
+ attributes:
+ label: Is your feature request related to a problem?
+ description: A clear and concise description of what the problem is
+ placeholder: I'm always frustrated when...
+ - type: textarea
+ id: feature
+ attributes:
+ label: Feature description
+ description: A clear and concise description of what you want to happen
+ validations:
+ required: true
+ - type: textarea
+ id: alternatives
+ attributes:
+ label: Alternatives
+ description: A clear and concise description of any alternative solutions or features you've considered.
+ - type: textarea
+ id: additional-context
+ attributes:
+ label: Additional context
+ description: Add any other context or screenshots about the feature request here
+ - type: checkboxes
+ id: feature-request-checklist
+ attributes:
+ label: Feature request checklist
+ options:
+ - label: 'The title starts with "Feature request: " and is followed by the requested feature description'
+ required: true
+ - label: 'This is a single feature'
+ required: true
+ - label: 'I have [searched for existing issues](https://github.com/FortAwesome/Font-Awesome/issues) and to the best of my knowledge this is not a duplicate'
+ required: true
--- /dev/null
+contact_links:
+ - name: Pro License Issue
+ url: https://fontawesome.com/#footer
+ about: Click on the "Support" link in the footer
--- /dev/null
+<!--- WARNING Pull Requests made to this repository cannot be merged -->
+
+I understand that:
+
+- [ ] I'm submitting this PR for reference only. It shows an example of what I'd like to see changed but
+ I understand that it will not be merged and I will not be listed as a contributor on this project.
--- /dev/null
+# Change Log
+
+Font Awesome 7 is here! And with it a new location for the change log.
+
+Visit https://fontawesome.com/docs/changelog/.
--- /dev/null
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+ address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+ professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at <hello@fontawesome.com>. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [https://contributor-covenant.org/version/1/4][version]
+
+[homepage]: https://contributor-covenant.org
+[version]: https://contributor-covenant.org/version/1/4/
--- /dev/null
+# Contributing to Font Awesome
+
+Looking to contribute something to Font Awesome? **Here's how you can help.**
+
+## Quick start
+
+We only accept issues that are icon requests, bug reports, or feature requests.
+Bugs must be isolated and reproducible problems that we can fix within the Font
+Awesome core.
+
+* [Request a new icon](https://github.com/FortAwesome/Font-Awesome/issues/new?title=Icon%20request:%20icon-name&template=icon-request.md)
+* [Request a new feature](https://github.com/FortAwesome/Font-Awesome/issues/new??title=Feature%20request:feature-name&template=feature-request.md)
+* [Submit a bug report](https://github.com/FortAwesome/Font-Awesome/issues/new?template=bug-report.md)
+
+## Key branches
+
+- `master` is the latest, deployed version
+
+## Pull requests
+
+- At the moment we are not accepting pull requests containing icons
+- Pull requests that do not solve an existing issue are essentially un-prioritized–don't expect these to be addressed quickly
+- The files in this repository are generated elsewhere and we do not merge PR's directly into master
+- Try not to pollute your pull request with unintended changes–keep them simple and small
+- Try to share which browsers your code has been tested in before submitting a pull request
--- /dev/null
+Fonticons, Inc. (https://fontawesome.com)
+
+--------------------------------------------------------------------------------
+
+Font Awesome Free License
+
+Font Awesome Free is free, open source, and GPL friendly. You can use it for
+commercial projects, open source projects, or really almost whatever you want.
+Full Font Awesome Free license: https://fontawesome.com/license/free.
+
+--------------------------------------------------------------------------------
+
+# Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
+
+The Font Awesome Free download is licensed under a Creative Commons
+Attribution 4.0 International License and applies to all icons packaged
+as SVG and JS file types.
+
+--------------------------------------------------------------------------------
+
+# Fonts: SIL OFL 1.1 License
+
+In the Font Awesome Free download, the SIL OFL license applies to all icons
+packaged as web and desktop font files.
+
+Copyright (c) 2023 Fonticons, Inc. (https://fontawesome.com)
+with Reserved Font Name: "Font Awesome".
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+SIL OPEN FONT LICENSE
+Version 1.1 - 26 February 2007
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting — in part or in whole — any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+# Code: MIT License (https://opensource.org/licenses/MIT)
+
+In the Font Awesome Free download, the MIT license applies to all non-font and
+non-icon files.
+
+Copyright 2023 Fonticons, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in the
+Software without restriction, including without limitation the rights to use, copy,
+modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
+and to permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+--------------------------------------------------------------------------------
+
+# Attribution
+
+Attribution is required by MIT, SIL OFL, and CC BY licenses. Downloaded Font
+Awesome Free files already contain embedded comments with sufficient
+attribution, so you shouldn't need to do anything additional when using these
+files normally.
+
+We've kept attribution comments terse, so we ask that you do not actively work
+to remove them from files, especially code. They're a great way for folks to
+learn about Font Awesome.
+
+--------------------------------------------------------------------------------
+
+# Brand Icons
+
+All brand icons are trademarks of their respective owners. The use of these
+trademarks does not indicate endorsement of the trademark holder by Font
+Awesome, nor vice versa. **Please do not use brand logos for any purpose except
+to represent the company, product, or service to which they refer.**
--- /dev/null
+<h1><img src="https://img.fortawesome.com/349cfdf6/fa-free-logo.svg" alt="Font Awesome Free" width="50%"></h1>
+
+> Version 7
+
+Font Awesome is the Internet's icon library and toolkit, used by millions of
+designers, developers, and content creators.
+
+## Documentation
+
+Learn how to get started with Font Awesome and then dive deeper into other and advanced topics:
+
+[Docs for version 6](https://fontawesome.com/docs)
+
+### Where did Font Awesome 6, 5, 4 (or 3) go?
+
+Now that Font Awesome 7 has been released we are marking version 6 as Long Term
+Support (LTS). Version 6 will get critical bug fixes only. Version 3, 4, and 5 are
+now end-of-life and we don't plan on releasing any further versions of these.
+
+You can see a complete list of versions on [our Versions
+page](https://fontawesome.com/versions).
+
+## Change log
+
+The change log for releases is now [available directly on our site](https://fontawesome.com/docs/changelog/).
+
+Looking for older versions of Font Awesome? Check the [releases](https://github.com/FortAwesome/Font-Awesome/releases).
+
+## Upgrading
+
+From time-to-time we'll have special upgrading instructions from one version to the next.
+
+- [Web upgrading guide](https://fontawesome.com/docs/web/setup/upgrade/)
+- [Desktop upgrading guide](https://fontawesome.com/docs/desktop/setup/upgrade/)
+
+## Code of conduct
+
+We will behave ourselves if you behave yourselves. For more details see our
+[CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md).
+
+## Contributing
+
+Please read through our [contributing guidelines](./CONTRIBUTING.md). Included
+are directions for opening issues.
+
+## Versioning
+
+Font Awesome will be maintained under the Semantic Versioning guidelines as much as possible. Releases will be numbered
+with the following format:
+
+`<major>.<minor>.<patch>`
+
+For more information on SemVer, please visit https://semver.org.
+
+**The major version "7" is part of an umbrella release. It includes many different types of files and technologies. Therefore
+we deviate from normal SemVer in the following ways:**
+
+* Any release may update the design, look-and-feel, or branding of an existing
+ icon
+* We will never intentionally release a `patch` version update that breaks
+ backward compatibility
+* A `minor` release **may include backward-incompatible changes** but we will
+ write clear upgrading instructions in UPGRADING.md
+* A `minor` or `patch` release will never remove icons
+* Bug fixes will be addressed as `patch` releases unless they include backward
+ incompatibility then they will be `minor` releases
+
+## License
+
+Font Awesome Free is free, open source, and GPL friendly. You can use it for
+commercial projects, open source projects, or really almost whatever you want.
+
+- Icons — CC BY 4.0 License
+ - In the Font Awesome Free download, the CC BY 4.0 license applies to all icons packaged as .svg and .js files types.
+- Fonts — SIL OFL 1.1 License
+ - In the Font Awesome Free download, the SIL OLF license applies to all icons packaged as web and desktop font files.
+- Code — MIT License
+ - In the Font Awesome Free download, the MIT license applies to all non-font and non-icon files.
+
+Attribution is required by MIT, SIL OLF, and CC BY licenses. Downloaded Font
+Awesome Free files already contain embedded comments with sufficient
+attribution, so you shouldn't need to do anything additional when using these
+files normally.
+
+We've kept attribution comments terse, so we ask that you do not actively work
+to remove them from files, especially code. They're a great way for folks to
+learn about Font Awesome.
+
+## Team
+
+https://github.com/orgs/FortAwesome/people
--- /dev/null
+# Upgrading Guide
+
+See the [CHANGELOG.md](./CHANGELOG.md) for detailed information about what has changed between versions.
+
+Our upgrading guide has moved for version 7 to:
+
+- [Web](https://docs.fontawesome.com/upgrade/upgrade-on-web)
+- [Desktop](https://docs.fontawesome.com/upgrade/upgrade-on-desktop)
+
+As always, [submit issues](https://github.com/FortAwesome/Font-Awesome/issues/new) that you run into with this guide or with these upgrades to us.
--- /dev/null
+{
+ "name": "fortawesome/font-awesome",
+ "description": "The iconic font, CSS, and SVG framework",
+ "keywords": ["font", "awesome", "fontawesome", "icon", "svg", "font", "bootstrap"],
+ "homepage": "https://fontawesome.com",
+ "authors": [
+ {
+ "name": "The Font Awesome Team",
+ "homepage": "https://github.com/orgs/FortAwesome/people"
+ }
+ ],
+ "support": {
+ "email": "hello@fontawesome.com",
+ "issues": "https://github.com/FortAwesome/Font-Awesome/issues",
+ "source": "https://github.com/FortAwesome/Font-Awesome",
+ "docs": "http://fontawesome.com/docs"
+ },
+ "license": [
+ "CC-BY-4.0",
+ "OFL-1.1",
+ "MIT"
+ ]
+}
projects / thirdparty / Font-Awesome.git / commitdiff
