Inspiration

If you've ever done a hackathon, you know the feeling. You just finished building something cool, but now you have like 30 minutes to make a demo video. You're sitting there staring at nothing, trying to figure out what to say and how to make it sound good. I built DemoScript to solve that problem for myself and every other hacker out there.

What it does

DemoScript looks at your GitHub repo and writes a 2-minute demo script for you. You just paste your repo URL, click a button, and it gives you a full script with a hook, problem, solution, features, tech stack, and a closing. Ready to read and record.

How I built it

  • Frontend: React with Vite and Tailwind CSS
  • Backend: Express.js server that talks to GitHub and handles the AI stuff
  • AI: Google Gemini API (gemini-2.5-flash) reads through your codebase and actually understands what you built
  • Smart Analysis: It pulls your README, package.json, and source files to get the full picture

Challenges I ran into

  • Hit Gemini API quota limits and had to try different model versions until one worked
  • Getting the prompt right so the scripts sound like a real person talking, not a robot
  • Making sure the script length actually fits in 2 minutes when you read it out loud

Accomplishments I'm proud of

  • The scripts genuinely sound human
  • Works instantly with any public GitHub repo
  • The timestamps in the output make recording way easier

What I learned

  • Prompt engineering matters a lot. Small changes make a big difference
  • Gemini is surprisingly good at understanding code
  • Building dev tools is fun

What's next for DemoScript

  • Adding ElevenLabs for voice generation so you get audio too
  • Letting users customize the tone and style
  • Supporting private repos with GitHub login

Built With

Share this project:

Updates