Skip to main content

Folioforge

A shared asset library for icons, logos, banners, and brand artwork. Cloudinary is the planned delivery and transformation layer; Notion, websites, and other applications are consumers.

Status

Version 0.0.0 is the initial foundation release. It provides version/help commands and an offline unsigned Cloudinary URL builder. Upload, download, inventory, cover generation, and consumer synchronization are planned, not implemented yet.

Install

uv tool install folioforge
# or: pip install folioforge
folioforge --version
folioforge url brands/acme/logo.svg --cloud example
folioforge url brands/acme/logo.svg --cloud example --gray

The path includes the asset extension. The URL command neither uploads nor checks asset existence. It targets public image/upload assets. Gray delivery uses flat #808080 colorization and PNG output; it does not promise transformed SVG output. White overlays in a logo should be converted to genuine transparent cutouts before flattening colors.

Direction

  • One canonical color master per distinct symbol, wordmark, lockup, or artwork; genuine SVG preferred.
  • Generate size, format, padding and monochrome derivatives rather than uploading duplicate masters.
  • Inventory, upload, download, deduplicate, and generate delivery URLs across a portable asset registry.
  • Compose full logos with reusable translucent background templates; use brand palettes and explicit or seeded random template selection.
  • Separate the core library, storage adapters, renderers and consumer adapters so a future UI reuses the CLI's services.
  • Plan and preview changes, preserve provenance and references, and verify migrations before retiring assets.

See docs/ARCHITECTURE.md for the initial roadmap.

Development

Python 3.11+, uv, and Git. No runtime dependencies in this initial release.

uv sync
uv run python -m unittest discover -s tests
uv build --no-sources

Apache-2.0 licensed.

Metadata

Release files for folioforge 0.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for folioforge 0.0.0
File Size Uploaded Provenance Actions
folioforge-0.0.0.tar.gz 8.2 kB Without provenance Details for folioforge-0.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for folioforge 0.0.0
File Interpreter ABI Platform Actions
folioforge-0.0.0-py3-none-any.whl Python 3 none any Details for folioforge-0.0.0-py3-none-any.whl

Total release size: 16.4 kB

Release files / folioforge-0.0.0.tar.gz

Download URL folioforge-0.0.0.tar.gz
Size 8.2 kB
Tags Source
SHA-256 checksum
How to use checksums
cf3568b3c3cfb2d606aca3894142838ef7380680f908c2ba8acbc52593f785db
BLAKE2b-256 checksum
How to use checksums
58655c1a1e3ba5fcca6681e2449cd6039366e7470ba803e48aa93f5bb5d49ef9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / folioforge-0.0.0-py3-none-any.whl

Download URL folioforge-0.0.0-py3-none-any.whl
Size 8.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5dfa636503f9993f21ec7f0e13c6aa66f52dc77a923057d5349b47ddbab47db9
BLAKE2b-256 checksum
How to use checksums
ad5466bc2f8c5b76cd2e94e252c13b9fc5e247e92e5d91427dfae0e406f823f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for folioforge 0.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page