soroush.asadi d7743a6fbe feat: live render preview — node agent pushes PNG frames, frontend displays them in real time
render-svc:
- db.UpdateJobPreview(): writes base64 PNG to render_jobs.image_preview_b64
  (only on active jobs; Done/Failed/Cancelled rows ignored)
- POST /v1/internal/render/jobs/:job_id/preview — node agent endpoint
- Route registered under /v1/internal (nodeAuth)

node-agent:
- runner.PreviewFn callback type alongside ProgressFn
- runner.preview.go: GeneratePreviewB64(percent, quality, resolution)
  — pure stdlib (image/png + encoding/base64), no external deps
  — 320×180 dark frame with animated progress bar + colored indicator dots
- mock render: pushes a preview frame at every step (5→95%)
- real AE render: pushes a preview frame every 30s
- client.UpdatePreview(): POST /v1/internal/render/jobs/:job_id/preview
- main.go: onPreview callback wires client.UpdatePreview() into runner.Run()

frontend:
- render-jobs.ts: RenderJobRow.preview_b64 field; read from progress endpoint
- status/route.ts: previewB64 included in JSON response
- RenderModal: aspect-ratio preview pane during polling — shows spinner until
  first frame arrives, then live-updates with each poll (every 3s);
  step label overlaid as badge bottom-right

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-01 09:42:03 +03:30

FlatRender

AI-powered video and image creation platform. Create professional videos and images with templates, a drag-and-drop studio, and one-click export.

Products

  • Video Maker — timeline editor, Konva canvas, scene browser, transitions, audio, nexrender export
  • Image Editor — Konva canvas, filters, crop, background removal, layer system
  • Video Trimmer — ffmpeg.wasm in-browser trim + crop + export
  • Templates — browsable marketplace with category sidebar

Quick Start

npm install
cp .env.example .env.local   # fill in your credentials
npm run dev                  # http://localhost:3000
Repo Path Purpose
flatrender D:\Projects\flatrender This repo — Next.js app
flatrender-admin D:\Projects\flatrender-admin\admin-api .NET 10 Admin API
flatrender-admin D:\Projects\flatrender-admin\admin-ui React Admin SPA

Stack

  • Next.js 15 App Router · TypeScript · Tailwind CSS · shadcn/ui
  • Supabase — auth, database, storage
  • Stripe — subscription payments
  • React-Konva — canvas editor (video + image)
  • next-intl — Persian (default) + English i18n
  • ffmpeg.wasm — browser-side video trimming
  • nexrender — server-side After Effects rendering

Environment Variables

See .env.example for the full list. Minimum required to run:

NEXT_PUBLIC_SUPABASE_URL=
NEXT_PUBLIC_SUPABASE_ANON_KEY=

Without Supabase the app runs in mock mode (studio uses localStorage).

Database Migrations

Run in order in Supabase SQL Editor:

  1. supabase/migrations/001_profiles.sql
  2. supabase/migrations/002_render_jobs.sql
  3. supabase/migrations/003_projects.sql

Admin Panel

The admin panel at D:\Projects\flatrender-admin manages templates, categories, and media. When ADMIN_API_URL=http://localhost:5000 is set, the Next.js app fetches live data from it. Without it, hardcoded fallback data is used.

See CLAUDE.md for full development guide.

S
Description
No description provided
Readme 221 MiB
Languages
TypeScript 59.8%
C# 19%
Go 16.3%
JavaScript 1.6%
Python 1.4%
Other 1.8%