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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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.