Skip to content

Repository files navigation

FocusFlow Logo

Turn complex architecture diagrams into 60fps cinematic interactive stories.

English โ€ข ็ฎ€ไฝ“ไธญๆ–‡

License TypeScript Turborepo Vite Tailwind CSS GitHub Pages


Try Live Demo Online



FocusFlow Hero Walkthrough Demo




๐Ÿ’ก Why FocusFlow?

When presenting distributed systems, microservices, or complex AI pipelines, static architecture diagrams have fundamental flaws:

  • Cognitive Overload: A static 4K diagram with 100+ microservices and crisscrossing lines overwhelms the audience within 30 seconds.
  • Slides vs. Videos Dilemma: Slide decks fragment the architectural topology into disjointed screenshots; screen recordings cannot be paused to inspect or zoom into specific service configs.
  • Prohibitive Animation Costs: Crafting smooth motion graphics requires days of manual keyframing in After Effects.

FocusFlow bridges this gap. It lets you direct your architecture diagram like a movie camera:

  • Smoothly pans, zooms, and rotates across nodes at 60fps GPU acceleration.
  • Lights up dynamic cubic Bezier curves between dependencies.
  • Generates AI voiceover with synchronized waveforms.
  • Compiles into a 100% offline single-file HTML that runs in any browser with zero network or runtime dependencies.

๐Ÿ“Š Comparison Matrix

Capability FocusFlow Traditional Slides (PPT / Keynote) Static Diagramming (Draw.io / Excalidraw) Screen Recording (Loom / OBS)
Cinematic Camera Pathing Native 60fps Kinematics Discrete manual transitions โŒ None Fixed perspective video
Interactive Node Exploration Full (Pan / Zoom while playing) โŒ Static slides Manual canvas pan โŒ Flat pixels
Zero-Friction Alignment Sobel Edge Smart Snapping Manual snapping Manual alignment โŒ None
Dynamic Flow Curves Real-time Bezier glow routing โŒ None Static arrows Pre-rendered pixels
Distribution Format Self-contained Single-file HTML Proprietary .pptx / .key Image / XML export Heavy .mp4 / .webm video
Offline Execution 100% Offline (Zero backend) Depends on app Requires web app Local video player

โœจ Key Features

๐ŸŽฅ 1. 60fps GPU Cinematic Kinematics & Dynamic Bezier Flow

Continuous affine transforms (scale, translate3d, rotate) driven by viewport kinematics. Seamlessly transition from global overview to microscopic component details without aliasing or frame drops, with glowing Bezier paths illuminating runtime interactions.

60fps Cinematic Kinematics and Dynamic Bezier Flow

๐Ÿงฒ 2. Sobel Edge Smart Snapping

Equipped with a native computer-vision algorithm: drag a bounding box near any node or diagram card, and FocusFlow automatically snaps bounding boxes to the exact pixel borders in $< 1\text{ms}$.

Sobel Edge Smart Snapping Studio Canvas

โšก 3. Dynamic Bezier Flow Routing

Intelligent relative anchor calculation (right โž” left, bottom โž” top) connecting nodes with animated glowing pulses, customizable pulse colors, and directional indicators.

๐ŸŽ™๏ธ 4. AI Voiceover & Audio-Motion Sync

Built-in offline Web Speech API synthesizer and cloud LLM voiceover connector. Features visual audio waveform tracks, subtitle markers, and auto-computed camera dwell times.

AI Voiceover and Audio Waveform Synchronization

๐Ÿ๏ธ 5. Dynamic Island & Zen Mode

A sleek floating HUD pill at the bottom provides chapter progress, time remaining, playback controls, and element density counters. Supports auto-hiding Zen Mode for clean presentation recording.

๐Ÿ“ฆ 6. Single-File Offline Compiler

Compile your entire projectโ€”background 4K image, overlays, audio narration, motion scripts, and player engineโ€”into a single self-contained .html file ($< 5\text{MB}$) that opens anywhere with double-click.


๐Ÿš€ Quick Start

1. Try Online Live Demo

No installation needed. Open directly in your browser:
๐Ÿ‘‰ https://focusflow.tumio.site/

2. Local Development (Turborepo)

# Clone the repository
git clone https://github.com/tumio-ltd/focusflow.git
cd focusflow

# Install dependencies (requires pnpm 9+)
pnpm install

# Start local workbench (FocusFlow Studio)
pnpm dev:studio
# ๐Ÿ‘‰ Open http://localhost:5174 in your browser

# Build all packages
pnpm build

๐Ÿ—๏ธ Monorepo Architecture

focusflow/
โ”œโ”€โ”€ apps/
โ”‚   โ””โ”€โ”€ studio/               # Visual Web Workbench (React 19, Tailwind CSS v4, Lucide)
โ”œโ”€โ”€ packages/
โ”‚   โ”œโ”€โ”€ player/               # High-performance 60fps runtime engine (~35KB, Zero UI deps)
โ”‚   โ”œโ”€โ”€ dsl/                  # Shared TypeScript DSL specifications & JSON schema
โ”‚   โ”œโ”€โ”€ config-typescript/    # Shared TypeScript compiler options
โ”‚   โ”œโ”€โ”€ config-oxlint/        # High-speed Oxlint quality rules
โ”‚   โ””โ”€โ”€ config-tailwind/      # Semantic dark/light design tokens
โ”œโ”€โ”€ examples/
โ”‚   โ”œโ”€โ”€ luxehms/              # 4K Microservices Architecture Showcase
โ”‚   โ”œโ”€โ”€ sales-fee/            # 5K Panoramic Sales Network & Commission Topology
โ”‚   โ”œโ”€โ”€ overlay-demo/         # Picture-in-picture dynamic drilldown showcase
โ”‚   โ””โ”€โ”€ simple-demo/          # Minimal 2-node smoke test
โ”œโ”€โ”€ docs/                     # Technical whitepapers & algorithm specifications
โ””โ”€โ”€ scripts/                  # Standalone compiler & project generator

๐Ÿ“ฆ Packages

Package Version License Description
@focusflow/player v1.0.0 MIT Lightweight (~35KB) 60fps canvas presentation runtime engine
@focusflow/dsl v1.0.0 MIT FocusFlow typed DSL schema, geometry types & validator
@focusflow/studio v1.0.0 AGPL-3.0 Interactive visual timeline authoring workbench

๐Ÿ“– Documentation & Technical Whitepapers

Detailed architectural and algorithmic specifications are available in the docs/ directory:


๐Ÿค Contributing

Contributions, issues, and feature requests are welcome!
Feel free to check the Issues page.


๐Ÿ“„ License

FocusFlow is licensed under a dual-licensing model:

Copyright ยฉ 2026 Tumio Soft Technology Co., Ltd.

About

๐ŸŽฌ Turn complex architecture diagrams into 60fps cinematic interactive stories. Interactive camera paths, AI voiceovers, and standalone single-file HTML or MP4 export.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages