Getting Started
From prompt → preview → production, with repeatable verification steps.
What you will achieve
- A working preview (dev) URL
- One successful change via Chat
- A safe path to production (with rollback)
- A checklist for GitHub / Payments / Analytics
5-minute Quickstart
- Create a project from your prompt.
- Open the preview (dev) URL.
- Ask Chat for one small change:
Change the homepage hero title to “Hello from my first build”. Keep the rest unchanged.
Acceptance: the preview updates and the page still loads on mobile.Prompt recipe
Include these in your prompt:
- Audience / role
- 2–4 core flows
- Data entities
- Constraints (mobile-first, dark mode, SEO, etc.)
- Integrations (GitHub / payments / analytics)
- Acceptance criteria
Brand assets (logo/images/favicon)
Most users get stuck on assets because there is no single “upload logo” button. Use one of these workflows:
A) Paste SVG (recommended)
Replace the header logo.
Create `public/brand/logo.svg` using the SVG below and update the header to use it.
Constraints: responsive, accessible label (aria-label), no layout shift.
<svg ...>...</svg>B) Use an image URL (图床/CDN)
Use this as the header logo: https://.../logo.png
Constraints: 28px height desktop, 24px mobile, keep aspect ratio.
Acceptance: looks correct in dark mode.C) Use GitHub for asset files (teams)
- Commit
public/brand/logo.svg(or PNG) and reference it from UI. - This makes reviews and rollbacks straightforward.
Favicons typically live under public/ (favicon.svg, favicon.ico, etc.). Ask Chat to replace them and update <link rel="icon" ...> if needed.
Preview → Production
Verify in preview (dev) before promotion:
- auth flow works (if enabled)
- checkout is reachable (if enabled)
- core pages load without errors
Promote (typical): merge dev → main.
Rollback: revert the last change and redeploy. If it’s a secrets issue, fix secrets first, then redeploy.
Integrations checklist
- GitHub connected and repo access verified:
/settings?tab=github - Auth callback URLs set for preview + production
- Payments: test keys in preview; live keys in production; webhook secret configured
- Analytics: realtime/pageview verified; 3–5 core events added