2020-04-09 19:56:19 +03:00
## Fira Code: free monospaced font with programming ligatures
2014-11-11 22:47:04 +03:00
2021-02-16 00:46:47 +03:00
![Fira Code ](./extras/logo.svg )
2015-07-30 15:27:45 +03:00
2022-01-26 05:27:26 +03:00
Read in [Español ](./LEEME.md ) | [简体中文 ](./README_CN.md )
2021-12-20 14:59:31 +03:00
2014-11-11 22:47:04 +03:00
### Problem
2016-04-01 15:45:12 +03:00
Programmers use a lot of symbols, often encoded with several characters. For the human brain, sequences like `->` , `<=` or `:=` are single logical tokens, even if they take two or three characters on the screen. Your eye spends a non-zero amount of energy to scan, parse and join multiple characters into a single logical one. Ideally, all programming languages should be designed with full-fledged Unicode symbols for operators, but that’ s not the case yet.
2014-11-11 22:47:04 +03:00
### Solution
2020-04-09 19:56:19 +03:00
Fira Code is a free monospaced font containing ligatures for common programming multi-character combinations. This is just a font rendering feature: underlying code remains ASCII-compatible. This helps to read and understand code faster. For some frequent sequences like `..` or `//` , ligatures allow us to correct spacing.
2015-12-21 10:29:09 +03:00
2020-04-09 19:56:19 +03:00
### Download & Install
2018-09-18 22:39:18 +03:00
2022-03-05 04:49:03 +03:00
< a href = "https://github.com/tonsky/FiraCode/releases/download/6.2/Fira_Code_v6.2.zip" > < img alt = "Fira_Code_v6.2.zip - December 6, 2021 - 2.5 MB" src = "./extras/download.png" width = "520" > < / a >
2014-11-11 22:47:04 +03:00
2020-04-09 19:56:19 +03:00
Then:
2021-02-16 00:46:47 +03:00
- [How to Install ](https://github.com/tonsky/FiraCode/wiki )
- [Troubleshooting ](https://github.com/tonsky/FiraCode/wiki#troubleshooting )
- [News & Updates ](https://twitter.com/FiraCode )
2020-04-09 19:56:19 +03:00
2022-02-09 17:50:05 +03:00
### Sponsors
2020-04-09 19:56:19 +03:00
2020-07-14 09:03:51 +03:00
Fira Code is a personal, free-time project with no funding and a huge [feature request backlog ](https://github.com/tonsky/FiraCode/issues ). If you love it, consider supporting its development via [GitHub Sponsors ](https://github.com/sponsors/tonsky ) or [Patreon ](https://patreon.com/tonsky ). Any help counts!
2020-04-09 19:56:19 +03:00
2022-02-09 17:50:05 +03:00
Huge thanks to:
< table >
< td align = "center" >
2022-02-09 19:40:30 +03:00
< a href = "https://workos.com/?utm_campaign=github_repo&utm_medium=referral&utm_content=firacode&utm_source=github" >
2022-02-09 17:50:05 +03:00
< div >
< img src = "https://user-images.githubusercontent.com/629429/151508669-efb4c3b3-8fe3-45eb-8e47-e9510b5f0af1.svg" width = "290" alt = "WorkOS" >
< / div >
< b > Your app, enterprise-ready.< / b >
< div >
< sub > Start selling to enterprise customers with just a few lines of code. Add Single Sign-On (and more) in minutes instead of months.< / sup >
< / div >
< / a >
< / td >
< / table >
2020-04-09 19:56:19 +03:00
### What’ s in the box?
Left: ligatures as rendered in Fira Code. Right: same character sequences without ligatures.
2022-03-05 04:49:03 +03:00
< img src = "./extras/ligatures.png" width = "754" >
2020-04-09 19:56:19 +03:00
2020-07-14 09:03:51 +03:00
Fira Code comes with a huge variety of arrows. Even better: you can make them as long as you like and combine start/middle/end fragments however you want!
2020-04-09 19:56:19 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/arrows.png" width = "754" >
2020-04-09 19:56:19 +03:00
2020-05-18 00:34:17 +03:00
Fira Code is not only about ligatures. Some fine-tuning is done for punctuation and frequent letter pairs.
2020-04-09 19:56:19 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/typographics.png" width = "754" >
2014-11-11 22:47:04 +03:00
2020-07-14 09:03:51 +03:00
Fira Code comes with a few different character variants, so that everyone can choose what’ s best for them. [How to enable ](https://github.com/tonsky/FiraCode/wiki/How-to-enable-stylistic-sets )
2016-08-30 14:34:40 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/character_variants.png" width = "754" >
2016-08-30 14:34:40 +03:00
2021-11-06 04:47:45 +03:00
Some ligatures can be altered or enabled using stylistic sets/character variants:
2016-08-30 14:34:40 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/ligature_variants.png" width = "754" >
2016-08-30 14:34:40 +03:00
2021-11-06 04:47:45 +03:00
Being a programming font, Fira Code has fantastic support for ASCII/box drawing, powerline and other forms of console UIs:
2017-09-28 15:13:33 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/console.png" width = "754" >
2021-11-06 04:47:45 +03:00
Fira Code is the first programming font to offer dedicated glyphs to render progress bars:
2022-03-05 04:49:03 +03:00
< img src = "./extras/progress.png" width = "754" >
2021-11-06 04:47:45 +03:00
In action:
2022-03-05 04:49:03 +03:00
< img src = "./extras/progress.gif" width = "560" >
2021-11-06 04:47:45 +03:00
We hope more programming fonts will adopt this convention and ship their own versions.
Unicode coverage makes Fira Code a great choice for mathematical writing:
2022-03-05 04:49:03 +03:00
< img src = "./extras/math.png" width = "754" >
2017-09-28 15:13:33 +03:00
2020-05-18 00:34:17 +03:00
### How does it look?
2016-08-30 14:34:40 +03:00
2022-03-05 04:49:03 +03:00
< img src = "./extras/samples.png" width = "754" >
< img src = "./extras/samples2.png" width = "754" >
2015-12-20 17:51:56 +03:00
2020-04-09 19:56:19 +03:00
### Editor compatibility list
2014-11-11 22:47:04 +03:00
2017-03-25 18:05:36 +03:00
| Works | Doesn’ t work |
2020-05-18 00:34:17 +03:00
|-------|----------------|
2017-12-18 01:12:39 +03:00
| **Abricotine** | **Arduino IDE** |
2022-02-07 00:27:30 +03:00
| **Android Studio** (2.3+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) | **Adobe Dreamweaver** |
2017-12-18 01:12:39 +03:00
| **Anjuta** (unless at the EOF) | **Delphi IDE** |
2022-07-11 22:11:46 +03:00
| **AppCode** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) | Standalone **Emacs** ([workaround](https://github.com/tonsky/FiraCode/wiki/Emacs-instructions)) | **IDLE** |
| **Atom** 1.1 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/Atom-instructions)) | **KDevelop 4** |
| **BBEdit/TextWrangler** (v. 11 only, [instructions ](https://github.com/tonsky/FiraCode/wiki/BBEdit-instructions )) | **Monkey Studio IDE** |
| **Brackets** (with [this plugin ](https://github.com/polo2ro/firacode-in-brackets )) |
| **Chocolat** | **UltraEdit** |
| **CLion** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2021-12-06 19:12:08 +03:00
| **Cloud9** ([instructions](https://github.com/tonsky/FiraCode/wiki/Cloud9-Instructions)) |
2021-06-11 17:44:24 +03:00
| **Coda 2** |
2021-11-12 05:04:44 +03:00
| **CodeLite** |
| **CodeRunner** |
2022-06-30 01:59:46 +03:00
| **Comma** (Under: Preferences > Editor > Font) |
2020-11-03 12:50:16 +03:00
| **CotEditor** |
2020-06-17 17:37:01 +03:00
| **Eclipse** |
| **elementary Code** |
2021-06-11 21:35:50 +03:00
| **Geany** (1.37+) |
2017-03-25 18:05:36 +03:00
| **gEdit / Pluma** |
| **GNOME Builder** |
2022-07-11 18:03:03 +03:00
| **Godot** |
2018-12-04 17:13:01 +03:00
| **GoormIDE** ([instructions](https://github.com/tonsky/FiraCode/wiki/GoormIDE-Instructions)) |
2021-12-06 18:06:18 +03:00
| **gVim** ([Windows](https://github.com/tonsky/FiraCode/issues/462), [GTK ](https://vimhelp.org/options.txt.html#%27guiligatures%27 )) |
2022-02-07 00:27:30 +03:00
| **IntelliJ IDEA** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2017-03-25 18:05:36 +03:00
| **Kate, KWrite** |
2019-06-03 13:22:45 +03:00
| **KDevelop 5+** |
2017-03-25 18:05:36 +03:00
| **Komodo** |
| **Leafpad** |
| **LibreOffice** |
| **LightTable** ([instructions](https://github.com/tonsky/FiraCode/wiki/LightTable-instructions)) |
| **LINQPad** |
| **MacVim** 7.4 or newer ([instructions](https://github.com/tonsky/FiraCode/wiki/MacVim-instructions)) |
| **Mancy** |
2021-03-08 05:03:51 +03:00
| **MATLAB** ([instructions](https://github.com/tonsky/FiraCode/wiki/MATLAB-for-Windows-Instructions)) |
2017-03-25 18:05:36 +03:00
| **Meld** |
| **Mousepad** |
2018-03-13 12:51:38 +03:00
| **NeoVim-gtk** |
2017-03-25 18:05:36 +03:00
| **NetBeans** |
2019-11-04 16:45:41 +03:00
| **Notepad** (Windows) |
2017-08-07 16:11:18 +03:00
| **Notepad++** (with a [workaround ](https://github.com/notepad-plus-plus/notepad-plus-plus/issues/2287#issuecomment-256638098 )) |
2019-11-15 15:32:53 +03:00
| **Notepad3** ([instructions](https://github.com/rizonesoft/Notepad3/issues/361#issuecomment-365977420))|
2021-11-12 05:04:44 +03:00
| **Nova** |
2022-02-07 00:27:30 +03:00
| **PhpStorm** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
| **PyCharm** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2021-06-29 15:56:11 +03:00
| **QOwnNotes** (21.16.6+) |
2017-03-25 18:05:36 +03:00
| **QtCreator** |
| **Rider** |
| **RStudio** ([instructions](https://github.com/tonsky/FiraCode/wiki/RStudio-instructions)) |
2022-02-07 00:27:30 +03:00
| **RubyMine** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2017-03-25 18:05:36 +03:00
| **Scratch** |
2019-01-02 19:22:28 +03:00
| **Scribus** (1.5.3+) |
2017-10-06 18:34:44 +03:00
| **SublimeText** (3146+) |
2017-03-30 16:23:15 +03:00
| **Spyder IDE** (only with Qt5) |
2017-12-12 02:06:14 +03:00
| **SuperCollider 3** |
2022-01-31 02:11:45 +03:00
| **TeXShop** |
2019-11-04 16:45:41 +03:00
| **TextAdept** (Linux, macOS) |
2017-03-25 18:05:36 +03:00
| **TextEdit** |
| **TextMate 2** |
| **VimR** ([instructions](https://github.com/qvacua/vimr/wiki#ligatures)) |
2019-05-31 14:12:26 +03:00
| **Visual Studio** (2015+, [instructions ](https://github.com/tonsky/FiraCode/wiki/Visual-Studio-Instructions )) |
2017-03-25 18:05:36 +03:00
| **Visual Studio Code** ([instructions](https://github.com/tonsky/FiraCode/wiki/VS-Code-Instructions)) |
2022-02-07 00:27:30 +03:00
| **WebStorm** (2016.2+, [instructions ](https://github.com/tonsky/FiraCode/wiki/IntelliJ-products-instructions )) |
2017-03-25 18:05:36 +03:00
| **Xamarin Studio/Monodevelop** |
2017-08-07 16:27:23 +03:00
| **Xcode** (8.0+, otherwise [with plugin ](https://github.com/robertvojta/LigatureXcodePlugin )) |
2020-04-18 17:47:10 +03:00
| **Xi** |
2017-03-25 18:05:36 +03:00
| Probably work: **Smultron, Vico** | Under question: **Code::Blocks IDE** |
2014-11-11 22:47:04 +03:00
2020-05-18 00:34:17 +03:00
### Terminal compatibility list
2022-04-01 17:55:14 +03:00
| Works | Doesn’ t work |
|-------|--------------|
| crosh ([instructions](https://github.com/tonsky/FiraCode/wiki/ChromeOS-Terminal)) | Alacritty |
| Hyper (see [#3607 ](https://github.com/vercel/hyper/issues/3607 )) | Cmder |
| iTerm 2 | ConEmu |
| Kitty | GNOME Terminal |
| Konsole | gtkterm ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| Mintty | guake ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| QTerminal | LXTerminal ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| st ([patch](https://st.suckless.org/patches/ligatures/)) | mate-terminal |
| Terminal.app | PuTTY |
| Termux | rxvt |
| Token2Shell | sakura ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| Wez’ s terminal | Terminator ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| Windows Terminal | terminology |
| ZOC (macOS) | Windows Console |
| | xfce4-terminal ([ticket](https://gitlab.gnome.org/GNOME/vte/-/issues/1661)) |
| | xterm |
| | ZOC (Windows) |
2020-05-18 00:34:17 +03:00
2015-12-19 19:15:03 +03:00
### Browser support
2015-05-07 17:41:30 +03:00
2017-09-28 10:56:54 +03:00
```html
<!-- HTML -->
2021-12-06 23:52:45 +03:00
< link rel = "stylesheet" href = "https://cdn.jsdelivr.net/npm/firacode@6.2.0/distr/fira_code.css" >
2017-09-28 10:56:54 +03:00
```
```css
/* CSS */
2021-12-06 23:52:45 +03:00
@import url(https://cdn.jsdelivr.net/npm/firacode@6.2.0/distr/fira_code.css);
2017-09-28 10:56:54 +03:00
```
2019-03-11 21:44:23 +03:00
```css
/* Specify in CSS */
2019-10-18 10:55:38 +03:00
code { font-family: 'Fira Code', monospace; }
@supports (font-variation-settings: normal) {
code { font-family: 'Fira Code VF', monospace; }
}
2019-03-11 21:44:23 +03:00
```
2020-02-07 00:35:37 +03:00
- IE 10+, Edge Legacy: enable with `font-feature-settings: "calt";`
2015-12-19 19:15:03 +03:00
- Firefox
2015-12-20 11:20:33 +03:00
- Safari
2016-11-30 21:39:19 +03:00
- Chromium-based browsers (Chrome, Opera)
2015-12-21 23:12:16 +03:00
- ACE
2016-11-30 21:40:27 +03:00
- CodeMirror (enable with `font-variant-ligatures: contextual;` )
2016-07-18 18:02:34 +03:00
2017-02-15 22:07:49 +03:00
### Projects using Fira Code
2017-02-16 12:17:37 +03:00
- [CodePen ](https://codepen.io/ )
2017-02-15 22:07:49 +03:00
- [Blink Shell ](http://www.blink.sh/ )
- [Klipse ](http://app.klipse.tech/ )
- [IlyaBirman.net ](http://ilyabirman.net/ )
- [EvilMartians.com ](https://evilmartians.com/ )
2018-03-11 22:54:23 +03:00
- [Web Maker ](https://webmakerapp.com/ )
2018-03-31 19:10:28 +03:00
- [FromScratch ](https://fromscratch.rocks/ )
2018-09-20 07:04:12 +03:00
- [PEP20.org ](https://pep20.org/ )
2016-07-18 18:02:34 +03:00
2015-07-16 20:13:24 +03:00
### Alternatives
2020-05-18 00:34:17 +03:00
Free monospaced fonts with ligatures:
2020-04-09 19:56:19 +03:00
- [Hasklig ](https://github.com/i-tu/Hasklig )
- [Monoid ](http://larsenwork.com/monoid/ )
- [Fixedsys Excelsior ](https://github.com/kika/fixedsys )
- [Iosevka ](https://be5invis.github.io/Iosevka/ )
- [DejaVu Sans Code ](https://github.com/SSNikolaevich/DejaVuSansCode )
- [Victor Mono ](https://rubjo.github.io/victor-mono/ )
- [Cascadia Code ](https://github.com/microsoft/cascadia-code )
- [JetBrains Mono ](https://github.com/JetBrains/JetBrainsMono )
Paid monospaced fonts with ligatures:
- [PragmataPro ](http://www.fsd.it/fonts/pragmatapro.htm )
2021-01-05 15:06:04 +03:00
- [Mono Lisa ](https://www.monolisa.dev/ )
2015-07-16 20:13:24 +03:00
2019-05-21 17:21:07 +03:00
### Building Fira Code locally
2019-04-04 23:05:55 +03:00
2020-07-14 09:03:51 +03:00
In case you want to alter FiraCode.glyphs and build OTF/TTF/WOFF files yourself, this is the setup I use on macOS:
2019-04-04 23:05:55 +03:00
2019-05-21 17:21:07 +03:00
```bash
# install all required build tools
2021-11-12 05:04:44 +03:00
./script/bootstrap_macos.sh
2019-04-04 23:05:55 +03:00
2019-05-21 17:21:07 +03:00
# build the font files
2021-11-12 05:04:44 +03:00
./script/build.sh
2019-05-21 17:21:07 +03:00
# install OTFs to ~/Library/Fonts
2021-11-12 05:04:44 +03:00
cp distr/otf/*.otf ~/Library/Fonts
```
Alternatively, you can build Fira Code using Docker:
```bash
# install dependencies in a container and build the font files
make
# package the font files from dist/ into a zip
make package
2019-05-21 17:21:07 +03:00
```
2019-04-04 23:05:55 +03:00
2022-03-08 14:33:10 +03:00
If you want to *permanently enable* certain style sets or character variations, maybe because your editor of choice does not allow you to toggle these individually, you can provide the desired features as a comma separated list to the build script via the `-f / --features` flag.< br > Default: none.
To separate different versions of your font you can specify the desired font family name with the `-n / --family-name` flag. The special value 'features' will append a sorted, space separated list of enabled features to the default family name.< br > Default: "Fira Code"
You can also limit the font weights that will be created with the `-w / --weights` option.< br > Default: "Light,Regular,Retina,Medium,SemiBold,Bold"
```bash
# locally in your shell
./script/build.sh --features "ss02,ss08,ss10,cv03,cv07,cv14" --family-name "Fira Code straight" --weights "Regular,Bold"
# or via a docker container (creates the family name 'Fira Code cv01 cv02 cv06 cv31 onum ss01 ss03 ss04 zero')
docker run --rm -v "${PWD}":/opt tonsky/firacode:latest ./script/build.sh -f "cv01,cv02,cv06,ss01,zero,onum,ss03,ss04,cv31" -n "features"
```
2014-11-11 22:47:04 +03:00
### Credits
2016-04-16 18:16:36 +03:00
- Author: Nikita Prokopov [@nikitonsky ](https://twitter.com/nikitonsky )
- Based on: [Fira Mono ](https://github.com/mozilla/Fira )
2018-09-20 07:04:12 +03:00
- Inspired by: [Hasklig ](https://github.com/i-tu/Hasklig )