Documentation

git clone https://github.com/JayantDeveloper/repostudio
cd repostudio
npm install
npx playwright install chromium

# Minimum viable setup (no audio, no persistent DB)
AUTH_SECRET=                  # openssl rand -base64 32
GITHUB_ID=                    # GitHub OAuth App client ID
GITHUB_SECRET=                # GitHub OAuth App client secret
GEMINI_API_KEY=               # Google AI Studio — free tier works

create extension if not exists pgcrypto;

create table if not exists public.video_jobs (
  id         uuid primary key default gen_random_uuid(),
  user_id    text not null,
  repo_url   text not null,
  status     text not null default 'ready',
  scenes     jsonb not null default '[]'::jsonb,
  video_url  text,
  created_at timestamptz not null default now(),
  updated_at timestamptz not null default now(),
  constraint video_jobs_status_check check (
    status in ('ingesting','scripting','audio','face',
               'ready','rendering','done','error')
  )
);

create index if not exists video_jobs_user_updated
  on public.video_jobs (user_id, updated_at desc);

alter table public.video_jobs enable row level security;

create policy if not exists "users manage own jobs"
  on public.video_jobs
  using  (auth.uid()::text = user_id)
  with check (auth.uid()::text = user_id);

insert into storage.buckets (id, name, public)
values ('video-exports', 'video-exports', true)
on conflict (id) do nothing;

npm run dev
# → http://localhost:3000

public/music/
  cinematic.mp3   # 🎬 Cinematic
  upbeat.mp3      # ⚡ Upbeat
  minimal.mp3     # 🌊 Minimal
  hype.mp3        # 🔥 Hype

What repos work best?

Public repos with a live deployed app and a populated README. The pipeline captures the live app with Playwright — repos without a deployment still work (it falls back to the GitHub repo page), but the visual quality is higher when there's a real product to screenshot.

Can I use this on private repos?

Not yet. The ingest stage uses the GitHub API which requires repos to be public. Private repo support via personal access token is on the roadmap.

Why does the video have no audio?

No ElevenLabs key is configured. Add ELEVENLABS_API_KEY to your .env.local to enable narration. Without it the video renders silently with subtitles generated from estimated timestamps.

The Supabase banner shows on my dashboard. What do I do?

The video_jobs table hasn't been created in your Supabase project yet. Copy the SQL from the banner in your dashboard and paste it into Supabase Dashboard → SQL Editor → Run. The banner is dismissible and the app works fine without it (in-memory fallback).

The AI script mentions things not in my repo.

This shouldn't happen — the system prompt hard-requires every claim to be traceable to an import in the source files. If you see hallucination, set GEMINI_API_KEY to ensure the most capable model runs first. The fallback models (especially if all fail and buildFallbackScenes is used) produce generic copy that isn't repo-specific.

How do I change the video duration?

The LLM sets durations automatically based on how much the repo has to say. You can override them manually in the editor (UI Editor or Raw JSON mode) after generation. The render uses whatever durations are in the scenes JSON at render time.

Playwright screenshots are blank or show errors.

Run npx playwright install chromium to ensure the Chromium binary is present. On Vercel, Playwright doesn't work inside serverless functions — you'll need to add the @sparticuz/chromium package and configure it for the serverless environment, or use an external screenshot service.

Can I deploy this myself?

Yes. Deploy to Vercel with vercel --prod. Set all environment variables in the Vercel dashboard. Note that Playwright screenshot capture requires the serverless function to have enough memory (1 GB+ recommended) and execution time (60 s+).