Replit Agent (flagship Agent 3, 2026) is an autonomous AI software engineer inside Replit: you describe an app in plain language and it plans, writes code across many files, provisions a database, wires auth, tests itself in a real browser, and deploys to a live URL. The prompts that get great results are not one-liners — they are compact PRDs (product requirements documents).
Every template below is a reusable skeleton. Copy it, replace each [BRACKETED] placeholder with your specifics, and paste. For anything non-trivial, toggle Plan Mode first so the Agent proposes a plan you approve before it touches files, then iterate one feature per prompt and test between steps. New here? Start with the 40 best Replit Agent prompts, learn the method in how to prompt Replit Agent for full-stack apps, or keep the cheat sheet and the web-app prompt collection handy.
Build & Plan Templates
Start every new app from the master PRD template. It names the seven parts of a good build prompt — what, who, flows, data model, stack, design, and scope guardrails — so the Agent has everything it needs and nothing to wander off into.
1. Master PRD build template
Build [one-line app description].
Who it's for: [target user] who needs to [job-to-be-done].
Core user flows:
- [flow 1, e.g. sign up -> create a project]
- [flow 2, e.g. invite a teammate]
- [flow 3, e.g. see a dashboard]
Data model:
- [Entity 1] ([field, field, field])
- [Entity 2] ([field, field, field])
Stack & integrations: [you choose the stack OR name it]. Use Replit Auth for login and Postgres for data. [Add any integration, e.g. Stripe via Secrets].
Design: [clean/modern], brand color [#hex], mobile-responsive[, dark mode].
Scope for THIS pass: build [must-haves]. Out of scope for now: [don't build X yet].
Run this in Plan Mode first, propose a plan, and wait for my approval before changing any files.How to fill it: Keep each part to a line or two; the "Out of scope" line is what keeps a first autonomous run tight and cheap.
2. Plan-Mode template
Plan Mode only — do not write or change any code yet.
I want to [goal, e.g. add multi-tenant workspaces to my app]. Before building, produce a Task Plan with: What and Why, "Done looks like", Out of scope, and numbered build steps. Ask me any clarifying questions about [ambiguous area, e.g. how billing maps to workspaces] first. Wait for my approval on the plan before you start building.How to fill it: Use this for anything risky or multi-file; approve the plan, then say "Start Building" so a checkpoint is created before changes land.
3. Add-a-feature template
Add ONE feature to the existing app: [feature name].
What it does: [plain-language description].
User flow: [where the user starts -> what they do -> what they see].
Data changes: [new fields/entities, or "none"].
UI: [where it lives in the app, e.g. a new tab in the sidebar].
Done looks like: [observable result, e.g. "a user can archive a task and it disappears from the active list"]. Don't touch [unrelated area]. When finished, test this flow yourself in the browser and confirm it works.How to fill it: One feature per prompt — the "don't touch" line protects the rest of your app from collateral edits.
4. Data-model template
Set up the data model in Postgres for [app].
Entities and key fields:
- [Entity] ([field: type], [field: type], created_at)
- [Entity] ([field: type], [field: type], created_at)
Relationships: [e.g. a Project has many Tasks; a Task belongs to one User].
Add sensible indexes for [common query, e.g. "listing tasks by project and status"]. Seed [N] rows of realistic sample data so I can see the UI populated. Don't build any UI in this pass — schema, migrations, and seed data only.How to fill it: Name relationships explicitly; scoping to "schema only" lets you review the model before screens are built on top of it.
Data, Auth & Integrations
These templates lean on Replit's native primitives: Replit Auth for login without config, Secrets for API keys, and Integrations (Stripe, Twilio, Slack, SendGrid, and more). Name the primitive and what "done" looks like.
5. Auth template (Replit Auth)
Add authentication using Replit Auth.
Requirements: users can [sign up / log in / log out]; protect these pages/routes: [list]; on first login create a matching user record in the database with [fields, e.g. email, name, created_at]. Redirect logged-out users hitting a protected route to the login page.
Done looks like: I can log in, only I see my own [data], and logging out blocks access. Test the full login -> protected page -> logout flow yourself in the browser.How to fill it: List every protected route; Replit Auth wires login without config, so focus your blanks on what data each user should own.
6. Integration template (Secrets)
Integrate [service, e.g. SendGrid / Twilio / OpenAI / Slack] into the app.
Use case: [what it does, e.g. "send a welcome email when a user signs up"]. Store the API key in Secrets as [SECRET_NAME] — do not hardcode it. Handle failures gracefully (retry or log, don't crash the request).
Done looks like: [observable result, e.g. "a test email arrives at my address"]. Tell me exactly which Secret(s) to add and where to get the key, then test the integration end to end.How to fill it: Always say keys go in Secrets and spell out the "done" test; that's how you verify the wiring actually works.
7. Stripe / payments template
Add Stripe payments to the app.
What to sell: [one-time purchase OR subscription] for [product/plan] at [price]. Flow: user clicks [Buy / Upgrade] -> Stripe Checkout -> on success, mark [what changes, e.g. "the user's account as Pro"]. Handle the webhook for [checkout.session.completed] to update the database reliably.
Keys go in Secrets (STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET). Use Stripe test mode. Done looks like: I complete a test-mode checkout and my account flips to [Pro]. Test the full flow yourself, including the webhook.How to fill it: Name one-time vs subscription and the exact post-payment change; "test with Stripe test mode" keeps the first pass safe.
8. Role-based-access template
Add role-based access control on top of Replit Auth.
Roles: [Admin], [Member], [Viewer]. Permissions:
- [Admin] can [do X, Y, Z]
- [Member] can [do X, Y]
- [Viewer] can [read only]
Store the role on the user record; default new users to [role]. Hide UI actions a role can't use AND enforce the rules on the server so they can't be bypassed. Done looks like: a [Viewer] account cannot [restricted action] via UI or direct request. Test each role yourself.How to fill it: The "enforce on the server too" line matters — UI hiding alone is not real access control.
9. Import-CSV template
Add a CSV import feature for [entity, e.g. contacts].
Flow: user uploads a .csv -> the app previews the parsed rows and maps columns to [target fields] -> user confirms -> rows are inserted. Expected columns: [col1, col2, col3]. Validate each row (required fields, email format, etc.), skip or flag bad rows instead of failing the whole import, and show a summary: [N imported, N skipped, with reasons].
Done looks like: I upload a sample file and see the right records created with a clear import report. Test it with a messy sample file that has a few bad rows.How to fill it: Name the expected columns and demand a skip-and-report behavior so one bad row never kills the whole upload.
Features & UI Templates
Templates for the screens and surfaces users actually touch — dashboards, API endpoints, landing pages, and responsive layouts. Be concrete about the components and behavior you want.
10. Dashboard template
Build a dashboard for [user/purpose].
Metrics to show: [metric 1], [metric 2], [metric 3] — each with its current value and [trend / comparison to prior period]. Include [charts you want, e.g. a line chart of X over time] and a filterable table of [records] with filters for [dimension 1, dimension 2].
Pull all numbers from the real data in the database — do not invent figures. Keep it mobile-responsive. Done looks like: the dashboard loads with real data and the filters update the charts and table. Test the filters yourself.How to fill it: List exact metrics and filters; "use real data, don't invent figures" stops the Agent from stubbing fake numbers.
11. API endpoint template
Add a REST API endpoint: [METHOD] [/path, e.g. GET /api/tasks].
Purpose: [what it returns or does]. Input: [query params / body fields with types]. Output: [JSON shape, e.g. {"tasks": [{id, title, status}]}]. Auth: [require a logged-in user / API key in Secrets / public]. Validate input and return proper status codes (400 for bad input, 401 unauthorized, 404 not found).
Done looks like: calling it with [example request] returns [example response]. Add one example request I can copy, and test the endpoint yourself.How to fill it: Specify the JSON shape and auth requirement; a concrete example request makes "done" unambiguous.
12. Landing-page template
Build a one-page marketing landing page for [product].
Sections in order: hero (headline + subhead + CTA button), 3-feature row, [social proof / logos], a short FAQ ([5] questions), and a footer with an email signup form. Style: [clean/modern], brand color [#hex], [sans-serif], mobile-responsive. Copy: [paste it OR say "write persuasive copy from this description: ..."].
Make the primary CTA prominent above the fold and use a placeholder for [LOGO] and the [FORM ENDPOINT]. Done looks like: a polished, responsive page I can preview. Test it at phone and desktop widths.How to fill it: Name every section and the CTA behavior; leave [LOGO]/[FORM ENDPOINT] as placeholders you plug in after.
13. Make-it-mobile-responsive template
Make the app fully mobile-responsive without changing any functionality or data.
Focus on: [pages/components that break, e.g. the dashboard tables and the nav]. On small screens: [expected behavior, e.g. "the sidebar collapses into a hamburger menu; tables scroll horizontally or become stacked cards"]. Keep tap targets large enough and text readable without zoom.
Only touch layout/styling — don't change logic. Open the running app at a phone width, find what overflows or overlaps, fix it, and re-check yourself.How to fill it: Point at the specific screens that break and scope it to "layout only" so business logic stays untouched.
14. Design-fix template
Fix the design of [page/component]. Here's what's wrong: [specific issues, e.g. "spacing is inconsistent, the buttons look default, contrast is poor"]. [Attach a screenshot and use Canvas to mark the exact spots.]
Target look: [clean/modern], brand color [#hex], consistent spacing and typography, clear button hierarchy. Don't change any functionality or copy — visual polish only. Show me the before/after by testing the page yourself in the browser.How to fill it: Attach a screenshot and use Canvas annotations to point at the exact spots; keep it "visual only" so nothing breaks.
Debug, Refactor & Tests
Fix and hardening templates. For each, give the exact error or expected-vs-actual, ask the Agent to find root cause before editing, keep the change scoped, and add a test so it doesn't regress.
15. Debug-with-error template
There's a bug. Find the root cause before changing anything.
What happens: [actual behavior]. What should happen: [expected behavior]. Steps to reproduce: [1, 2, 3]. Error message:
[paste the FULL error / stack trace here]
Likely file(s): [if known].
Explain the root cause first, then make the smallest fix that resolves it. Don't refactor unrelated code. After fixing, reproduce the steps yourself to confirm it's gone, and add a quick test so it can't regress.How to fill it: Paste the full error text and expected-vs-actual; "smallest fix + root cause first" is what avoids a debugging loop.
16. Refactor template
Refactor [file / module, e.g. the checkout logic] to [goal, e.g. "split it into smaller functions and remove duplication"].
Hard rule: behavior must stay exactly the same — this is a pure refactor, no feature changes. Keep the public interface [/routes/props] identical. Do it in [small steps / one file at a time] so it's easy to review.
Run this in Plan Mode first and show me the plan. After refactoring, run the app and confirm the affected flows still work. If anything behaves differently, stop and tell me.How to fill it: Emphasize "behavior unchanged" and run it in Plan Mode; refactors are exactly where scoped, reviewed changes pay off.
17. Add-tests template
Add automated tests for [feature/module, e.g. the task API and the auth flow].
Cover: [key cases — happy path, invalid input, unauthorized access, edge case]. Use [the project's existing test setup, or pick a standard framework and set it up]. Don't change the app's behavior — only add tests; if a test reveals a real bug, tell me instead of silently fixing it.
Done looks like: I can run the tests with one command and they pass. Run them yourself and paste the results.How to fill it: List the cases you care about; the "tell me if a test finds a bug" line keeps test-writing from turning into a surprise refactor.
Deploy, Jobs & Recovery
Templates for shipping and safety: name the deployment type, schedule recurring work, and know how to roll back when a change goes sideways.
18. Deploy template
Deploy the app.
Deployment type: [Autoscale for a web app / Reserved VM for an always-on service / Static for a static site / Scheduled for a cron job]. Make sure all required Secrets are set for production ([list them]). Run any needed database migrations against the production database. Confirm the build succeeds.
Done looks like: a live public URL that loads the app and passes a quick smoke test of [key flow]. Tell me the URL and walk me through the smoke test yourself.How to fill it: Always name the deployment type — Autoscale for web apps, Static for static sites, Scheduled for cron — so the Agent picks the right target.
19. Scheduled-job (cron) template
Create a scheduled job that runs [cadence, e.g. every day at 8am UTC].
Each run should: [task, e.g. "fetch new rows from [source], summarize them, and email me a digest"]. Use Secrets for any API keys ([SECRET_NAME]). Log each run's outcome (success/failure + counts) so I can see history. Make it idempotent — if it runs twice, don't duplicate work.
Deploy this as a Scheduled Deployment (cron). Done looks like: a test run produces [expected output] and the schedule is registered. Trigger one run now to prove it works.How to fill it: State the cadence and demand idempotency; ship it as a Scheduled Deployment, not an Autoscale web service.
20. Rollback / recover template
The last change broke [what's broken] — it was working before. Stop making new changes.
First, help me roll back to the last good checkpoint before this feature (in History, "Rollback here"). After we're back to the working state, in Plan Mode only, propose a smaller, safer plan to achieve [original goal] that avoids [what went wrong]. Wait for my approval before building anything.How to fill it: When a fix makes things worse or the Agent loops, roll back to a known-good checkpoint and re-attempt with a tighter, Plan-Mode-approved scope.
Frequently Asked Questions
What is Replit Agent (Agent 3)?
Replit Agent is an autonomous AI software engineer inside Replit that runs in the browser and on mobile. Agent 3 is the flagship 2026 version. You describe an app in plain language and it plans, writes code across many files, provisions a database, wires up authentication, tests itself in a real browser, and deploys to a live public URL — no local setup or DevOps. It supports 50+ languages and frameworks.
How is a Replit Agent prompt different from a ChatGPT prompt?
A Replit Agent prompt is a compact PRD (product requirements document), not a chat message. Because the Agent builds a real, running app autonomously, you tell it what to build, who it's for, the core user flows, the data model, the stack and integrations, the design, and — most importantly — scope guardrails including what's out of scope for this pass. That structure is what keeps an autonomous run from wandering.
How do I use these templates?
Copy a template, replace every [BRACKETED] placeholder with your specifics, and paste it into the Replit Agent prompt composer. For anything non-trivial, toggle Plan Mode first so the Agent proposes a plan you can approve before it changes any files. Then iterate one feature at a time with the follow-up templates rather than requesting everything at once.
What is Plan Mode vs Build Mode?
Plan Mode makes the Agent think first: it proposes an approach, asks clarifying questions, and produces a Task Plan (What and Why, "Done looks like", Out of scope, numbered steps) then WAITS for your approval before touching files. Build Mode ("Start Building") is when it edits code and creates checkpoints automatically after significant changes. Use Plan Mode for anything non-trivial.
What are checkpoints and can I roll back?
The Agent creates a checkpoint automatically after each prompt or significant change. Open History and choose "Rollback here" to restore a known-good state. If a fix makes things worse or the Agent gets stuck in a debugging loop, roll back to the last good checkpoint and try a tighter, more scoped prompt rather than piling on more changes.
How much does Replit Agent cost?
Billing is effort-based: a simple change can be under about $0.25, while a complex build or large refactor costs more. Tight, scoped prompts are cheaper and avoid runaway debugging loops, which is another reason to iterate one feature at a time and to run risky work in Plan Mode first.
Do I need to know how to code to use these templates?
No. The templates are written in plain language so a non-coder can fill in the blanks and ship a working app. Knowing a little about data models and user flows helps you write a sharper PRD, but the Agent handles the actual code, database, auth, and deployment for you.
When should I use Agent vs Assistant?
Use Replit Agent to build features and make changes across many files. Use Replit Assistant for small, targeted edits and quick questions. If your template describes a multi-file change or a new capability, that's Agent work; a one-line copy tweak is Assistant work.