Skip to content

Repository files navigation

Formfeed packages

Client libraries, command line tools and integrations for Formfeed, the API for generating PDFs and images from templates. Documentation lives at docs.formfeed.dev.

Package Registry What it is
@formfeed/sdk npm TypeScript client: renders, batches, templates, webhooks. No dependencies, Web APIs only
formfeed PyPI Python client, sync and async
formfeed npm CLI: templates as files, offline preview and validation, renders through the API
@formfeed/engine npm The template engine (Jinja2, Liquid, Handlebars) the API and the editor use
@formfeed/devkit npm Template folders, project config and local rendering
@formfeed/testing npm Vitest and Jest matchers for templates
@formfeed/mcp npm Model Context Protocol server for AI agents formfeed MCP server – quality and maintenance score on Glama
n8n-nodes-formfeed npm n8n community node

Every npm package is built and published from this repository by GitHub Actions with provenance, and the Python package with trusted publishing, so each release can be traced to the commit and workflow run it came from.

Development

Node 22 or newer and pnpm (the version in package.json, corepack enable picks it up):

pnpm install
pnpm nx run-many -t lint test --exclude sdk-python   # TypeScript packages
pnpm nx run-many -t bundle smoke                     # build, pack and try every npm package
cd packages/sdk-python && pip install pytest httpx pydantic && python -m pytest -q

This repository is generated from Formfeed's main repository, where the packages are developed together with the API they talk to. See CONTRIBUTING.md for how issues and pull requests are handled.

Licence

MIT, see LICENSE. Bundled third-party code keeps its own licence; the CLI and MCP packages list it in THIRD_PARTY_LICENSES.md.

Releases

Packages

Contributors

Languages