Vidzee
Listing Photos to Cinematic Videos
Built With
About this app
Open-source Next.js app for real estate and marketing teams: upload listing photos, AI-assisted storyboarding, cinematic clip generation, multi-format export (vertical + horizontal), credit-based pricing, and polished marketing pages. Production reference at vidzee.ai; clone the repo to connect your own Supabase, fal.ai video keys, and Vercel project.
Self-hosting: accounts & environment
Vidzee is a Next.js App Router project. Configure Supabase, fal.ai (video), and Vercel; optional Stripe for credits. Exact env names live in the repo README and `.env` templates—align with those before production.
Accounts to create
- GitHub — clone mattantimatter/vidzee.
- Supabase — new project; apply SQL under `supabase/` and wire Auth URLs to your Vercel domain.
- fal.ai — account and API key for server-side image-to-video (`FAL_KEY` or `FAL_API_KEY` per README).
- Vercel — host the Next.js app; add all env vars in Project → Settings → Environment Variables.
- Stripe — if you enable credit purchases, follow repo billing docs (test mode first).
Environment variables
Names below follow the open-source repo; your fork may use VITE_ or NEXT_PUBLIC_ prefixes. Confirm in .env.example / ENVIRONMENT_SETUP.md in GitHub.
| Variable | What it's for | Where to get the value |
|---|---|---|
| FAL_KEY | Primary fal.ai API key for server-side clip generation (see README). | fal.ai dashboard → API keys. If you only set `FAL_API_KEY`, use that name instead per repo. |
| FAL_API_KEY | Alternate env name accepted by some server routes if `FAL_KEY` is unset. | Same fal.ai dashboard API key; mirror README naming in your `.env`. |
| VIDEO_MOTION_INTENSITY | Optional motion preset (e.g. minimal / subtle / standard). | Set in Vercel env per README; defaults apply if omitted. |
| VIDEO_CLIP_RESOLUTION | Optional export resolution (e.g. 720p vs 480p). | Set in Vercel env per README. |
| NEXT_PUBLIC_SUPABASE_URL | Supabase project URL for browser and server helpers. | Supabase → Settings → API → Project URL. |
| NEXT_PUBLIC_SUPABASE_ANON_KEY | Public anon key for client-side Supabase. | Supabase → Settings → API → anon public key. |
| SUPABASE_SERVICE_ROLE_KEY | Service role for server routes and admin tasks (never expose to the client bundle). | Supabase → Settings → API → service_role secret. |
Vercel & deploy
- Run `npm install` then `npm run dev` for local development (port 3000 by default).
- Connect the GitHub repo to Vercel; framework: Next.js; enable Node runtime for server routes that call fal.ai.
- Add Preview + Production env vars separately; redeploy after each change.
- In Supabase Auth, add site URL and redirect URLs for `https://your-domain.vercel.app` and production.
- Turn on observability (Vercel logs / Supabase logs) while testing video jobs—generation can be slow and rate-limited.
The README in mattantimatter/vidzee documents FAL / video variables and project layout; check `middleware.ts`, `app/`, and `supabase/` for any additional secrets (e.g. webhooks or provider keys) required by your fork.
Special Features
- Marketing site, auth, and dashboard patterns tuned for a video SaaS
- AI storyboarding from uploaded listing photos
- Server-side clip generation via fal.ai / Grok Imagine-style video pipeline
- Multi-format export (e.g. 9:16 and 16:9) for social and MLS
- Credit packs and Stripe-ready billing flows (per repo)
- Supabase migrations and RLS-friendly structure in `supabase/`
Included Sections
- Landing & pricing
- Upload & storyboard
- Video generation & export
- Account & credits
- Admin / ops hooks (per repo)
Tags
License
The vidzee repository ships with its own LICENSE; read it on GitHub before redistributing the template or using it commercially.
Antimatter AI
antimatterai.com ↗