xteink-cjk-font-maker

Web application for browsing published CrossPoint CJK fonts and generating an installable .cpfontpkg family package from a private TTF/OTF upload.

English | 简体中文 | 日本語

Current format

The primary conversion flow invokes the canonical Python/FreeType converter from aBER0724/crosspoint-cjk-fonts. It produces a deterministic <Family>.cpfontpkg ZIP container while preserving .cpfont v4 as the single-physical-size font format.

Every family package always contains the fixed UI sizes:

8 / 10 / 12 pt

Reader sizes are entered as a comma-separated list of positive integers from 1 to 255. At most 16 reader sizes may be requested; values are de-duplicated and sorted. The default is:

14 / 16 / 18 / 22 pt

The archive stores one multi-style-capable .cpfont v4 file per physical size and also includes manifest.json, SHA256SUMS, and build.json provenance. Current uploads provide Regular only; the package declares only styles that actually exist, allowing Reader-side weight fallback when Bold is unavailable. The device selects a physical file and does not scale CJK fonts at runtime.

The previous legacy-bin and experimental xbf2 converters remain under Legacy Tools. They are not the current SD-card catalog format.

Font Library

The native React catalog reads:

https://aber0724.github.io/crosspoint-cjk-fonts/catalog.json

It displays real .cpfont bitmap previews and links directly to the versioned GitHub Release. It does not proxy or re-host public font binaries. A catalog outage does not disable private conversion.

Features

• Browse, search, preview, and download verified public families
• Upload private TTF/OTF files up to 20 MiB
• Generate fixed 8/10/12 pt UI fonts plus a custom reader-size list as .cpfont v4 files
• Download one installable .cpfontpkg family package with a manifest, checksums, and build provenance
• Keep legacy-bin and experimental xbf2 compatibility tools
• Async jobs, conversion history, multilingual UI, and PWA support

Project layout

• Node server: server/index.ts
• API and job consumer: worker/src/api.ts, worker/src/consumer.ts
• Canonical converter adapter: worker/src/cpfont/
• React web app: web/
• Production image: Dockerfile
• Operations: docs/ops/limits.md

Local development

Requirements:

• Node.js 22
• npm
• Python 3.11
• sibling checkout ../crosspoint-cjk-fonts, or CPFONT_TOOL_ROOT

Prepare the canonical toolkit once:

cd ../crosspoint-cjk-fonts
python -m pip install -r requirements.txt
python scripts/fetch_fallback.py
cd ../crosspoint-cjk-font-maker

Install and verify Font Maker:

npm ci
npm test
npm run build
npm run dev

Endpoints:

• Node API: http://127.0.0.1:3000
• Vite app: http://127.0.0.1:5173
• Capability check: http://127.0.0.1:3000/api/capabilities

Optional variables:

• CPFONT_TOOL_ROOT: canonical toolkit checkout
• CPFONT_PYTHON: Python executable with pinned toolkit dependencies
• VITE_API_PROXY_TARGET: local API proxy target
• VITE_FONT_CATALOG_PAGE_URL: standalone catalog page opened by the Font Library link

The browser upload preview uses the source font and is approximate. The Font Library opens the separately deployed catalog, so catalog UI updates do not require rebuilding or redeploying the Maker image.

Docker

docker compose up --build

The production image uses Debian, Python virtualenv, the SHA-256-locked fallback, and a pinned crosspoint-cjk-fonts commit. Updating the toolchain pin is an explicit reviewed change.

For the Vite + API development stack:

docker compose -f docker-compose.dev.yml up --build

Verification

npm test
npm run build
docker build -t crosspoint-cjk-font-maker .

CI also starts the production image and requires /api/capabilities to report .cpfont version 4 and all seven sizes.