Client Website Preview
Build and deploy client preview websites from business data.
Prerequisites
Required: GitHub MCP connected
Recommended: Vercel MCP connected (for deployment verification)
Check prerequisites before proceeding:
- •Test GitHub MCP with any github operation
- •If GitHub unavailable → STOP, notify user
- •Check Vercel MCP availability, note for later
Input Requirements
Minimum required:
- •Business name
- •Phone number
- •Address/service area
Optional:
- •Services offered
- •Hours of operation
- •Taglines/USPs
- •Testimonials
- •Brand colors
Workflow
1. Generate Branch Name
Convert business name to kebab-case:
- •"Green Hawaii Landscaping" →
green-hawaii - •"Bob's Tree Service" →
bobs-tree-service - •Remove special characters, suffixes (LLC, Inc), lowercase
2. Generate Images
Primary: Use nanobanana image generation
- •Hero: Professional service scene matching business type/location
- •Gallery: 4-6 realistic project photos
Fallback: Unsplash URLs (see references/fallback-images.md)
3. Build Website
Stack: Vite + React + Tailwind CSS v4
Design System: See references/design-system.md for:
- •Color tokens (forest/gold palette)
- •Typography (Playfair Display + Source Sans)
- •Component patterns
- •Section blueprints
Required Sections:
- •Top bar (phone, hours, location)
- •Navigation header
- •Hero (headline, CTAs, rating)
- •Trust bar
- •Services grid (6 cards)
- •About/Why Choose Us + stats
- •Gallery
- •Testimonials (3 cards)
- •Service area + map
- •Contact section + form
- •Emergency banner
- •Footer
- •Mobile sticky CTA
4. Push to GitHub
Repository: hmseeb/client-previews
code
github:create_branch → [branch-name] from main github:create_or_update_file → package.json github:create_or_update_file → vite.config.js github:create_or_update_file → index.html github:create_or_update_file → src/main.jsx github:create_or_update_file → src/index.css github:create_or_update_file → src/App.jsx
5. Verify Deployment
If Vercel MCP available:
- •Wait 30-60 seconds
- •
Vercel:list_deploymentsfor project - •Check status → if error, get build logs and debug
- •Fix and re-push if needed
If Vercel MCP unavailable:
- •Provide expected URL
- •Ask user to verify manually
6. Deliver
URL Pattern:
code
https://client-previews-git-[branch]-badaaas.vercel.app
Response format:
code
done! here's your preview: **[Business Name]** 🔗 [preview URL] built with: - [key features] - [image source: AI-generated or unsplash]
Error Handling
| Error | Action |
|---|---|
| GitHub MCP missing | STOP, notify user |
| Branch exists | Ask: overwrite or new name? |
| Image gen fails | Use unsplash fallback |
| Push fails | Retry once, then notify |
| Vercel build fails | Fetch logs, fix, re-push |
| Vercel MCP missing | Continue, manual verify |