soroush.asadi 43d0e10543 fix(render+studio): dev mock worker (unstick the queue) + lock predefined layers
Render — "stuck in Queued" fix:
- Jobs were created Queued and only a Windows AE node could claim them, so in the
  dev stack (no node) they queued forever.
- New devworker package: in-process mock worker drives Queued jobs through the steps
  with progress + live preview frames → Done. Enabled via RENDER_DEV_WORKER (default
  true in compose; set false in prod where real nodes claim jobs).
- db: DevClaimNextQueued (atomic oldest-queued → Preparing) + UpdateJobStepProgress
- Verified live: a stuck job advanced Preparing→Done in ~10s with frontend polling.

Studio — predefined template structure:
- Projects are always copied from a template; structure is fixed. Users customise
  existing layers, they don't add new ones.
- New studio-config flag ALLOW_ADD_LAYERS (false): StudioToolbar (add text/image/
  video/shape) returns null; SceneEditSidebar "add text layer" button hidden.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-05 22:10:05 +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%