Skip to main content
Prompts are the foundation of PromptRepo. Each prompt has a title, description, content, and is automatically versioned to track changes over time.

​
Creating Your First Prompt

1

Navigate to Create Page

Click the “New Prompt” button in the navigation or visit /prompts/create to open the create prompt form.
2

Enter Prompt Details

Fill in the required fields:
  • Title: A descriptive name for your prompt (required)
  • Description: A brief explanation of what the prompt does (optional)
  • Prompt Content: The actual prompt text, which supports markdown formatting
  • Version Note: A note describing this initial version (optional, defaults to “Initial version”)
The content field supports markdown, allowing you to use formatting like bold, italic, lists, and code blocks.
3

Save Your Prompt

Click the “Save Prompt” button to create your prompt. A success notification will appear once the prompt is saved.The system automatically:
  • Creates the first version (v1) of your prompt
  • Generates a unique ID for the prompt
  • Sets the creation timestamp

​
Editing Prompts

PromptRepo uses a versioning system, so editing a prompt creates a new version rather than overwriting the original.
1

Select a Prompt

From your prompt library (homepage), click on any prompt to view its details.
2

Enter Edit Mode

In the prompt detail view, hover over the prompt content area and click the Edit button that appears in the top-right corner.
3

Make Changes

Modify the prompt content in the text editor. The editor displays a notice indicating that a new version will be created.
Use keyboard shortcuts to save quickly: Cmd+Enter (Mac) or Ctrl+Enter (Windows/Linux) while in the version note field.
4

Add Version Note

Enter an optional version note describing your changes (e.g., “Added clarification for edge cases” or “Fixed typo”).
5

Save New Version

Click Save Version to create a new version. The prompt will update, and the version number increments automatically.

​
Editing Prompt Metadata

You can update the title and description without creating a new version.
1

Open Prompt Details

Select a prompt from your library to view its details.
2

Click Edit Details

Click the Edit Details button in the top-right area of the prompt header.
3

Update Information

Modify the title and/or description fields as needed.
4

Save Changes

Click Save Details to update the metadata. This action does not create a new version.

​
Sharing Prompts

Prompts can be made public to share with others via a read-only link.
1

Toggle Public Sharing

In the prompt detail view, click the Share button to make the prompt public.Once public, the button changes to Public and a Copy link button appears.
2

Copy Share Link

Click Copy link to copy the public URL to your clipboard.The link format is: https://your-app-url/p/{promptId}
3

Share with Others

Share the copied link with anyone. They can view the prompt content without needing to log in.
Public prompts are read-only. Viewers cannot edit or copy them to their own library directly.

​
Viewing Version History

Every edit creates a new version, and you can view or restore previous versions.
1

Open History Tab

In the prompt detail view, click the History tab to see all versions.
2

Review Versions

Each version displays:
  • Version number
  • Creation date and time
  • Version note (if provided)
  • A preview of the content
3

Restore a Previous Version

Click the Restore button on any previous version to make it the current version.
Restoring a version creates a new version with the restored content, preserving the complete history.

​
Archiving Prompts

Archiving removes prompts from your active library without deleting them.
  • Archived prompts are marked with an “Archived” badge
  • They can be restored at any time
  • Archived prompts don’t appear in search results by default
Use the Archived filter in your prompt library to view and manage archived prompts.

​
Best Practices

  • Use descriptive titles: Make it easy to find prompts later
  • Add version notes: Document why you made changes
  • Keep prompts focused: One prompt should serve one clear purpose
  • Test before sharing: Verify your prompt works as expected before making it public
  • Review history regularly: Check version history to understand how your prompts evolved

Build docs developers (and LLMs) love

Get started for freeTalk to us