Guide · Windsurf
Windsurf app not indexed on Google? The 22-point fix checklist
Most apps built with Windsurf look perfect in the browser and invisible to search engines. Crawlers and link previews read the first HTML response, and AI-built apps often send an almost empty page, default titles and no sitemap. Here is everything to check, in order of impact.
Windsurf-specific fixes
- There is no hosting fingerprint for Windsurf, so the fixes depend on your framework. If you use React with Vite, add pre-rendering; if you use Next.js, export metadata and add sitemap.ts and robots.ts.
- Keep every secret key on the server and rotate any key that was ever shipped to the browser.
The checklist
1. Served over HTTPS high impact
Browsers flag plain http as "Not secure" and Google prefers HTTPS pages.
2. Home page answers 200 high impact
A home page that errors or redirects in a loop cannot be indexed at all.
3. Page title (10-70 characters) high impact
The title is the blue link in Google. Default titles like "Vite + React" waste it.
4. Meta description high impact
Without it Google writes its own snippet, usually from random UI text.
5. An H1 in the server HTML high impact
Crawlers read the first HTML response. An H1 rendered only by JavaScript is often missed.
6. Real content before JavaScript runs high impact
Most AI-built apps are single-page apps that send an empty <div id="root">. Pre-rendering fixes indexing and link previews.
7. No noindex / robots block high impact
Preview builds often ship with noindex, and it sometimes leaks into production.
8. No secret keys in public code high impact
OpenAI, Stripe or Supabase service_role keys in the bundle can be copied by anyone and drained.
9. sitemap.xml medium impact
A sitemap tells search engines which pages exist. SPA fallbacks often return HTML instead.
10. robots.txt medium impact
A real robots.txt (not the app HTML) points crawlers to the sitemap.
11. Canonical URL medium impact
Stops www/non-www and query-string duplicates from splitting rankings.
12. Open Graph title and description medium impact
Controls how links look on X, LinkedIn, Slack, Discord and iMessage.
13. Social preview image medium impact
Posts with an image get far more clicks than bare links.
14. Mobile viewport medium impact
Without it phones render the desktop layout zoomed out.
15. Analytics installed medium impact
You cannot tell whether a launch worked without visitor numbers.
16. Favicon low impact
Shown in tabs, bookmarks and Google mobile results.
17. Language attribute low impact
Helps search engines and screen readers.
18. X / Twitter card low impact
Gives X the large-image preview.
19. Structured data (JSON-LD) low impact
SoftwareApplication schema gives search and AI answers clean facts about your app.
20. Image alt text low impact
Accessibility and image search.
21. Fast first response low impact
Slow HTML hurts crawl budget and conversions.
22. llms.txt for AI search low impact
A short Markdown summary that AI search engines can cite.
Check all 22 automatically
Paste your Windsurf app URL. You get a score and a fix prompt for each failure, ready to paste into Windsurf.
Other guides: Lovable · Bolt · Replit · v0 · Cursor · Claude Code · Base44