soroush.asadi
21b6a30f08
Move a template fully between environments (local → live): container, projects, all scenes + editable fields, shared colours/layers, its categories & tags, and the asset files. - export_template.py <slug> → a self-contained bundle (template.json + assets/). One SQL query captures the whole tree as JSON; assets are resolved from template-media references and copied in. Source DB via PSQL env (default = local docker). - import_template.py <bundle> → idempotent SQL (pipe to target psql). Replaces by slug via one cascading delete (all content.* FKs are ON DELETE CASCADE), recreates rows verbatim (UUIDs preserved → FKs intact), merges categories/tags BY SLUG so they line up across DBs. --assets-to copies media; docker cp / mc cp hints for remote. - TEMPLATE_BUNDLES.md documents it. Round-trip tested on fr-instagram-promo: DB → bundle → DB restores identical 3 projects / 15 scenes / 138 fields and field values. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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
Related Repos
| 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:
supabase/migrations/001_profiles.sqlsupabase/migrations/002_render_jobs.sqlsupabase/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.