Skip to content

Releases

Typestash 0.2.0 · themes, a real compare, and a command bar

Choose a tag to compare

@jatinkrmalik jatinkrmalik released this 21 Nov 23:21

Typestash 0.2.0 · themes, a real compare, and a command bar

Try the live demo → · Website

Typestash is now public. This release turns the first cut into something you can live in: twelve themes, a compare view built for actually choosing between fonts, a command bar that does everything, and a lot of polish.

Compare fonts side by side

✨ What's new

⇆ Compare, rebuilt

  • Side by side: a colour-coded column per font with a big Aa, your sample, a paragraph, the full character set and metric bars (x-height, cap height, ascender, descender, average width, glyphs, styles) scaled against each other. Sections line up across columns.
  • Rows for quick scanning and Overlay, which stacks one word from every font on a shared baseline so width and x-height differences jump out.
  • One weight slider drives every font: variable fonts glide, static families snap to their nearest style.
  • Reorder with ← →, add from anywhere, or start from Serif vs sans vs mono, 3 random fonts or your favourites.

🎨 12 themes

  • Light: Paper, GitHub Light, Solarized Light, Catppuccin Latte, Gruvbox Light, Rosé Pine Dawn.
  • Dark: Ink, Dracula, Nord, Catppuccin Mocha, Gruvbox Dark, Tokyo Night.
  • Match system switches between your favourite light and dark theme with the OS. Every theme passes WCAG AA contrast for text.

⌘ Command bar

  • ⌘K on macOS, Super+K on Linux, Ctrl+K on Windows.
  • Jump to any font or collection, switch theme, change view, sort and filters, rescan, set preview text, open the project links. On a font's page it can also download, favourite, compare or export a specimen.
  • The library filter and the command bar work together: whatever you typed carries over.

🔤 Preview presets and scripts

  • Save your own sample texts as one-click presets, and edit them in Settings.
  • A Scripts menu built from your library: preview Cyrillic, Greek, Arabic, Devanagari, Hebrew, Thai and more, and see only the fonts that can render them.

⚙️ And more

  • Settings page: appearance, preview defaults, presets, keyboard shortcuts, server info.
  • Collapsible sidebar ([), Surprise me in the header, a nerdy terminal-style footer with live library stats, and a cleaner header with a drop-zone Add fonts button.
  • Specimen PNGs now carry a Typestash brand row with the repo link.
  • New ts▌ icon.
  • Fixes: long file paths on family pages, footer position on short pages, phone layouts, sticky offsets.

🚀 Install or upgrade

docker pull ghcr.io/jatinkrmalik/typestash:0.2.0

Or with Compose, docker compose pull && docker compose up -d. Your fonts folder and /data carry over; the index rebuilds itself once to pick up new font metrics.

Image ghcr.io/jatinkrmalik/typestash
Tags 0.2.0 · 0.2 · latest (plus edge from main)
Platforms linux/amd64 · linux/arm64

🙏 Thanks

Built on fontTools. The demo uses families from Google Fonts under the SIL Open Font License. If Typestash is useful, buy me a coffee or sponsor it on GitHub.

Full changelog: v0.1.0...v0.2.0

Typestash 0.1.0 · first release

Choose a tag to compare

@jatinkrmalik jatinkrmalik released this 21 Nov 04:20

Typestash 0.1.0 · first release

Every font you own, in one drawer you can open from any browser.

Fonts pile up everywhere: client zips, old laptops, that one typeface you bought for a wedding invite. Typestash points at a folder on your server, reads what's actually inside every font file, and turns it into a gallery you can search, test, organise and download from. Your fonts stay plain files: Samba, rsync and backups keep working exactly as before.

Typestash gallery

✨ Highlights

See every font, set in itself

  • A live gallery where each card is drawn in its own font, with your own sample text and size
  • Hover a card to sweep through its weights: variable fonts glide, static families flip through styles
  • Grid or list view, sort by name, newest, most styles, or shuffle

Find the right one fast

  • Real metadata read with fontTools: family, style, weight, width, designer, foundry, version, license
  • Filter by sans, serif, mono, display, script, variable fonts, families with italics
  • Filter by language support: Latin, Cyrillic, Greek, Arabic, Hebrew, Devanagari, Bengali, Tamil, Thai, CJK, Hangul, Kana
  • Categories are detected from the letterforms themselves, and you can override any of them
  • Ctrl/⌘ K command bar to jump to any font, collection or action

Try before you use it

  • Type tester with variable-axis sliders (and an animate button), named instances, OpenType feature toggles, size, leading, tracking, alignment and colour themes
  • Glyph map with an inspector: click to look closer, double-click to copy
  • Waterfall from 12 to 96 px, pairing suggestions for heading and body, and compare up to 8 fonts side by side

Keep it tidy

  • Favourites, collections (download a whole collection as a zip) and searchable notes
  • Drag fonts or .zip archives anywhere on the page: validated, de-duplicated by content, filed as Uploads/<Family>/
  • A Duplicates & issues page for identical files and fonts that won't open. Nothing is ever deleted.

Take it with you

  • Download a single style, a whole family as a zip, or a PNG specimen sheet
  • TTF, OTF, WOFF, WOFF2 and TTC/OTC collections

Family page

🚀 Install

mkdir -p typestash/fonts typestash/data && cd typestash
docker run -d --name typestash -p 8080:8080 \
  -v "$PWD/fonts:/fonts" -v "$PWD/data:/data" \
  -e PUID=$(id -u) -e PGID=$(id -g) \
  --restart unless-stopped \
  ghcr.io/jatinkrmalik/typestash:0.1.0

Then open http://localhost:8080 and drop some fonts on the page. Prefer Compose or Unraid? See the README.

Image ghcr.io/jatinkrmalik/typestash
Tags 0.1.0 · 0.1 · latest (plus edge from main)
Platforms linux/amd64 · linux/arm64
Inside one Python file + plain HTML, CSS and JS, no build step

🏠 Made for self-hosting

  • PUID / PGID so everything it writes is owned by you
  • Optional login with TYPESTASH_PASSWORD, or leave it to Authelia, Authentik, oauth2-proxy and friends
  • Read-only mode with TYPESTASH_UPLOADS=false
  • Works behind Caddy, Traefik or nginx, at a domain or a sub-path
  • Health check built in, state in a single SQLite file under /data
  • Unraid template included

📝 Good to know

  • This is a first release: expect rough edges and please open an issue when you hit one.
  • Automatic categories are right most of the time; a few display and script faces will need a one-click override.
  • Typestash is a library, not a license. Only share fonts you're allowed to share.

🙏 Thanks

Built on fontTools. Demo and screenshots use families from Google Fonts under the SIL Open Font License.

Full source: v0.1.0 · MIT licensed