Skip to content

sugarcraft/candy-freeze

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

candy-freeze

CandyFreeze

CI codecov Packagist Version License PHP

demo

PHP port of charmbracelet/freeze — turn code or terminal output into an SVG screenshot. No ext-gd / Imagick required; the output is plain text suitable for git diffs and CI artifacts.

composer require sugarcraft/candy-freeze

CLI

echo "function hello() { return 'world'; }" \
    | candyfreeze --theme dracula --line-numbers > out.svg

candyfreeze input.php \
    --theme tokyo-night --no-window --output screenshot.svg

Flags:

  • --theme {dark|light|dracula|tokyo-night|nord} — colour palette.
  • --padding N — content padding inside the frame.
  • --no-window — drop the macOS-style traffic-light controls.
  • --no-shadow — drop the SVG drop-shadow filter.
  • --no-border — drop the frame outline.
  • --line-numbers — render a left-gutter line counter.
  • --border-radius N — corner radius of the frame.
  • -o/--output <path> — write SVG to a file instead of stdout.

Library

use SugarCraft\Freeze\SvgRenderer;

$svg = SvgRenderer::dracula()
    ->withLineNumbers(true)
    ->withWindow(true)
    ->withPadding(24)
    ->render($code);

file_put_contents('out.svg', $svg);

ANSI input is honoured — SGR foreground colours (16 / 256 / 24-bit truecolor) plus bold / italic / underline become <tspan> segments in the output.

$svg = SvgRenderer::dark()->render("\x1b[31merror:\x1b[0m something broke");

Themes

SvgRenderer::dark();        // charm-ish #0d1117
SvgRenderer::light();       // #f6f8fa
SvgRenderer::dracula();     // #282a36
SvgRenderer::tokyoNight();  // #1a1b26
SvgRenderer::nord();        // #2e3440

Build a custom theme via the Theme constructor — set background / foreground / border / shadow / line-number colour / window-control colours / font family / size / line height.

Demos

Code screenshot

screenshot

ANSI input

ansi-input

Test

cd candy-freeze && composer install && vendor/bin/phpunit

Packages

 
 
 

Contributors

Languages