Skip to content

Examples 2.0#215

Merged
tadaspetra merged 44 commits intomainfrom
examples-2
Mar 5, 2026
Merged

Examples 2.0#215
tadaspetra merged 44 commits intomainfrom
examples-2

Conversation

@tadaspetra
Copy link
Collaborator

@tadaspetra tadaspetra commented Feb 27, 2026

After a ton of back and forth, this flow gives results most consistently.

CleanShot 2026-03-02 at 16 12 51@2x

Outcome

By running pnpm run generate:examples, updated skills are pulled down, all example prompts are located and examples are regenerated based on those prompts.

For consistent results there is a template folder containing a minimal project for the appropriate technology (ex. Nextjs is default template + ElevenLabs UI components + heading + subheading + "demo goes here".

The setup.sh script copies the template to an example/ folder, and builds dependencies.

To fully regenerate an example, delete the example/ folder and run the command. Can generate single example using pnpm run generate:examples speech-to-text/nextjs/realtime

Key Decisions

  • root level folders. This makes it so right when you land in the repo, you can see the type of examples we have, instead of having to click into the examples folder.
  • folder structure being feature/language/example-name
  • previous examples still in repository, but the goal is to convert all those into maintainable examples based on this, and eventually delete that folder

What else was tried

One-shotting from prompt alone

This worked, but the results varied a lot, and ran into timeouts and other issues related to just getting the project set up. (Also found a few bugs in the skills)

No Design File

The final solution has a DESIGN.md in the root. Without this the results are again varied. But DESIGN.md + the template gives relatively consistent outcomes.

Long term maintenance

  1. Run the script to regenerate examples when APIs change
  2. Update templates when major releases for frameworks happen (this can also be automated, but it shouldn't be very hard to do so we can do it if it becomes a headache)

@vercel
Copy link
Contributor

vercel bot commented Feb 27, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
convai-nextjs-post-call-webhook Error Error Mar 5, 2026 2:50am
screenshot-to-sfx Ready Ready Preview, Comment Mar 5, 2026 2:50am
talktosanta-redirect Ready Ready Preview, Comment Mar 5, 2026 2:50am
video-to-sfx Ready Ready Preview, Comment Mar 5, 2026 2:50am
x-to-voice Ready Ready Preview, Comment Mar 5, 2026 2:50am

Request Review

Copy link
Collaborator

@PaulAsjes PaulAsjes left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A little bit of polish, and I think we're there. I'd rename from "minimal" to "quickstart" to match what we have in the docs.

@tadaspetra
Copy link
Collaborator Author

@PaulAsjes I like the quickstart name :) Feels so obvious in hindsight

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants