base on An innovative superfamily of fonts for code # Monaspace The Monaspace type system is a monospaced type superfamily with some modern tricks up its sleeve. It consists of five variable axis typefaces. Each one has a distinct voice, but they are all metrics-compatible with one another, allowing you to mix and match them for a more expressive typographical palette. Letters on a grid is how we see our code. Why not make those letters better? ✨ An exploration from [GitHub Next](https://githubnext.com). ✨ See the full story of Monaspace at [monaspace.githubnext.com](https://monaspace.githubnext.com). 🔤 **[Download the latest release](https://github.com/githubnext/monaspace/releases/latest)** 🔤  ## Overview Monaspace is five interchangable type families, each of which is packaged into three distinct formats. You can install all of them side-by-side; their family names are distinct by family and format. For example: - `Monaspace _____`: the static family. - `Monaspace _____ Var` or `VF`: the variable family - `Monaspace _____ Frozen`: the "frozen" TTF family. These fonts enable all of the typographical features in Monaspace by default. They are intended to be used in environments where you might not be able to configure stylistic sets or character variants, like XCode or IntelliJ IDEs. See more about how the frozen fonts work below. The variable fonts have one file per family (Neon, Argon, etc.). Modern and convenient! The static fonts have one file per cut, per family. The variable axes have named stops for each axis, like `light` or `bold` for weight, `italic` for italics, and `semiwide` or `wide` for width. The combinatorial explosion of all these properties means the complete installation of static fonts involves hundreds of font files. But for situations that don't yet support variable fonts, the static builds give you a wide variety of stops throughout the range of each axis. ## Texture Healing Monaspace pioneered the technique of "texture healing" for monospaced fonts:  Texture healing is enabled when the `calt` font feature setting is turned on in your editor. The location for this setting varies across applications, and not all applications support it. See the [Editors](#editors) section below for specific guidance. You can read more about how it works on the [Monaspace website](http://monaspace.githubnext.com), and learn how it is implemented in the [documentation](https://github.com/githubnext/monaspace/blob/main/docs/Texture%20Healing.md). ## Nerd Fonts As of Monaspace 1.2, the static font builds (both OTF and WOFF/WOFF2) include [Nerd Fonts](https://www.nerdfonts.com/)! Monaspace gives a lot of consideration to horizontal and vertical metrics of a font, and Nerd Fonts are thousands of icons which don't necessarily respect those considerations. Monaspace makes a best-effort attempt to optically align the size and placement of the icons so that they feel compatible with the other Monaspace glyphs. There is such a broad variety of environments and terminals and often solving for one breaks another! Some Nerd Fonts glyphs may not render correctly in every environment. > [!NOTE] > Monaspace uses the [Nerd Fonts implementation from Cascadia Code](https://github.com/microsoft/cascadia-code/tree/main/sources/nerdfonts/full/processed) as our starting point. Each icon was resized to fit the max advance width of the given Monaspace font, and centered vertically between the baseline and cap height of Monaspace's vertical metrics. ## Coding Ligatures > [!WARNING] > Ligature handling has changed significantly in Monaspace point releases. > If you're upgrading, check the release notes to learn what changes you might need to make to your editor configuration: > - [v1.1](https://github.com/githubnext/monaspace/releases/tag/v1.100) > - [v1.101](https://github.com/githubnext/monaspace/releases/tag/v1.101) > - [v1.2](https://github.com/githubnext/monaspace/releases/tag/v1.200) The `liga` font feature enables customized spacing of repeating characters, like `///` or `||`. It is designed to avoid activating inside longer sequences like `////`. There are ten groups of coding ligatures, separated into stylistic sets. You may be able to enable or disable individual sets selectively: * `ss01`: ligatures related to the equals glyph like `!=` and `===`. * `ss02`: ligatures for greater/less or equal (`<=`, `>=`). * `ss03`: ligatures related to arrows like `->` and `~>`. * `ss04`: ligatures related to markup, like `</` and `/>`. * `ss05`: ligatures related to the F# programming language, like `|>`. * `ss06`: ligatures related to repeated uses of `#`, `+`, and `&`. * `ss07`: ligatures related to colons like `::` or `=:=`. * `ss08`: ligatures related to combinations of periods with other glyphs like `..=` or `.-`. * `ss09`: ligatures related to combinations of the greater/less than and equals signs, like `<=>`,`>>`, and `=<<`. * `ss10`: other tags, like `#[` and `#(` 👉 You can see an interactive display of all the ligatures [on the Monaspace website](http://monaspace.githubnext.com/#code-ligatures) ## Character Variants Specific characters have variants that you can optionally enable using the `cvNN` opentype feature: #### cv01-cv09: figure variants - `cv01`: `0` alternates - 1: plain - 2: slash - 3: reverse slash - 4: cut-out slash - `cv02`: `1` alternate (no serif) #### cv10-cv29: letter variants - `cv10`: `l` `i` alternates (Neon, Argon, Xenon, Radon) - `cv11`: `j` `f` `r` `t` alternates (Neon, Argon) #### cv30-cv59: symbol variants - `cv30`: `*` vertically aligned closer to the top of the space, similar to how the asterisk was in Monaspace 1.0 - `cv31`: `*` 6-pointed asterisk - `cv32`: `≥` `≤` angled lower line #### cv60-cv79: optional ligatures - `cv60`: forces the `<=` pair to render in a fashion that matches `=>` instead of swapping for `≤`. - `cv61`: enables the optional closed square ligature for `[]`. This can be distracting when authoring arrays in many editors, because they automatically insert the closing bracket, which immediately produces the closed square ligature upon typing the open bracket. - `cv62`: `@_` ligature ### cv80-cv99: reserved for future use - none (yet!) ## Special Characters Galore In addition to the ligatures, character variants, and Nerd Fonts, Monaspace includes a wealth of special characters.  ## Desktop Installation ### Upgrading Font caching on operating systems is an inscrutable mess dating back thirty years, and not something we can fix in Monaspace. Generally speaking, you should: - First delete the old fonts… - Then install the new fonts… - Then restart applications that use the fonts… - … and maybe restart your entire computer. Restarting is usually the only way to be 100% sure that the underlying machinery in the operating system picks up the new fonts. ### MacOS You can manually drag the fonts from the `fonts/otf`, `fonts/variable`, and `fonts/frozen` directories into Font Book. There is also a script that automates the deletion of all Monaspace fonts from `~/Library/Fonts` and then copies over the latest versions. Invoke it from the root of the repo like: ```bash $ bash util/install_macos.sh ``` You can also use [Homebrew](https://brew.sh/) as an alternative: ```bash brew install --cask font-monaspace ``` ### Windows You can manually drag the fonts from the `fonts/otf`, `fonts/variable`, and `fonts/frozen` directories into `C:\Windows\Fonts`. Alternatively, right-click the fonts you want and click Install. ### Linux You can manually drag the fonts from the `fonts/otf`, `fonts/variable`, and `fonts/frozen` directories into `~/.local/share/fonts`. There is also a script which automates the deletion of all Monaspace fonts from `~/.local/share/fonts` and then copies over the latest versions. Invoke it from the root of the repo like: ```bash $ bash util/install_linux.sh ``` ### Webfonts All files with a `.woff` or `.woff2` suffix are intended for use on the web. You do not install them with your operating system but add them to your web development project. As with the desktop fonts, they are available in variable and static versions. The webfonts do not come in a "frozen" format; you can easily control Opentype features on the web using the [`font-feature-settings`](https://developer.mozilla.org/en-US/docs/Web/CSS/font-feature-settings) CSS property. ## Editors ### Visual Studio Code > [!WARNING] > Ligature handling has changed significantly in Monaspace point releases. > If you're upgrading, check the release notes to learn what changes you might need to make to your editor configuration: > - [v1.1](https://github.com/githubnext/monaspace/releases/tag/v1.100) > - [v1.101](https://github.com/githubnext/monaspace/releases/tag/v1.101) > - [v1.2](https://github.com/githubnext/monaspace/releases/tag/v1.200) Set the font family: ```json "editor.fontFamily": "'Monaspace Neon', monospace", ``` Set an alternate family for inline suggestions: ```json "editor.inlineSuggest.fontFamily": "'Monaspace Krypton', monospace", ``` > [!NOTE] > Variable fonts are not yet well-supported in VS Code, and it is not yet possible to mix multiple fonts. Stay tuned, we're talking with the VS Code team about it! You must use the `editor.fontLigatures` setting to enable the various features (texture healing, ligatures, and character variants). The setting is a comma-separated list of font features to be enabled. > [!NOTE] > This setting is unavailable from the graphical settings editor; you must create it manually. - `calt`: enables texture healing - `liga`: enables dynamic spacing for certain repeating character patterns like `///` - `ss01`, `ss02`, etc: enables the specific stylistic set - `cv30`, `cv60`, etc: enables the specific character variants Putting it all together, a setting string which enables everything but the character variants would look like this: ```json "editor.fontLigatures": "'calt', 'liga', 'ss01', 'ss02', 'ss03', 'ss04', 'ss05', 'ss06', 'ss07', 'ss08', 'ss09'" ``` Specific character variants are also enabled using the [`font-feature-settings`](https://developer.mozilla.org/en-US/docs/Web/CSS/font-feature-settings) syntax. To enable slashed zeroes (with `cv01`) and six-pointed asterisks (with `cv31`), you might use the following settings: ```json "editor.fontLigatures": "'calt', 'liga', 'ss01', 'cv01' 2, 'cv31' 1" ``` Note that some character variants have several possible values. For any variants that are either on or off, setting them to `1` should enable them, and omitting the variant (or setting them to `0`) will disable them. ## Contribution There's no formal contribution guide yet! If you're interested in contributing to the typefaces, you should read the [Texture Healing](https://github.com/githubnext/monaspace/blob/main/docs/Texture%20Healing.md) guide, as it explains how to produce the necessary alternate glyphs. ### Renamer utility This convenience utility renames and moves the built fonts into their respective directories. You will need [Deno](https://deno.land) installed, and invoke it thus: ```bash $ ./util/renamer.ts --src="~/path/to/the/built/fonts" ``` ## License SIL OFL. See [LICENSE](https://github.com/githubnext/monaspace/blob/main/LICENSE). ## Support Please file issues in this repo. Monaspace is not a supported product; do not contact GitHub support with questions, as they do not support GitHub Next explorations. ## Contributors Monaspace was made to improve all code for all developers. [GitHub Next](https://githubnext.com) set out on this journey in 2022, and we were fortunate to find a type foundry that shares our passion for improving software in [Lettermatic](https://lettermatic.com/). The result is a marriage of form and function that opens the door to new developer experiences, and that would not have been possible without the domain expertise and skill of the Lettermatic team and the time they invested in working with GitHub Next on figuring out how typography ought to work for code. #### Lettermatic  - [Riley Cran](https://github.com/rileycran) - Danelle Cheney - Heather Cran #### GitHub Next  - [Cole Bemis](https://github.com/colebemis) - [Amelia Wattenberger](https://github.com/wattenberger) - [Krzysztof Cieślak](https://github.com/krzysztof-cieslak) - [Idan Gazit](https://github.com/idan) #### Special Thanks To - Anna Thomas - Marg Chronister - Jane Solomon ## Star History [](https://star-history.com/#githubnext/monaspace&Date) ", Assign "at most 3 tags" to the expected json: {"id":"4831","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"