Skip to content

fontpub-org/fontpub-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

75 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fontpub CLI

Fontpub CLI is the reference implementation of the Fontpub Protocol (FPP).
It enables decentralized publishing, verification, and curation of fonts using only standard web formats and modern cryptographic primitives (HTTP, JSON, and Ed25519).

Note: Fontpub is in an early beta stage. Things may still change — schemas, commands, and verification logic are being refined as the project evolves. Feedback and experiments are very welcome!

Installation

For now, build from source:

git clone https://github.com/fontpub-org/fontpub-cli.git
cd fontpub-cli
make build

This creates the binary at ./bin/fontpub.

A one-line installer (e.g. curl https://cli.fontpub.org | sh) will be provided in a future release.

For Font Users

Fontpub lets you install and manage fonts distributed via the Fontpub Protocol.

Typical usage:

# Install a font from its manifest URL or package ID
fontpub install https://example.com/fonts/fontpub.json

# List installed fonts
fontpub list

# Activate fonts (symlink into your user font directory)
fontpub activate

To verify a manifest or ownership proof:

fontpub verify https://example.com/fonts/fontpub.json

You can also register curations (lists of verified fonts) to make installation easier:

fontpub curation add https://example.com/fontpub-curation.json

For detailed, see docs/for_font_users.md.

For Publishers (Font Developers)

Publishers use Fontpub to sign and distribute their own fonts.

Typical workflow:

# Generate an Ed25519 keypair (only first time)
fontpub keys generate

# Generate a manifest (fontpub.json)
fontpub manifest init

# Sign the manifest
fontpub manifest sign

This produces a signed fontpub.json ready to be hosted alongside your font files.
Optionally, you can prove domain ownership.

For detailed, see docs/for_publishers.md.

For Curators

A Curator is someone who creates and shares curated collections of fonts —
for example, “modern sans-serifs for UI design” or “my favorite coding fonts”

You can create a fontpub-curation.json that lists your favorite fonts,
so others can install them easily with Fontpub.

For detailed, see docs/for_curators.md.

See Also

License

The MIT License (MIT)

Copyright (c) 2025 Fontpub

About

CLI for the Fontpub Protocol — publish, validate, and update open fonts.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published