gitwtfhub

wtf is promptlab?

taruma/promptlab — explained in plain English

Analysis updated 2026-05-18

5TypeScriptAudience · vibe coderComplexity · 2/5LicenseSetup · easy

TL;DR

A browser-based playground for drafting and testing AI prompt templates against Google Gemini before using them in a real project.

Mindmap

mindmap
  root((PromptLab))
    What it does
      Draft AI prompts
      Test against Gemini
      Compare presets
    Tech stack
      Next.js
      TypeScript
      IndexedDB
    Use cases
      Prompt iteration
      Image-based prompts
      Preset sharing
    Audience
      Vibe coders
      Prompt engineers
    Setup
      Node.js 18+
      Gemini API key
      npm run dev

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Draft and iterate on an AI prompt template with fill-in-the-blank variables before deploying it.

REASON 2

Test a prompt against reference images to see how Gemini responds to visual context.

REASON 3

Save, compare, and share different versions of a prompt setup as presets.

What's in the stack?

Next.jsTypeScriptTailwind CSSIndexedDBGoogle GenAI SDK

How it stacks up

taruma/promptlabagentigris/agentfundalange/tinyclaude
Stars555
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardmoderate
Complexity2/55/53/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 30min

Needs a Google Gemini API key, either in a .env.local file or entered directly in the app.

Use, copy, modify, and share this freely, including for commercial purposes, as long as you keep the original copyright notice.

Wtf does this do

PromptLab is a sketchpad for writing and testing AI prompts before you take them anywhere serious. Instead of a finished production tool, it is a place to draft your instructions to an AI, try them out against Google's Gemini models, and refine them until the wording feels right. You write a prompt template with placeholders like a name or a scene description, and PromptLab automatically turns each placeholder into a form field you can fill in without touching code. You can drag and drop reference images into the app to use alongside your prompt, and each one gets labeled and mapped so the AI knows which image goes with which part of your instructions. Images are compressed and stored in your browser rather than sent to any server, avoiding the storage limits that browsers normally place on saved data. You can save your own prompt setups as presets, export them as files, or share one with someone else through a link. A built-in comparison view shows what changed between your current setup and a saved preset, similar to how a code diff highlights additions and removals. The app includes a control panel where you pick which Gemini model to use, adjust settings like temperature and how much reasoning effort the model applies, and manage your own API keys. Every generation you run gets saved to a local history you can browse, mark as a favorite, or export later. There is also a sidebar library for uploading and reusing images across different prompt sessions, and three example presets covering things like screenplay writing and cinematic storyboarding to show what the tool can do. To run PromptLab yourself you need Node.js 18 or later and a Google Gemini API key, which you can either place in a local environment file or type directly into the app. The project's author states plainly that it was built through AI-assisted coding and should be used at your own risk. It is released under the MIT license.

Yoink these prompts

Prompt 1
Help me set up PromptLab locally and connect it to my Gemini API key.
Prompt 2
Show me how to add dynamic template variables to a PromptLab prompt.
Prompt 3
Explain how PromptLab's preset diff viewer compares two prompt configurations.
Prompt 4
Walk me through sharing a PromptLab preset with someone else via a URL.

Frequently asked questions

wtf is promptlab?

A browser-based playground for drafting and testing AI prompt templates against Google Gemini before using them in a real project.

What language is promptlab written in?

Mainly TypeScript. The stack also includes Next.js, TypeScript, Tailwind CSS.

What license does promptlab use?

Use, copy, modify, and share this freely, including for commercial purposes, as long as you keep the original copyright notice.

How hard is promptlab to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is promptlab for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.