Repository navigation
Releases
Releases · Iosevka-Mayukai/sawala-mono-dev
Sawala Mono v1.0.0-13112026
Sawala Mono v1.0.0
Welcome to the first stable release of Sawala Mono (v1.0.0), a developer-centric monospace coding typeface built on top of Iosevka v34.9.1.
Named after the Sundanese word sawala (discussion, deliberation, or intellectual exchange), Sawala Mono is engineered around a simple principle: code is read, reviewed, and reasoned about by humans far more often than it is written. Every glyph choice, proportion, and distribution variant is tuned for long-session legibility across IDEs, code reviews, and terminal workflows.
Highlights
- Four Purpose-Built Distributions: Ships as Sawala Mono (with programming ligatures), Sawala Mono NL (No Ligatures), Sawala Mono NF (Nerd Font), and Sawala Mono NL NF (Nerd Font + No Ligatures)—all sharing one parametric metric core (
Normalwidth500,SemiExtendedwidth548,9.4°italic slope). - Refined Human-Centric Glyph Geometry: Built on the
ss03preset with high-distinction character shapes includingreverse-slashedzero (upright) andtall-reverse-slashedzero (italic),curly-flat-boundarybraces,large-contourparentheses,base-long-top-serif1,bend-serifless7, and semi-tailed cursive italic forms. - Automated Cloud Build & Nerd Font Patching: Includes containerized GitHub Actions workflows for reproducible TTF/WOFF2 font builds and standalone Nerd Font (
--mono --complete) patching acrosscore,extended-core, andallweight scopes. - Interactive Web Showcase & Documentation: Includes a static documentation and live font-testing site deployed via GitHub Pages with a polyglot code runner, ligature playground, glyph inspector, and editor configuration generator.
Font Distributions & Release Archives
Choose the archive that matches your editor and terminal setup:
| Distribution | Family Name | Ligatures | Nerd Font Icons | Release Archive (v1.0.0) |
Recommended For |
|---|---|---|---|---|---|
| Sawala Mono | Sawala Mono |
Yes (default-calt) |
No | SawalaMono-v1.0.0.zip |
VS Code, JetBrains IDEs, Zed |
| Sawala Mono NL | Sawala Mono NL |
No (noLigation) |
No | SawalaMonoNL-v1.0.0.zip |
Literal symbol & strict operator coding |
| Sawala Mono NF | Sawala Mono NF |
Yes (default-calt) |
Yes (10,000+ glyphs) | SawalaMono-NF-v1.0.0.zip |
Terminals, Neovim, Tmux, Starship |
| Sawala Mono NL NF | Sawala Mono NL NF |
No (noLigation) |
Yes (10,000+ glyphs) | SawalaMonoNL-NF-v1.0.0.zip |
Terminals without ligatures |
Note
- Standard archives (
SawalaMono-v1.0.0.zipandSawalaMonoNL-v1.0.0.zip) include 9 weights × 2 widths (Normal,SemiExtended) × 2 slopes (Upright,Italic) (36 styles per distribution). - Nerd Font
corearchives (*-NF-v1.0.0.zip) bundle the 8 Normal coding weights (Regular,Italic,Medium,MediumItalic,SemiBold,SemiBoldItalic,Bold,BoldItalic). - Nerd Font
extended-corearchives (SawalaMono-Extended-NF-v1.0.0.zipandSawalaMonoNL-Extended-NF-v1.0.0.zip) bundle the 8 SemiExtended coding weights.
What's New
Typography & Design Specifications
Configured declaratively in private-build-plans.toml:
- Shared Structural Core: Sans-serif base (
serifs = "sans"), normal spacing (spacing = "normal"),ss03character variant inheritance, and dedicated family namespaces that install cleanly side-by-side with upstream Iosevka. - Upright (
0°) Key Variants: Double-storey taileda, toothless corner seriflessb/d/u, earless cornerm/n/p/q, symmetric connectedk,large-contourparentheses,curly-flat-boundarybraces, andreverse-slashed0. - Italic (
9.4°) Key Variants: True cursive-inspired italic with single-storeyaandg, flat-bottomb/d, flat-hook tailedf, serifed semi-tailedi/l, cursivek, flat-hook short-neckt, andtall-reverse-slashed0.
CI/CD Workflows & Interactive Showcase
- Docker Font Compiler CI: Containerized build pipeline in
.github/workflows/build.ymlsupportingvariant(all,SawalaMono,SawalaMonoNL),format(ttf,woff2,contents), and automated GitHub Release packaging. - Standalone Nerd Font Patcher CI: Containerized
nerdfonts/patcher:latestworkflow in.github/workflows/patch-nerd-font.ymlwithvariant,patch_mode(complete,default),font_scope(core,extended-core,all), andcustom_nameoverride support. - Static Web Showcase & GitHub Pages CI: Interactive showcase site (
index.htmland.github/workflows/pages.yml) featuring live WOFF2 rendering, a 5-language polyglot runner with Prism.js syntax highlighting, ligature catalog, distribution matrix, and OS/editor setup generators.
Installation & Upgrade Guide
- Upgrading from
v1.0.0-beta*Pre-releases:- Remove previously installed
v1.0.0-beta*font files before installingv1.0.0to prevent stale font-cache conflicts. - Windows: Extract the
.zip, select all.ttffiles, right-click, and choose "Install for all users" (recommended for JetBrains IDEs and Java runtimes). - macOS: Drag the extracted
.ttffiles into Font Book and confirm replacement if prompted. - Linux: Copy
.ttffiles to~/.local/share/fonts/SawalaMono/and runfc-cache -f -v.
- Remove previously installed
- Editor & Terminal Configuration:
- Configure
"Sawala Mono"(or"Sawala Mono NL"with"editor.fontLigatures": false) in IDEs, and"Sawala Mono NF"(or"Sawala Mono NL NF") in terminal emulators and Neovim. - See the README for copy-paste configuration snippets for VS Code, JetBrains IDEs, Neovim/Neovide, Alacritty, Kitty, WezTerm, and Windows Terminal.
- Configure
- Notes on Archive Naming:
- If you consumed earlier beta Nerd Font archives,
SemiExtendedNerd Font builds are now packaged separately as*-Extended-NF-<tag>.zipwhen built withfont_scope: extended-core.
- If you consumed earlier beta Nerd Font archives,
Bug Fixes & Stability
- Glyph & Variant Standardization: Standardized upright and italic glyph identifiers in
private-build-plans.toml(n,b,six,nine,l), added the missing italicivariant (serifed-semi-tailed), and aligned italiczerototall-reverse-slashed. - Build & Packaging Reliability: Refined environment variable handling and release title generation in
.github/workflows/build.yml, upgradeddocker/build-push-actiontov6, and ensured intermediateTTF-Unhinted/WOFF2-Unhinteddirectories are stripped from final release archives. - Nerd Font Patching Hardening: Added strict variant filtering,
extended-corescope support, and automaticNLsuffix handling forcustom_nameoverrides in.github/workflows/patch-nerd-font.yml. - Lean Repository Footprint: Streamlined downstream fork assets while preserving upstream compiler dependencies (
build-plans.toml,packages/*,tools/*, anddoc/references), documented indocs/ARCHITECTURE.md.
License & Acknowledgments
- License: Distributed under the SIL Open Font License 1.1.
- Upstream Foundation: Built with deepest gratitude on Iosevka by Belleve Invis and the Iosevka contributor community, and patched using Nerd Fonts.
Full Changelog: v1.0.0-beta3bc...v1.0.0-13112026