Skip to main content

​
Quickstart

This guide walks you through creating your first prompt, using variables, and testing dynamic resolution. You’ll be up and running in under 5 minutes.
This quickstart assumes you’re using the hosted version of PromptRepo. If you want to run it locally, see the Installation guide first.

​
Step 1: Create an Account

1

Navigate to the login page

Visit the PromptRepo login page and click Sign Up.
2

Choose your authentication method

You can sign up using:
  • Email/Password — Enter your email and create a password
  • GitHub OAuth — Click the GitHub button to authenticate
  • Google OAuth — Click the Google button to authenticate
If using email/password, you’ll receive a confirmation email. Check your inbox and click the confirmation link to activate your account.
3

Confirm your email (email/password only)

Open the confirmation email and click the link to verify your account. You’ll be redirected to the PromptRepo dashboard.

​
Step 2: Create Your First Prompt

1

Navigate to the Create Prompt page

From the dashboard, click the Create Prompt button or navigate to /prompts/create.
2

Fill in the prompt details

The create prompt form has four fields:
  • Title (required) — A short, descriptive name (e.g., “Code Review Assistant”)
  • Description (optional) — Additional context about the prompt’s purpose
  • Content (required) — The actual prompt text (supports variables with {{variable}} syntax)
  • Version Note (optional) — A note describing this initial version
Use descriptive titles that make prompts easy to find in search. Examples: “Python Docstring Generator”, “API Endpoint Design Template”, “Bug Triage Checklist”.
3

Save your prompt

Click Create Prompt. Your prompt is saved with version number 1. You’ll be redirected to the prompt detail page.

​
Example: Simple Prompt (No Variables)

Let’s create a basic code review assistant: 
**Title:** Code Review Assistant
**Description:** General-purpose code review checklist
**Content:**
You are an expert code reviewer. Review the following code for:

1. Correctness and logic errors
2. Performance issues
3. Security vulnerabilities
4. Code style and best practices
5. Test coverage

Provide specific, actionable feedback with line references.

​
Step 3: Use Variables for Reusable Templates

PromptRepo’s real power comes from dynamic variable resolution. Use {{variable}} syntax to create reusable templates.
1

Create a prompt with variables

Click Create Prompt again and add variables using double curly braces:
2

Define variable placeholders

PromptRepo automatically detects variables in your content. Common patterns:
  • {{language}} — Programming language
  • {{framework}} — Framework or library
  • {{task}} — Specific task or goal
  • {{context}} — Additional context
Variables can contain spaces and special characters: {{target audience}}, {{code_style}}, {{API-version}} are all valid.
3

Save and test resolution

After saving, you’ll see the prompt detail page with a Variable Resolution section. Enter values for each variable to see the resolved output in real-time.

​
Example: Prompt with Variables

Let’s create a language-agnostic docstring generator: 
**Title:** Docstring Generator
**Description:** Generate documentation for functions in any language
**Content:**
You are a documentation expert for {{language}}.

Generate a {{language}}-style docstring for the following function following {{framework}} conventions:

- Include parameter types and descriptions
- Document return values
- Add usage examples if appropriate
- Follow {{language}} formatting standards (e.g., JSDoc, Python docstrings, Javadoc)

Function to document:
{{code}}
Variable Resolution Example:
VariableValue
languagePython
frameworkGoogle Style Guide
codedef calculate_discount(price, percentage): ...
Resolved Output: 
You are a documentation expert for Python.

Generate a Python-style docstring for the following function following Google Style Guide conventions:

- Include parameter types and descriptions
- Document return values
- Add usage examples if appropriate
- Follow Python formatting standards (e.g., JSDoc, Python docstrings, Javadoc)

Function to document:
def calculate_discount(price, percentage): ...

​
Step 4: Search Your Prompts

PromptRepo includes full-text search powered by PostgreSQL’s tsvector for sub-100ms query times.
1

Open the search modal

Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) anywhere in the app.
2

Type your search query

Search matches against:
  • Prompt titles
  • Descriptions
  • Content (including variable names)
Search queries are tokenized and ranked by relevance. Try searching for concepts like “code review”, “documentation”, or specific variable names like "".
3

Navigate with keyboard

Use arrow keys to navigate results and Enter to open a prompt. Press Escape to close the search modal.

​
Step 5: Version Control and History

Every edit creates a new version. Let’s test this:
1

Edit an existing prompt

Open a prompt from your dashboard and click Edit or Save New Version.
2

Make changes and add a version note

Update the content and add a descriptive version note (e.g., “Added error handling section”).
3

View version history

Click the History tab on the prompt detail page. You’ll see all versions with:
  • Version numbers
  • Creation timestamps
  • Version notes
  • Content diffs
PromptRepo uses a two-table versioning pattern. The prompts table holds HEAD metadata, while prompt_versions stores immutable history. You can always restore previous versions.
4

Restore a previous version (optional)

Click Restore on any previous version to create a new version with that content. This doesn’t delete history — it creates a new version with the old content.

​
Step 6: Share Your Prompt

Generate a public sharing link for read-only access:
1

Enable public access

On the prompt detail page, toggle Public Access to ON.
2

Copy the sharing link

The app generates a URL like https://your-app.com/p/abc123. Copy this link.
3

Share with others

Anyone with this link can view the prompt (read-only). They don’t need a PromptRepo account.
Public links are read-only but globally accessible. Don’t enable public access for prompts containing sensitive information.

​
Next Steps

Congratulations! You’ve created your first prompt with variables, tested resolution, searched your library, and explored version control.

​
Explore Advanced Features

MCP Integration

Connect PromptRepo to Claude Desktop or other AI agents

Collections

Organize prompts into project-based collections

Snapshots

Create point-in-time captures of prompt states

API Reference

Explore server actions and database queries

​
Learn Best Practices

  • Naming conventions — Use descriptive, searchable titles
  • Variable design — Keep variable names short and semantic
  • Version notes — Document what changed and why
  • Collections — Group related prompts by project or workflow
Join our community to share prompts, templates, and best practices with other PromptRepo users.

Build docs developers (and LLMs) love

Get started for freeTalk to us