🎞️ Flip by Forgeboro

Interactive Vector Flipbook Studio • Human & Agent Documentation Guide

1. Studio Overview & Animation Workflow

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.

🎬 Frame Timeline & Playback

Scrub through animation frames, adjust playback speeds between 1 FPS and 24 FPS, insert or duplicate slides, and preview loops instantly.

🧅 Real-Time Onion Skinning

View semi-transparent ghost outlines of preceding keyframes with chromatic guide tints to trace arcs, spacing, and follow-through accurately.

📐 Infinite Vector Resolution

Every drawing element is stored as resolution-independent SVG markup, scaling from smartphones to multi-monitor setups without pixelation.

🔐 Cryptographic State Transfer

Export tamper-proof signed JSON archives with HMAC-SHA256 checksums and automated multi-part chunking for massive sketchbooks.

2. Vector Creation & Editing Tools

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.

3. Multi-Background Plates & Multi-Layer Frame Stack

Complex scenes are organized cleanly across independent layers and reusable static backgrounds:

Reusable Background Plates

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.

Layer Hierarchy & Management

4. Keyboard Shortcuts & Modifiers Cheat Sheet

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

5. AI Agent & Automation Protocol

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

Runtime JavaScript Controller

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();
      

Machine-Readable Spec Endpoint

The entire application schema is published in JSON Schema standard:

fetch('/agent-spec.json').then(r => r.json()).then(spec => console.log(spec));