> ## Documentation Index
> Fetch the complete documentation index at: https://beta-docs.replo.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Prompting Replo
> How to ask Replo for what you want and get great results.
export const TryPromptButton = ({prompt, imageSrc, imageAlt = "Template preview", imageStyles = {}, buttonCta = "Build in Replo"}) => {
const [isLoading, setIsLoading] = useState(false);
const [error, setError] = useState(null);
const API_BASE = "https://api.replo.app";
const APP_URL = "https://dashboard.replo.app";
const LoaderIcon = ;
const ChevronIcon = ;
async function postJSON(url, body, headers = {}, timeoutMs = 120000) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
try {
const response = await fetch(url, {
method: "POST",
headers: {
"Content-Type": "application/json",
...headers
},
body: JSON.stringify(body ?? ({})),
signal: controller.signal
});
const responseText = await response.text();
if (!response.ok) throw new Error(`API Error: ${response.status}`);
return responseText ? JSON.parse(responseText) : {};
} finally {
clearTimeout(timeoutId);
}
}
async function handleTryPrompt(event) {
event.preventDefault();
event.stopPropagation();
setIsLoading(true);
setError(null);
try {
const body = {
prompt,
file: null
};
const {seed} = await postJSON(`${API_BASE}/api/v1/marketing/issue-marketing-site-jwt`, body);
if (!seed) throw new Error("No seed returned from API");
const url = new URL(APP_URL);
url.searchParams.set("type", "agent");
url.hash = `seed=${encodeURIComponent(seed)}`;
window.open(url.toString(), "_blank");
setIsLoading(false);
} catch (caughtError) {
console.error("Failed to generate prompt:", caughtError);
const message = caughtError instanceof Error ? caughtError.message : null;
setError(message ?? "Something went wrong. Please try again.");
setIsLoading(false);
}
}
return
{}
{imageSrc && }
{}
{}
{}
{error &&
{error}
}
;
};
Replo does what you ask, so the way you ask shapes what you get. This page covers the habits that produce the best results.
## Be specific
Tell Replo what you want, not just the goal. Name the sections, the layout, the colors, and the behavior. A vague prompt leaves Replo to guess, and a precise one gets you close on the first try.
Name the sections, layout, colors, and behavior you want.Paste URLs, images, or brand colors. Concrete references sharply improve output.Ask for one change per prompt for the most predictable results.Start rough, then refine with follow-ups until it is right.
## Compare a weak prompt to a strong one
A weak prompt describes the goal and stops there:
```text theme={null}
Make me a store for candles.
```
A strong prompt describes the goal, the structure, and the style:
```text theme={null}
Build a site for hand-poured soy candles. Create a homepage with a hero, a 3-product grid, a reviews section, and a newsletter signup. Feature three scents with prices. Use a warm, minimal style with cream and charcoal tones.
```
The second prompt gives Replo enough to build something you can react to, instead of something you have to start over.
## Refine with follow-ups
After the first pass, change one thing at a time. Small, focused prompts are easier for Replo to get right and easier for you to review.
```text theme={null}
Make the hero darker and move the newsletter signup above the reviews.
```
## Use references
If you have a look in mind, show it. Paste a link to a site you like, drop in an image, or give Replo your brand colors. References anchor the result far better than adjectives.
## What to expect
Replo handles open-ended, multi-step requests, and it will tell you when it needs something from you, such as a connected integration or a missing detail. For larger requests it writes a [plan](/plans) first, so you can see its intended steps and redirect it before it commits to them. When a result is not what you wanted, say what is wrong and ask again. The fastest path to a great result is a short loop of clear prompts and quick corrections.
## Related
Attachments, mentions, and past conversations.See what Replo intends to do before it does it.