Contributing¶

Tiparo is primarily a personal type library, so contributions are not expected. Still, corrections to font metadata and licensing are welcome through issue or pull request submissions.

Quick Start¶

git clone https://github.com/leightonpayne/tiparo
cd tiparo
bun install
uv sync --group docs

Development Commands¶

Command	Description
`bun run dev`	Start the app locally
`bun run build`	Build the app
`bun run docs:serve`	Serve docs locally
`bun run docs:build`	Build docs locally
`bun run pages:build`	Build the combined Pages artifact

Project Structure¶

content/   # font metadata, tracked previews, archive config
docs/      # docs source
scripts/   # content and deployment helpers
src/       # React app

Making Changes¶

Make the smallest coherent change.
If you changed app behavior, run bun run build.
If you changed docs, run bun run docs:build.
If you changed deployment-relevant behavior, run bun run pages:build.

Submitting Changes¶

Open an issue or start a discussion first if the change is substantial.
Keep content edits, styling changes, and deployment changes clearly scoped.
Make sure generated files are up to date before opening a pull request.

Content Changes¶

For changes involving fonts:

Update family.toml.
Sync tracked preview assets with bun run fonts:sync -- <font-id>.
Regenerate the runtime manifest via bun run content:sync or any normal app build.