Warchief.dev War Suite Directory Field Guide / Launcher Hall
Abstracts

Roadmap file / preserved structure

Warcut Studio · Engine Building Roadmap

Warcut Studio is a video editor mockup: import (browser-supported), assemble a timeline, and preview (HTML/CSS overlays). via (same-origin) with (multi-clip + trims + GFX overlays + A1 mix). Remaining work is mostly UX + scale: export range, progress/cancel, longer renders, transitions, and motion parity.

Back to roadmapsAbstract hall
Done In progress / partly live Planned / not started
One row = one build slice Viewport-safe: no page overflow

Phase map

Build sequence

Original roadmap content, family shell styling.

Phase 0 Warchief Shell + Media Intake
Branded frame, bins, and reliable file import (local URLs + metadata).
Done v0A
›
  • 0.A — App Frame + Viewport RulesUI
    Viewport-confined layout (no page overflow) with scrollable panels and consistent chrome.
    Done · promo UI frame
  • 0.B — Import MP4 + Audio + ImagesI/O
    Import video/audio/images → object URLs; probe duration/dimensions; bin list with select/remove/add-to-timeline.
    Done · import + probe + bin
  • 0.C — Codec Support ReportQA
    Codec support panel with canPlayType hints and “preview OK” probing for imported clips.
    Done · canPlayType + probe modal
  • 0.D — Modal System (Help/Codec/Export)UX
    Reusable modal framework powering Help, Codec Report, and Export dialogs.
    Done · promo dialogs
Phase 1 Timeline Model + Editing Basics
Clips on tracks, snapping, trim, split, and selection.
Done v0A
›
  • 1.A — Tracks + Clip BlocksCore
    V1/GFX/A1 tracks with draggable clip blocks, selection, playhead + ruler, snap/ripple toggles.
    Done · tracks + blocks (v1)
  • 1.B — Trim + Ripple (v1)Edit
    Drag clip edges to trim; optional ripple shifts downstream clips (v1 behavior).
    Done · trim handles + ripple toggle (pointer-safe)
  • 1.C — Split + Delete + Undo StackUX
    Split at playhead; delete selected clips; undo/redo stack (+ common keyboard shortcuts).
    Done · split/delete + undo/redo + hotkeys
  • 1.D — Timeline Zoom + Ruler SyncUI
    Zoom (px/s) slider and ruler that stays aligned with lane scroll and playhead.
    Done · ruler fix update
  • 1.E — Keyboard Shortcuts (v1)UX
    Space = play/pause, arrows = step, Ctrl/Cmd+Z/Y = undo/redo (where supported).
    Done · basic shortcuts
Phase 2 Preview Playback + Sync
Scrub, play/pause, accurate time mapping across clip boundaries.
In Progress v0A
›
  • 2.A — Clip Switching (Playlist)Preview
    Preview switches active clip based on playhead; seeks/scrubs; supports browser-decoded MP4/H.264.
    Done · timeline-driven preview
  • 2.B — WebAudio Playback (v1)Audio
    Audio master routing (Clip audio vs WebAudio A1), master mute control, and basic WebAudio playback for audio tracks.
    Done · WebAudio A1 scheduling + drift guard
  • 2.C — Proxy Mode (Optional)Perf
    Optional transcode to lightweight preview (requires ffmpeg.wasm or server).
    Planned
  • 2.D — Audio Controls (Master + Per-Clip)Audio
    Master mute button plus per-clip mute toggle and “audio master” routing.
    Done · preview audio controls
Phase 3 Lower Thirds + Graphics
Preset lower thirds, keyframes-lite, and safe-area guides.
Done v0B
›
  • 3.A — Lower Third Track + Overlay RendererGFX
    Lower Third track renders HTML/CSS overlays with editable text; per-item timing on timeline.
    Done · HTML/CSS overlay lane
  • 3.B — Safe Areas + Position ControlsUX
    Safe-area guides toggle and position/scale controls from Inspector.
    Done · safe guides + position
  • 3.C — Motion Presets (Fade/Slide)Anim
    Simple motion presets for lower thirds (fade / slide) with preview toggle.
    Done · fade/slide presets (v1)
  • 3.D — Overlay Core Schema v1 (Phase A)GFX
    Unified overlay schema + deterministic ordering (z-index normalization), plus enable/solo visibility rules for preview.
    Done · Phase A stages 1–3
  • 3.E — Deterministic .warcut Serialization + Reload Helpers (Phase A)Data
    Byte-stable project export (sorted arrays + stable keys) and in-session reload to verify overlays survive save/load.
    Done · Phase A stage 4
  • 3.F — Raster Preview Parity Toggle (Phase B / Stage 1)QA
    Optional preview mode that renders overlays via renderOverlayFrame() onto a canvas layer so preview pixels match export exactly (HTML overlay stays for editing).
    Done · raster preview parity toggle (preview pixels match export)
Phase 4 Export Pipeline
Real encoding and muxing (hardest piece in-browser).
In Progress v0B
›
  • 4.0 — Project JSON ExportOutput
    Export timeline + overlay data as a .warcut JSON project for later render/encode pipelines.
    Done · “Download Project JSON”
  • 4.A — Frame Export (PNG)Output
    Frame export + overlay rasterization harness (Phase B). Includes single-frame PNG at playhead + sample probe strip, plus a unified renderOverlayFrame() API (1080p baseline), deterministic ordering, caching, and schedule-aware PNG frame generation.
    Done · frame export + probe strip + raster preview + taint guard + schedule
  • 4.F — Overlay PNG Sequence Export (Phase B / Stage 5)Output
    User-facing export that generates a transparent overlay PNG sequence inside a .zip (manifest + frames) using the Phase B rasterizer (schedule-aware frame reuse where possible).
    Done · overlay PNG sequence ZIP (manifest + frames; reuse when static)
  • 4.G — FFmpeg Ingest Adapter (Overlay Frames → Burn-In)WASM
    Schedule-aware FFmpeg ingest adapter: renders a sparse set of overlay PNG “segments”, builds a concat-demuxer list, and feeds that stream into filter_complex (fallback to looped static overlays if unsupported).
    Done · FFmpeg concat-ingest for sparse overlay segments + fallback looped overlays
  • 4.D — WebM Export (Experimental, ffmpeg.wasm)WASM
    WebM export is currently deprioritized. Current builds focus on MP4/H.264 via ffmpeg.wasm for widest compatibility; WebM can be revisited later if needed.
    Paused · MP4-only export is primary; revisit WebM after stability work
  • 4.B — MP4 Export (H.264, ffmpeg.wasm)WASM
    Timeline MP4/H.264 export is live via ffmpeg.wasm (same-origin): multi-clip V1 compositing, background GFX, foreground overlays (Phase B ingest), and A1 audio mix. Preset targets wide compatibility: libx264, yuv420p, +faststart; 30fps default; auto-downscale to max width 1280 for sanity.
    Done · timeline MP4 export (multi-clip + overlays + A1 mix)
  • 4.E — Same-Origin FFmpeg Bundle + Chunked WASM LoaderInfra
    Host worker/core/wasm under your own domain (no cross-origin Worker issues) and load the large WASM blob in chunks to stay under strict single-file host limits (e.g., 25MB).
    Done · /ffmpeg assets + chunk loader verified
  • 4.C — “Realistic Mode” (Server Render)Pro
    Optional server-side render service for Premiere-like export reliability.
    Planned