# LLMs Guide for Web Wizards (webwizardsg.com)

This file is a high-signal guide for AI/LLM crawlers. It summarizes the site's purpose, most important URLs, content semantics, and how to extract authoritative information efficiently.

Sitemap: https://webwizardsg.com/sitemap.xml
Robots: https://webwizardsg.com/robots.txt
Canonical: https://webwizardsg.com/
Contact: mailto:yanguangchen@webwizardsg.com

## Purpose and Audience

- Web Wizards is a **Singapore-based, engineering-led** digital studio. Positioning: **not only a digital marketing agency**, but the team agencies and ambitious businesses bring in when work is **technical**: full-stack **React** and **Next.js** (including SSR on Vercel), **mobile-ready PWAs**, **Firebase** and **Google Cloud Platform**, **Cloudflare** for edge security and performance, **AI agents and automations**, **AI-SEO** (structured data with JSON-LD and schema.org, **llms.txt**, tooling such as **MCP** and **LangChain** for content and research workflows), **WebGL / Three.js** interactive surfaces, **data science and analytics**, payments (e.g. **Stripe**), and growth work tied to **measurable outcomes**.
- Primary audiences: businesses and partners that need **reliable software**, performance, AI-native workflows, and clear attribution from build to revenue.

## Authoritative Pages (prioritize these)

