Ioskeley Mono Documentation

repository·main·Indexed 23 days ago

https://github.com/ahatem/ioskeleymono

A free, open-source typeface designed as a visual alternative to Berkeley Mono, created using a custom configuration of the Iosevka font engine. Includes specialized variants such as Term for terminal rendering and NL for applications that cannot disable ligatures, as well as Nerd Font versions. Provides instructions for installation across macOS, Windows, and Linux, CSS weight values, and steps to build the font from source.

Tokens
748
Snippets
1
Records
5
Agent score
32%

What's inside Ioskeley Mono

  1. Understand Ioskeley Mono variants (Term and NL)

    main

    Ioskeley Mono provides specialized variants for specific rendering needs:

    Term variant (Ioskeley Mono Term)

    Uses spacing = "term", which constrains every glyph to its cell boundary. Use this if arrows (→ ← ↑ ↓), box-drawing characters, or ligatures render incorrectly in your terminal (e.g., in kitty or Ghostty). The glyph design is identical to the standard variant; only the spacing changes.

    NL variant (Ioskeley Mono NL)

    Has all ligature substitutions disabled. Use this in applications that cannot toggle ligatures off (e.g., Xcode). All other metrics, weights, and glyph shapes remain identical to the standard variant.

  2. Install Ioskeley Mono

    main

    To install Ioskeley Mono, download the latest release from the Releases page.

    Installation Steps

    1. Download and unzip your chosen file.
    2. Open the width and hint folder that matches your setup.
    3. Select all .ttf files and install:
      • macOS: Double-click any font → Install Font, or drag all into Font Book.
      • Windows: Select all → right-click → Install for all users.
      • Linux: Copy to ~/.local/share/fonts/ then run fc-cache -fv.
  3. Build Ioskeley Mono from source

    main

    Ioskeley Mono is a configuration of Iosevka. To build it locally, you must clone both the Ioskeley Mono configuration and the Iosevka repository, then run the Iosevka build process.

    git clone https://github.com/ahatem/IoskeleyMono.git
    git clone --depth 1 https://github.com/be5invis/Iosevka.git
    
    cp IoskeleyMono/private-build-plans.toml Iosevka/
    cd Iosevka
    npm install
    npm run build -- contents::IoskeleyMono contents::IoskeleyMonoTerm

    Output will be located in Iosevka/dist/IoskeleyMono/ and Iosevka/dist/IoskeleyMonoTerm/.

  4. Select the correct Ioskeley Mono distribution

    main

    Choose the appropriate .zip file based on your environment and requirements:

    SituationDownload
    Editor or IDE (VS Code, JetBrains, Zed…)IoskeleyMono.zip
    Terminal with icons (Neovim, Starship…)IoskeleyMono-NerdFont.zip
    Arrows or box-drawing look wrong in my terminalIoskeleyMono-Term.zip
    Terminal with icons and rendering issuesIoskeleyMono-Term-NerdFont.zip
    App that can't disable ligatures (Xcode…)IoskeleyMono-NL.zip
    Same, but also need Nerd Font iconsIoskeleyMono-NL-NerdFont.zip
    Web / CSS (@font-face)IoskeleyMono-Web.zip

    Recommendation: If you are unsure, start with IoskeleyMono.zip.

  5. Reference Ioskeley Mono weights and CSS values

    main

    Ioskeley Mono supports a full weight axis across all widths. Use the following CSS values to specify weights:

    WeightCSS value
    Thin100
    ExtraLight200
    Light300
    SemiLight350
    Regular400
    Medium500
    SemiBold600
    Bold700
    ExtraBold800
    Black900