Interactive Vector Flipbook Studio • Human & Agent Documentation Guide
Flip by Forgeboro is a browser-based, high-performance vector flipbook creator designed for animators, educators, and doodlers. It provides an intuitive canvas with full support for multi-frame playback, onion skinning, layered drawing stacks, and lossless cryptographic backups.
Scrub through animation frames, adjust playback speeds between 1 FPS and 24 FPS, insert or duplicate slides, and preview loops instantly.
View semi-transparent ghost outlines of preceding keyframes with chromatic guide tints to trace arcs, spacing, and follow-through accurately.
Every drawing element is stored as resolution-independent SVG markup, scaling from smartphones to multi-monitor setups without pixelation.
Export tamper-proof signed JSON archives with HMAC-SHA256 checksums and automated multi-part chunking for massive sketchbooks.
Flip provides precision CAD-like vector editing combined with natural freehand drawing dynamics:
| Tool Name | Shortcut | DOM Selector | Description & Behavioral Details |
|---|---|---|---|
| Pencil Tool | P or N | [data-tool="pencil"] |
Freehand drawing converted automatically into smoothed cubic Bézier splines upon releasing the pointer. |
| Select Tool | V | [data-tool="select"] |
Point-click or drag-marquee selection. Relocate elements by dragging, or resize/rotate using bounding-box handles. |
| Group Select Tool | G | [data-tool="group"] |
Selects entire hierarchical groups at once. Double-click to drill down into subgroups. |
| Spline Node Tool | A | [data-tool="node"] |
Direct manipulation of anchor vertices and tangent handles on cubic Bézier curves. Click segment to add anchor; press Delete to remove. |
| Smart Paint Bucket | B | [data-tool="bucket"] |
One-click recoloring of vector shapes and scanline boundary flood-filling of enclosed hand-drawn line art. |
| Line Tool | L | [data-tool="line"] |
Draw straight vector lines. Hold Shift to constrain angle to 45° increments. |
| Rectangle Tool | R | [data-tool="rect"] |
Draw rectangles and boxes. Hold Shift to lock 1:1 square aspect ratio. |
| Ellipse Tool | O | [data-tool="ellipse"] |
Draw ellipses and circles. Hold Shift to lock circular aspect ratio. |
Complex scenes are organized cleanly across independent layers and reusable static backgrounds:
Define reusable background templates (grid, widescreen storyboard, forest, cosmos) in the project library. Assign plates to individual slides or multiple slide ranges (e.g., 1-3, 8, or all). Editing a background plate automatically updates all referencing frames.
Industry-standard hotkeys for high-speed animator ergonomics:
| Action | Key Combination | Scope / Mode |
|---|---|---|
| Duplicate Selected | Ctrl + D | Selection active |
| Group Strokes | Ctrl + G | Multiple elements selected |
| Ungroup Elements | Ctrl + Shift + G | Group selected |
| Copy / Paste | Ctrl + C / Ctrl + V | Canvas selection |
| Undo / Redo | Ctrl + Z / Ctrl + Y | Global history stack |
| Delete Selected | Delete or Backspace | Active selection |
| Play / Pause Animation | Space | Global |
| Step Backward / Forward | , (comma) / . (period) | Global timeline |
| Proportional Scale Constraint | Shift + Drag Corner Handle | Bounding Box Scale |
| 15° Angle Snap Rotation | Shift + Drag Rotation Knob | Bounding Box Rotate |
| Corner / Cusp Node Mode | Shift + Drag Tangent Handle | Spline Node Editing |
| Open Help Guide | ? or F1 | Global |
Autonomous coding agents, testing harnesses, and browser automation drivers can inspect and control Flip deterministically via standardized DOM selectors and the live window.__FLIP_AGENT_SPEC__ runtime object:
| Application Target | Declarative Selector | Supported Events / Operations |
|---|---|---|
| Drawing Canvas Surface | [data-testid="drawing-canvas"] |
pointerdown, pointermove, pointerup |
| Tool Selectors | [data-tool="select|group|pencil|node|bucket|line|rect|ellipse"] |
click to activate tool |
| Action Buttons | [data-action="undo|redo|duplicate|group|ungroup|copy|paste|delete"] |
click to trigger action |
| Playback Loop Controls | [data-action="play-pause|step-forward|step-backward"] |
click to toggle animation loop |
| Layer Stacks | [data-layer-id="<id>"] |
click to select, lock or toggle visibility |
| Background Selector | [data-testid="background-select"] |
change event to assign background plate |
Agents can access and execute commands directly in browser devtools or test scripts:
// Inspect runtime controller
const flipAgent = window.__FLIP_AGENT_SPEC__;
console.log(flipAgent.appName, flipAgent.version);
// Query interactive tool element
const pencilBtn = flipAgent.getTool('pencil');
pencilBtn?.click();
// Query executable action element
const duplicateBtn = flipAgent.getAction('duplicate');
duplicateBtn?.click();
The entire application schema is published in JSON Schema standard:
fetch('/agent-spec.json').then(r => r.json()).then(spec => console.log(spec));