github/Font-Awesome
1
1
Fork 0
mirror of https://github.com/FortAwesome/Font-Awesome.git synced 2026-01-09 14:38:03 -05:00
Code Issues Packages Projects Releases Wiki Activity

Initial commit for 7

Browse Source
This commit is contained in:
robmadole
2025-07-22 11:01:30 -05:00
commit 8ff114b69d
14 changed files with 640 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

36
.github/ISSUE_TEMPLATE/000_icon_request.yml vendored Normal file
View File

@@ -0,0 +1,36 @@
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

36
.github/ISSUE_TEMPLATE/001_brand_request.yml vendored Normal file
View File

@@ -0,0 +1,36 @@
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

81
.github/ISSUE_TEMPLATE/100_web_bug_report.yml vendored Normal file
View File

@@ -0,0 +1,81 @@
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

42
.github/ISSUE_TEMPLATE/101_other_bug_report.yml vendored Normal file
View File

@@ -0,0 +1,42 @@
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

42
.github/ISSUE_TEMPLATE/200_feature_request.yml vendored Normal file
View File

@@ -0,0 +1,42 @@
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

4
.github/ISSUE_TEMPLATE/config.yml vendored Normal file
View File

@@ -0,0 +1,4 @@
contact_links:
- name: Pro License Issue
url: https://fontawesome.com/#footer
about: Click on the "Support" link in the footer

6
.github/PULL_REQUEST_TEMPLATE.md vendored Normal file
View File

@@ -0,0 +1,6 @@
<!--- 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.

5
CHANGELOG.md Normal file
View File

@@ -0,0 +1,5 @@
# Change Log
Font Awesome 7 is here! And with it a new location for the change log.
Visit https://fontawesome.com/docs/changelog/.

74
CODE_OF_CONDUCT.md Normal file
View File

@@ -0,0 +1,74 @@
# 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/

25
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,25 @@
# 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

165
LICENSE.txt Normal file
View File

@@ -0,0 +1,165 @@
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.**

91
README.md Normal file
View File

@@ -0,0 +1,91 @@
<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

10
UPGRADING.md Normal file
View File

@@ -0,0 +1,10 @@
# 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.

23
composer.json Normal file
View File

@@ -0,0 +1,23 @@
{
"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"
]
}