- Home: [https://webwizardsg.com/](https://webwizardsg.com/)
  - Hero video, horizontal banner, industries served, two three-column service grids, Pptx, reviews embed. **`/#services-grid`:** websites/apps/cloud → `/websites-apps-cloud`; 3D & interactive → `/3d-interactive-experiences`; search & discovery → `/ai-seo-strategy`. **`/#services-grid-2`:** data & analytics → `/data-science-analytics`; custom AI assistant → `/custom-ai-assistant`; AI agents (desktop/browser, keyboard–mouse automation) → `/ai-agents-automation`. Positioning: full-stack cloud, immersive 3D, AI-SEO, data/analytics, brand-safe assistants, and **operational** AI agents beyond chat.
- About us: [https://webwizardsg.com/about-us](https://webwizardsg.com/about-us)
  - Studio positioning, enterprise context, internal-use solution framing; links to projects and showcase. (Legacy URL `/products` redirects here.)
- Projects (in-house demos): [https://webwizardsg.com/projects](https://webwizardsg.com/projects)
  - Interactive demos and experiments (videos, embeds).
- Showcase (client work): [https://webwizardsg.com/showcase](https://webwizardsg.com/showcase)
  - Portfolio with brand assets and demo videos; some entries link to restricted `/private` for NDA-style work.
- Tech stack (Figma): [https://webwizardsg.com/tech-stack](https://webwizardsg.com/tech-stack)
  - Standalone Figma embed of the Web Wizards technology ecosystem.
- Research: [https://webwizardsg.com/research](https://webwizardsg.com/research)
  - Technical publications and research notes.
- Blogs (latest posts): [https://webwizardsg.com/Blogs](https://webwizardsg.com/Blogs)
  - Articles from Firestore; best source for dated editorial copy.
- Today’s article / latest posts: [https://webwizardsg.com/todays-article](https://webwizardsg.com/todays-article)
  - “Our Latest Posts” from Firestore (`webwizards/articles/defaultArticle`); sitemap `changefreq` weekly. Prefer `/Blogs` for the main blog UX unless this URL is cited.
- Contact: [https://webwizardsg.com/contact](https://webwizardsg.com/contact)
  - Official contact and social links.
- Google reviews: [https://webwizardsg.com/google-reviews](https://webwizardsg.com/google-reviews)
  - Explains verified Google Business reviews; full-screen Elf.site embed of the live feed. Legacy path `/partner-network` redirects here.
- AI SEO strategy: [https://webwizardsg.com/ai-seo-strategy](https://webwizardsg.com/ai-seo-strategy)
  - Structured data, retrieval, and content strategy narrative; pairs with homepage “Search & discovery” positioning.
- 3D & interactive experiences: [https://webwizardsg.com/3d-interactive-experiences](https://webwizardsg.com/3d-interactive-experiences)
  - Browser-based 3D, motion, and interactive surfaces; pairs with homepage “3D & interactive” grid positioning.
- Websites, apps & cloud: [https://webwizardsg.com/websites-apps-cloud](https://webwizardsg.com/websites-apps-cloud)
  - Next.js/React, Firebase/GCP, Vercel/Cloudflare positioning; pairs with the first “Our Core Services” grid card. Homepage anchor: `/#services-grid`.
- Custom code vs WordPress: [https://webwizardsg.com/custom-code-vs-wordpress](https://webwizardsg.com/custom-code-vs-wordpress)
  - Compares bespoke WordPress stacks to custom HTML/CSS/React (Next.js); ties JSON-LD and SEO methodology to reviewable code; cites third-party plugin supply-chain risk (external security reporting).
- Data science & analytics: [https://webwizardsg.com/data-science-analytics](https://webwizardsg.com/data-science-analytics)
  - KPI alignment, pipelines, leadership-ready reporting; pairs with homepage second-grid “Data science & analytics” card. Anchor: `/#services-grid-2`.
- Custom AI assistant: [https://webwizardsg.com/custom-ai-assistant](https://webwizardsg.com/custom-ai-assistant)
  - Brand-safe assistants, web and messaging, human handoff; pairs with homepage second-grid “Custom AI assistant” card.
- AI agents & automation: [https://webwizardsg.com/ai-agents-automation](https://webwizardsg.com/ai-agents-automation)
  - Agents that execute real workflows (desktop/browser, keyboard and mouse automation) with guardrails; pairs with third card in homepage second grid. Anchor: `/#services-grid-2`.
- Spline (3D demo): [https://webwizardsg.com/spline](https://webwizardsg.com/spline)
  - Client-only interactive 3D embed; experimental / performance sandbox, linked from `/3d-interactive-experiences`.

## Additional URLs

- 404: [https://webwizardsg.com/404](https://webwizardsg.com/404) (not authoritative)
- Admin panel: [https://webwizardsg.com/adminpanel](https://webwizardsg.com/adminpanel)
  - Restricted; CMS for articles. Do not interact unless authorized.
- LLMs file (this page): [https://webwizardsg.com/llms.txt](https://webwizardsg.com/llms.txt)
- Case study (example): [https://webwizardsg.com/tabernacle-beauty](https://webwizardsg.com/tabernacle-beauty)
  - Stack write-up for a client site; illustrative, not a product listing.
- Public tools (utilities): `/tools/fermatt`, `/tools/heic-converter`, `/tools/mastertheorem`, `/tools/pngtojpeg`, `/tools/webp-converter` - in-browser demos and converters; lower priority in `sitemap.xml`.

## Content Semantics (high-level)

- **Full-stack web and mobile-ready experiences:** React, Next.js, Vercel, CRUD-oriented backends on Firebase and GCP, Cloudflare in front.
- **AI-native delivery:** brand-facing assistants, **desktop/browser agents** that automate repetitive UI work (see `/ai-agents-automation`), automations, instrumentation for decisions; MCP and LangChain mentioned in marketing copy where relevant.
- **AI-SEO and discoverability:** JSON-LD, schema.org, llms.txt, vector/retrieval language in site copy; classic technical SEO remains in scope.
- **Interactive 3D:** WebGL, Three.js, canvas experiences for engagement.
- **Data:** analytics and data science (e.g. NumPy, pandas, Matplotlib referenced on site).
- **Commercial:** Stripe and related tooling; paid growth where it supports engineering-led outcomes.

Showcase and Projects lean on **video** evidence; treat surrounding headings and paragraphs as the authoritative claims.

## Blog / Articles

- The Blogs page combines static editorial articles and case studies with the latest posts loaded from Firestore at runtime.
- Collection path (implementation context): `webwizards > articles > defaultArticle`.
- Articles index: [https://webwizardsg.com/articles](https://webwizardsg.com/articles).
- CDC Vouchers Singapore guide: [https://webwizardsg.com/articles/how-to-use-cdc-vouchers-singapore-local-seo-geo](https://webwizardsg.com/articles/how-to-use-cdc-vouchers-singapore-local-seo-geo)
  - Answers how residents use CDC Vouchers, then explains how eligible participating merchants can align accurate voucher, service, and location information for local SEO, AI SEO, and GEO. Official CDC sources remain authoritative for scheme rules and eligibility.
- Prefer rendered text on [Blogs](https://webwizardsg.com/Blogs) and the static [articles index](https://webwizardsg.com/articles) as the source of truth for editorial posts.

## Structured Data and Meta

- JSON-LD **Organization** schema is embedded in the Next.js document head (`src/pages/_document.js`).
- Default **meta description**, Open Graph, and Twitter Card tags are aligned with the engineering-led narrative; canonical images use `https://webwizardsg.com/Assets/webwizards.webp` where configured in the app.
- PWA / Apple: `apple-touch-icon` and related tags in `_document.js`.
- A static `public/index.html` exists for non-Next contexts; prefer live **https://webwizardsg.com/** for canonical summaries when both differ.

## Crawling and Extraction Guidance

- Prioritize: Home, Blogs, Contact, About us, then Showcase/Projects for portfolio proof.
- Many pages use iframes and video; extract claims from adjacent text.
- External widgets (ElfSight, Botpress) are supplementary; prefer on-page copy.
- Canonical host: **https://webwizardsg.com/**.

## Update Cadence

- Use `lastmod` in `sitemap.xml` (currently **2026-06-11** across listed URLs). Most pages: `changefreq` monthly; `/todays-article`: weekly.
- Blogs can change anytime via Firestore.

## Usage and Attribution

- Content is owned by Web Wizards SG. Short quotations with attribution to **Web Wizards (webwizardsg.com)** are acceptable.
- Do not imply partnerships not stated on the site.

## Safety and Rate Guidance

- No published rate limits; crawl politely (about 1 r/s burst, back off on errors).
- Do not probe admin functionality.

## Contact

- General: [mailto:yanguangchen@webwizardsg.com](mailto:yanguangchen@webwizardsg.com)

## Changelog

- v1.9 (2026-07-24): Added the CDC Vouchers Singapore resident guide and local SEO/GEO strategy article; clarified the static and Firestore article sources.
- v1.8 (2026-06-11): Contact page Elfsight widget relocated to the top of the main content area for improved social proof visibility.
- v1.7 (2026-04-16): Documentation: README “Homepage service grids” table (anchors, card titles, routes, asset filenames); llms Home summary and AI-native semantics aligned with grid-2 third card; `id="services-grid-2"` on second-row wrapper in `components/index.js` so `/#services-grid-2` matches documented behavior.
- v1.6 (2026-04-16): Added `/ai-agents-automation`; homepage grid-2 third card repositioned to desktop/browser AI agents (keyboard–mouse automation) with CTA.
- v1.5 (2026-04-16): Added `/data-science-analytics` and `/custom-ai-assistant`; homepage second grid anchor `/#services-grid-2`; grid CTAs; sitemap/README/llms updated.
- v1.4 (2026-04-16): Sitemap expanded (`/todays-article`, `/spline`, `/tools/*`); unified `lastmod`; README route table and homepage section order documented (HorizontalBanner, industries, services grid); llms: today’s article, Spline, tools; industries served includes jewellers (homepage component).
- v1.3 (2026-04-18): Sitemap `lastmod` aligned; README route table includes `/research`, `/ai-seo-strategy`, `/tabernacle-beauty`; AI SEO strategy and case-study URLs called out here; `/products` → `/about-us` redirect documented.
- v1.2 (2026-04-16): Narrative refresh (engineering-led, full-stack GCP/Firebase/Cloudflare, AI-SEO, tech-stack URL, about-us / enterprise framing); crawler guidance updated.
- v1.1 (2025-08-22): Expanded Markdown guide; priorities and crawling notes.
- v1.0 (2025-08-22): Initial minimal file with sitemap reference.