Claricle

Colors give us clarity

Claricle is a family of pure-Ruby libraries for image validation, conversion, compression, and vector graphics — the publication pipeline's essential image suite.

Explore the ecosystemView on GitHub
  • Conformance
  • Conversion
  • Page description
  • Parsers
  • Layout & diagrams

One image suite, every publication task

Four jobs, one ecosystem. Pick what you need, or pull in claricle for the umbrella CLI.

Validate

Check PNG, SVG, and PDF files against the standards. Catch corruption before it reaches your pipeline.

Convert

Move between EPS, PS, EMF, and SVG with no external binaries. Pure Ruby, deterministic output.

Compose

Lay out diagrams, render PlantUML and Mermaid, and emit SVG that any document pipeline accepts.

Render

Parse PostScript and PDF at the object level. Read, transform, and emit without re-rendering.

The ecosystem

Batteries-included image tooling

Each library does one thing well. Together they cover the publication image pipeline end to end.

Claricle

Suite & resources

The umbrella CLI for the Claricle image suite.

A single gem that bundles Claricle's image utilities — validate, convert, and inspect PNG, SVG, EMF, EPS and friends from one command line. Currently a shim reserving the gem name; full functionality lands as the underlying libraries mature.

ruby
GitHubDocs

Vectory

Conversion

Pairwise vector image conversion in pure Ruby.

Convert between EPS, PS, EMF, and SVG without shelling out to Inkscape or Ghostscript. Vectory chains the parser and emitter gems in the Claricle ecosystem so a publication pipeline can move a single diagram across every format it touches.

ruby
GitHubDocs

SVG Conform

Conformance

SVG conformance validation and remediation.

Validates SVG against the W3C specification and repairs the common deviations produced by drawing tools. Use it as a gate in any pipeline that ingests third-party SVG.

ruby
GitHubDocs

PNG Conform

Conformance

PNG conformance checking for Ruby.

Validates PNG files against the ISO/IEC 15948 specification — chunk structure, IHDR constraints, ancillary chunk semantics. Catches the silent corruption that breaks downstream raster pipelines.

ruby
GitHubDocs

ELK.rb

Layout & diagrams

Eclipse Layout Kernel for Ruby.

Pure-Ruby implementation of the ELK layered layout algorithm. Lay out boxes-and-arrows diagrams (UML, flowcharts, schema diagrams) without a JVM dependency.

ruby
GitHubDocs

Sirena

Layout & diagrams

Diagram rendering for PlantUML and Mermaid.

Render PlantUML and Mermaid diagrams in Ruby. Sirena parses the source notation, lays out the elements via ELK.rb, and emits SVG ready for documentation pipelines.

ruby
GitHubDocs

See all projects →

One gem, every image task

gem install claricle pulls in the umbrella CLI. Use it to validate, convert, and inspect images from a single command.

Read the brand storyOpen the repo