Plans
RankFlow AI SEO-Optimized Directory Profile — Master Build Plan
Project: RankFlow AI Homepage (Route: /)
docs/homepage-build-plan.mdOn this page
- 1. Hero-First Architecture (50% of Build Effort)
- Layout: Asymmetric Editorial Split (Design Variance: 8)
- Typography (Anti-Generic Override)
- Infographic: Hero Isometric Cityscape Visual
- 2. Section-by-Section Infographic & Layout Plan
- Section 1A: Answer-First Definition (GEO-Optimized Block)
- Section 2: Problem Statement
- Section 3: The RankFlow Loop — ONBOARD → BUILD → PUBLISH → REFRESH → RESULTS
- Section 4: Citation Deep Dive
- Section 5: Directory Profile
- Section 6: GBP + Social Deep Dive
- Section 7: AI Engine Optimization
- Section 8: ROI
- Section 9: Industries
- Section 10: Integrations
- Section 11: Security & Compliance
- Section 12: Social Proof
- Section 13: Final CTA
- Section 14: Footer
- 3. Complete SEO & Schema Plan
- 3.1 Page Metadata
- 3.2 JSON-LD Schema (Structured Data)
- 3.3 H1-H6 Heading Hierarchy
- 3.4 EEAT Implementation Checklist
- 3.5 GEO / AI Search Optimization
- 4. Design Token Mapping
- Color Palette (Single-Accent System)
- Typography Scale
- Easing & Motion
- Spacing & Layout
- 5. Animation & Motion Plan
- Global Entrance Pattern (Per Section)
- Section-Specific Animations
- Magnetic & Physics Effects (Where MOTION_INTENSITY > 5)
- Hardware Acceleration Rules
- 6. Responsive Architecture
- Breakpoint Strategy
- Section-by-Section Responsive Behavior
- Mobile-Specific Guardrails
- 7. Asset Production Checklist
- Image Assets (To Generate)
- Animation Assets (To Produce)
- 8. Component Inventory
- shadcn/ui Components (To Install)
- Custom Components (To Build)
- 9. Performance & Accessibility Checklist
- Performance
- Accessibility (WCAG 2.1 AA)
- Core Web Vitals Targets
- 10. Build Execution Order
- Phase 1: Foundation (Day 1–2)
- Phase 2: Hero + Definition (Day 3–4)
- Phase 3: Core Loop (Day 5–7)
- Phase 4: Deep Dives (Day 8–10)
- Phase 5: Supporting Sections (Day 11–12)
- Phase 6: SEO & Polish (Day 13–14)
- Phase 7: Launch (Day 15)
- 11. Risk & Quality Checklist
- Content Risks
- Design Risks
- Technical Risks
- SEO Risks
- 12. Post-Launch Monitoring
- SEO Monitoring (Weekly)
- Content Freshness (Quarterly)
- Summary
Project: RankFlow AI Homepage (Route: /)
Version: 1.0.0 — Production Build Plan
Date: 2026-06-13
Design DNA: RankFlow AI System (Deep Navy Canvas, #f0a500 Gold Accent, Sharp Floating Nav, Lucide Icons, Translucent Glass, India-First Identity)
Skills Applied: creating-landing-pages (hero-first, section expansion) + design-taste-frontend (premium UI, anti-symmetric, anti-generic)
1. Hero-First Architecture (50% of Build Effort)#
Rule from
creating-landing-pages: The hero section sets colors, typography, and spacing for the rest of the site. Spend 50% of effort here.
Layout: Asymmetric Editorial Split (Design Variance: 8)#
| Zone | Position | Content | Responsive |
|---|---|---|---|
| Nav | Centered floating sharp-edged glass slab | Logo + 5 links + 2 CTAs | Collapses to hamburger below md |
| Left Column | 55% width, left-aligned | Overline → H1 → Body → 2 CTAs + Exclusivity badge | Stacks above visual on mobile |
| Right Column | 45% width | Flat isometric cityscape illustration + 6 HTML overlay cards | Scales to 70vw, cards remain visible |
| Trust Bar | Full-width below split | Kochi · Trivandrum · Calicut · Thrissur · Bangalore | 2-column grid on mobile |
Typography (Anti-Generic Override)#
| Element | Font | Weight | Size | Color | Line Height |
|---|---|---|---|---|---|
| Overline | Archivo | 600 | 0.75rem |
#f0a500 |
— |
| H1 | Archivo Black | 900 | clamp(2.95rem, 4vw, 4.35rem) |
#0d1b2a |
1.04 |
| Body | Figtree | 400 | 1.125rem |
#1a2a3a |
1.6 |
| CTA Primary | Archivo | 600 | 0.9375rem |
#0d1b2a |
— |
| CTA Secondary | Archivo | 600 | 0.9375rem |
#f0a500 |
— |
| Trust Bar | Figtree | 400 | 0.75rem |
#5a6b7a |
— |
| Exclusivity Badge | Archivo | 700 | 0.75rem |
#f0a500 |
— |
Infographic: Hero Isometric Cityscape Visual#
Asset Type: Generated image (PNG) + HTML overlay cards
Dimensions: 1200 × 900 (responsive via srcset)
Style: Flat isometric cityscape line art — Indian city elements (clinic, pharmacy, auto-rickshaw, street signs, Google Maps pin). No baked text, no UI cards, no logos in image.
HTML Overlay Cards (6):
| # | Title | Status | Icon | Position |
|---|---|---|---|---|
| 1 | Google Maps | Rank: #3 | MapPin | Top-left quadrant |
| 2 | Citations | Live: 28/30 | Globe | Top-center |
| 3 | GBP Posts | This Week: 4 | FileText | Top-right |
| 4 | Reviews | Replied: 12 | Star | Bottom-left |
| 5 | Social Reach | This Month: 4.2K | Share2 | Bottom-center |
| 6 | AI Engine | Indexed: Yes | Sparkles | Bottom-right |
Card Style: Sharp rectangle, dotted #ffd880 border, translucent white glass (bg-white/25), backdrop-blur-md, inner white edge (border-t-white/40), Lucide gold icon, uppercase title/status in Archivo.
Animation:
- Entrance: Illustration scales
0.985 → 1(800ms), connector lines draw in (SVG stroke-dashoffset), cards reveal with staggeredscale(0.95) + translateY(12px)→scale(1) + translateY(0) - Loop: One card at a time receives signal-lock state — subtle icon pulse (scale 1.04, 2s cycle), faint bottom rail (
#f0a500at 8% opacity), brief glass sheen (white gradient sweep, 1.5s) - GSAP:
gsap.timeline()withstaggerChildren: 0.12,ease: "power2.out" - Forbidden: No card bobbing, no racing dots, no particle systems, no node networks, no neon glow, no background video, no scroll hijack
prefers-reduced-motion: Cards render immediately, all transforms removed, signal loops disabled
2. Section-by-Section Infographic & Layout Plan#
Section 1A: Answer-First Definition (GEO-Optimized Block)#
Layout: Narrow editorial block, centered, max-width 56ch, directly below hero.
Purpose: AI search engine extractability — answers "What is RankFlow AI?" in 40-60 words for LLM/GEO crawlers.
Infographic: Code-Rendered RankFlow Diagram
- Type: SVG + HTML (NOT a raster image)
- Architecture:
- Central node: RankFlow logo (48px)
- 5 orbiting cards: Onboard, Build, Publish, Refresh, Results
- Dotted SVG connector paths from each card to central logo
- GSAP: Subtle pulse rings on central node (scale 1 → 1.06, 3s, infinite, ease-in-out)
- Slow orbiting ring details (rotate 360°, 60s, linear)
- Small signal dots traveling from central logo to each card (offset-path along SVG path, staggered, 4s each)
- Background: Clean white canvas — no gold gradient panel
- GEO: Plain text answer visible as crawlable HTML, no JS-rendered text, no images, no hidden content
Section 2: Problem Statement#
Layout: Asymmetric 2-column (55% text / 45% cards), below md stacks to single column.
Surface: --surface-inset (#f4f6f8 light navy)
Infographic: 3 Pain-Point Glass Frame Cards
Card Style: Glass frame mini-card
- Outer:
surface.elevated,1px border #fff3d0,p-6,rounded-xl - Shadow:
elevation.sm— hue-tinted (oklch(0.25 0.02 264) / 0.08) - Dotted signal border on hover: radial gradient tracks cursor (
#f0a500 / 0.08, 400px radius) - Icon left (24px,
#5a6b7a), title + description below
| Card | Icon | Title | Description |
|---|---|---|---|
| 1 | MapPin-Off (Lucide) | No Google Maps Presence | Patients search "dentist near me" and your clinic doesn't appear. No GBP, no reviews, no photos. |
| 2 | Clock-Alert (Lucide) | You Lose Patients to Competitors Daily | While you treat patients, your competitors are building citations, posting updates, and collecting reviews. |
| 3 | Files (Lucide) | Agencies Cost ₹15K–50K/Month. You Get Nothing. | Traditional SEO agencies charge a fortune and deliver reports, not rankings. They don't build citations or manage your GBP. |
Transition Line: "The tools aren't broken. They just weren't built for Indian clinics." — centered, #5a6b7a, Figtree Medium.
Section 3: The RankFlow Loop — ONBOARD → BUILD → PUBLISH → REFRESH → RESULTS#
Layout: Full-viewport horizontal pinned scroll. Total scroll distance: ~500vh (100vh per phase).
Surface: Dark (#0d1b2a — earns its darkness as the product's core loop)
Infographic: "The RankFlow Loop" — Lottie SVG Animation (The Page's Signature Visual)
Canvas: 1200 × 800px SVG viewBox. Dark background (#0d1b2a).
SVG Layer Architecture:
Layer 0: Background — radial gradient (dark center to darker edges)
Layer 1: Loop Ring — circular path, 5 quadrant arcs
Layer 2: Phase Nodes — 5 circles (48px) on the ring at 12, 2, 4, 6, 10 o'clock
Layer 3: Particle Stream — 15-20 dots (3px) traveling clockwise along ring path
Layer 4: Connection Lines — inner cross-connections between nodes
Layer 5: Active Phase Detail — expanded info panel (280 × 180px) for active node
Layer 6: Metric Badges — floating counters near active node with tabular-nums
Phase Nodes:
| Position | Phase | Icon | Inactive Color | Active Color |
|---|---|---|---|---|
| 12 o'clock | ONBOARD | Clipboard | oklch(0.45 0.02 264) |
#f0a500 |
| 2 o'clock | BUILD | Hammer | oklch(0.45 0.02 264) |
#f0a500 |
| 4 o'clock | PUBLISH | Send | oklch(0.45 0.02 264) |
#f0a500 |
| 6 o'clock | REFRESH | RefreshCw | oklch(0.45 0.02 264) |
#f0a500 |
| 10 o'clock | RESULTS | TrendingUp | oklch(0.45 0.02 264) |
#f0a500 |
Animation Scenes (Lottie Keyframes):
| Scene | Trigger | Duration | Key Actions |
|---|---|---|---|
| 0 — Idle Loop | Continuous | 8s loop | 15-20 particles flow clockwise. Subtle node pulse (scale 1→1.04, 2s, staggered 0.5s). Dashed ring stroke-dashoffset animation. |
| 1 — ONBOARD Activates | Scroll progress 0.05–0.20 | 1.2s | Node scales to 1.3, glow ring appears. Detail panel slides right. Metrics stagger: "5 min Setup" / "1 Form" / "0 Tech". Particles near node glow. Gold particles fork toward BUILD. |
| 2 — BUILD Activates | Scroll progress 0.20–0.40 | 1.2s | Node scales up. Detail panel slides left. Metrics: "30 Citations" / "60 sec AI" / "1 Profile Live". Build animation: document icons assemble from particles. |
| 3 — PUBLISH Activates | Scroll progress 0.40–0.60 | 1.2s | Node activates. Detail panel expands downward. Metrics: "30 Sites" / "4 Platforms" / "<1 hr Live". Publish animation: notification icons fly outward. |
| 4 — REFRESH Activates | Scroll progress 0.60–0.80 | 1.2s | Node activates. Detail panel expands downward. Metrics: "Monthly Refresh" / "2-4x Posts/Week" / "100% NAP Check". Refresh animation: circular refresh icon rotates. |
| 5 — RESULTS Activates | Scroll progress 0.80–0.95 | 1.5s | Double-pulse settle. Detail panel expands upward. Metrics: "#3 Position" / "28 Citations" / "4.2★ Reviews". Chart pulse: bar chart animates upward. |
| 6 — Perpetual Loop | Scroll progress 0.95–1.0 | Continuous | All 5 nodes lit. Peak particle density (25+). Gold "ranking signal" particle every 4s. |
Lottie Spec:
- Format: Lottie JSON (After Effects or Rive export)
- Frame rate: 30fps
- File size: <500KB total, <150KB per scene
- Interactivity:
lottie-interactivitywithgoToAndStop()synced to ScrollTrigger progress - Fallback: Static SVG with all 5 nodes lit,
prefers-reduced-motionserves this
GSAP ScrollTrigger Sync:
progress 0.00–0.05 → Idle loop (Scene 0)
progress 0.05–0.20 → Scene 1 (ONBOARD)
progress 0.20–0.40 → Scene 2 (BUILD)
progress 0.40–0.60 → Scene 3 (PUBLISH)
progress 0.60–0.80 → Scene 4 (REFRESH)
progress 0.80–0.95 → Scene 5 (RESULTS)
progress 0.95–1.00 → Perpetual loop (Scene 6)
Phase Cards (Within Scroll):
- Each phase enters as a glass frame card sliding in from right
- Previous phase fades to
opacity: 0.3and shifts left - Active phase card: dotted signal border tracks cursor on outer shell
- Progress indicator: 5 dots at bottom, active fills
#f0a500 - Metric strip numbers count up on phase entry (
tabular-nums, staggered cascade)
Phase Dashboard Mockups (Inside Each Card):
- ONBOARD: Mobile phone with onboarding form — step 1 of 5, clinic name, specialty, address, GPS pin
- BUILD: Directory submission diagram — 30 nodes with unique descriptions, directory profile preview
- PUBLISH: Multi-platform publish animation — 30 arrows from center to directory nodes + social icons
- REFRESH: Calendar grid showing monthly events — content rewrite, GBP post, social post, NAP check
- RESULTS: Dark dashboard with ranking trend line (climbing), citation count, review score, social reach
Section 4: Citation Deep Dive#
Layout: Asymmetric split — grid-cols-[0.45fr_0.55fr] (copy LEFT, visual RIGHT). Mockup overlaps -40px into Section 5.
Surface: Light (#ffffff)
Infographic 1: Trusted Directories Callout (Full-Width Banner)
- Style:
surface.elevated,rounded-lg, thinborder #f0a500 - Label:
TRUSTED DIRECTORIES(Archivo uppercase,#f0a500) - H3 + body + 5 bullet points about directory coverage and verification
Infographic 2: 9 Citation Categories Grid
- Layout:
grid-cols-[1.2fr_0.8fr]with 8px vertical offset on right column (visual tension) - Each entry: Title (Archivo Bold) + Description (Figtree Regular, max-width 42ch)
- 9 items: Google Business Profile, Justdial, Practo, Sulekha, Lybrate, IndiaMART, Apple Maps, Bing Places, Yelp India
Infographic 3: Citation Dashboard Mockup (RIGHT)
- Dark-themed dashboard in glass frame
- Grid of 30 directory tiles with status indicators (live/pending/removed)
- Side-panel showing DA scores and traffic estimates
- Glass frame outer shell: dotted signal border on hover
- Overlaps
-40pxinto Section 5 via negative margin - NO glow, NO particle overlay — strictly functional UI mockup
Section 5: Directory Profile#
Layout: Split — 45% directory profile preview LEFT / 55% copy RIGHT. Alternating pattern.
Surface: Dark (#0d1b2a)
Infographic: Directory Profile Preview Mockup
- Device: iPhone 15 frame (CSS or SVG, NOT raster)
- Dark app UI inside frame
- Screen 1 (Main): Landing page preview — hero with clinic name + photo → services grid → FAQ accordion → map embed → reviews widget → WhatsApp button
- Screens 2-4 (Below main): 3 small screens showing mobile view, desktop view, schema validation
- Animation: Phone enters from left with subtle parallax (0.15 factor). Screen content animates 5-step sequence (hero → services → FAQ → map → reviews, 2s total)
prefers-reduced-motion: Static screens, no animation
Hero Metric: <60 sec — Directory Profile Generation (Archivo Black, clamp(3rem, 5vw, 5rem), #f0a500)
Section 6: GBP + Social Deep Dive#
Layout: Split — 45% copy LEFT / 55% workflow visual RIGHT. Alternating pattern.
Surface: Light (#f4f6f8)
Infographic: GBP + Social Workflow Diagram (RIGHT)
- Dark-themed vertical flow diagram
- Nodes: Review arrives → Sentiment analysis → AI generates reply → Doctor approves → Published
- Clean connecting lines (1.5px,
#f0a500at 60% opacity) - No decorative elements, no glow, no particles
- Each node: Lucide icon + label in glass frame mini-card
- Platform icons: Google, Instagram, Facebook
- Arrow connectors between nodes with subtle draw-in animation on scroll
Pull Quote: Glass frame card with large italic text + attribution. Decorative opening quote mark in #f0a500, text-6xl, positioned absolutely top-left.
Section 7: AI Engine Optimization#
Layout: Split — 45% mobile mockup LEFT / 55% copy RIGHT. Alternating pattern.
Surface: Dark (#0d1b2a)
Infographic: Mobile Device Mockup (LEFT)
- Mobile device showing AI engine response
- Query: "Best cardiologist in Kochi"
- Response: RankFlow-optimized clinic appears as top recommendation with photo, rating, address, call button
- Static device (no 3D carousel — forbidden per design DNA)
- Single column, clean layout
Section 8: ROI#
Layout: Centered headline, 4 metrics in a row. Then horizontal exclusivity callout row.
Surface: Light (#ffffff)
Infographic 1: Metrics Row
- 4 metrics:
#3/28/30/4.2★/4.2K - Style: Archivo Black for values, Figtree uppercase for labels
- Count-up animation on scroll entry (
tabular-nums, staggered 100ms) - Responsive: 4-col → 2×2 → stacked
Infographic 2: Exclusivity Callout (Glass Frame)
- Outer shell:
surface.elevated,1px border #fff3d0,p-1.5,rounded-2xl - Inner core:
surface.base,rounded-[calc(2rem-0.375rem)], no visible border - Floats with
elevation.lghue-tinted shadow (shadow does the work, no visible border on inner card) - Dotted signal border on hover
- Label:
CITY-CATEGORY EXCLUSIVITY(Archivo uppercase,#f0a500) - H3 + body + 4 bullets
- Footnote: "Based on pilot program and anonymized client-reported metrics"
Section 9: Industries#
Layout: Segmented selector (8 tabs) with content panel below.
Surface: Light (#f4f6f8)
Infographic: Tabbed Industry Panel
- Tabs: 8 horizontal chips (GP, Cardiologist, Dentist, Dermatologist, Orthopedic, Gynecologist, Pediatrician, Multi-Specialty)
- Active tab: animated underline in
#f0a500via Framer MotionlayoutId(slides between tabs, 300ms,cubic-bezier(0.32, 0.72, 0, 1)) - Inactive:
#5a6b7a, no underline - Tab chips: subtle transform hover — chip pulls ±3px toward cursor within 60px radius.
active:scale(0.98)press feedback. - Content Panel: Per tab — Headline left, Metric right (large,
#f0a500,tabular-nums), Body + Bullets below - Panel entrance: staggered cascade (headline → metric → body → bullets at 80ms intervals)
- Mobile: horizontal-scroll chips, active chip fills
#fff3d0, no subtle hover (touch only)
Section 10: Integrations#
Layout: Centered headline + logo grid (no cards). 4 rows × 4 cols desktop.
Surface: Light (#ffffff)
Infographic: Logo Grid
- 16 logos grouped in 4 categories: Google & Local Search, Indian Directories, Social Media, Payments
- Each logo on tinted tile (
#f4f6f8background,rounded-md) - Logos in grayscale at 55% opacity, transition to full color on hover (300ms
cubic-bezier(0.32, 0.72, 0, 1)) - Subtle hover transform: logo translates 1px toward pointer within tile
- Tile: dotted signal border on hover (radial gradient tracks cursor,
#f0a500 / 0.08, 400px radius) - NO visible static border — dotted signal border IS the border
- Grid entrance: staggered cascade, 60ms intervals, reading order
Section 11: Security & Compliance#
Layout: Horizontal row — headline left (40%), certification badges + features right (60%).
Surface: Light (#f4f6f8)
Infographic: Compliance Badge Row
- 4 badges: DPDPA 2023, MCI Ethics, End-to-End Encryption, Data Residency (India)
- Badge style: Glass frame mini-card, icon + label + status
- NO unverified claims — DPDPA uses "designed to support" language until full certification
- Feature bullets: 6 items with Lucide icons (Doctor Approval Gate, Negative Review Safeguard, No Patient Data Storage, Explicit Consent, Data Deletion, MCI-Compliant Content)
Section 12: Social Proof#
Layout: Single testimonial carousel + logo wall below.
Surface: Light (#ffffff)
Infographic: Testimonial Card (Glass Frame)
- Outer shell:
surface.elevated,1px border #fff3d0,p-1.5,rounded-2xl - Inner core:
surface.base,rounded-[calc(2rem-0.375rem)],px-12 py-10 - Dotted signal border on outer shell
- Decorative opening quote mark:
#f0a500,text-6xl, absolute top-left of inner core - Author: Archivo Semibold. Title/city: Figtree,
#5a6b7a - Carousel auto-advances every 6s, opacity crossfade 250ms
- NO 3D tilt, NO glow
Logo Wall: Grayscale logos at 40% opacity. Kerala cities + Bangalore.
Section 13: Final CTA#
Layout: Full section, centered, generous vertical padding (section-gap × 1.5).
Surface: Dark (#0d1b2a)
Infographic: Background Radial
- Single soft radial:
#f0a500at 4% opacity, 800px radius, fading to transparent - NOT a glow — gentle warmth only
CTA Treatment:
- Sharp rectangular primary CTA with inline Lucide arrow
- Subtle transform hover: 2px max translate
- Active press:
scale(0.98) - Subtle background pulse on primary CTA:
#f0a500opacity oscillates0.9 → 1.0over 3s, infinite,ease-in-out(the ONE exception to the no-pulse rule — final conversion moment)
Section 14: Footer#
Layout: 4-column nav grid + SEO description block + Backed-By strip + address block + bottom bar.
Surface: Dark elevated (#0a1224 with noise overlay at 0.015 opacity)
Infographic Elements:
- 4-column nav: Platform, Industries, Resources, Company — expands crawlable internal link surface by 2.5×
- SEO Description Block: Full-width keyword-rich paragraph (max 280 chars) + "Learn more →" link
- Backed-By Strip: 4 logos (Antler, NVIDIA Inception, Google for Startups, Microsoft for Startups) — monochrome on dark, hover restores brand color
- Address Block: Physical address + email (mailto: link)
- Bottom Bar: Copyright + Privacy · Terms · Security · Sitemap · DPDPA Compliance + LinkedIn + YouTube + WhatsApp icons
3. Complete SEO & Schema Plan#
3.1 Page Metadata#
<title>RankFlow AI — India's AI Local Rank Engine for Doctors & Clinics</title>
<meta name="description" content="RankFlow AI connects your clinic, builds 30 citations, optimizes your Google Business Profile, and posts to social — all on autopilot. Only 3 clients per city per specialty. From ₹4,000/month.">
<link rel="canonical" href="https://rankflow.ai">
<!-- Open Graph -->
<meta property="og:title" content="RankFlow AI — India's First AI-Powered Local Rank Engine">
<meta property="og:description" content="Onboard in 5 minutes. Rank in 60 days. One AI copilot, 30 citations, full GBP management, social posts, and review replies — all automated. Only 3 clients per city per specialty.">
<meta property="og:image" content="https://rankflow.ai/og/homepage.webp">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:type" content="website">
<meta property="og:url" content="https://rankflow.ai">
<!-- Twitter Cards -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="RankFlow AI — India's First AI-Powered Local Rank Engine">
<meta name="twitter:description" content="Onboard in 5 minutes. Rank in 60 days. One AI copilot, 30 citations, full GBP management, social posts, and review replies — all automated.">
<meta name="twitter:image" content="https://rankflow.ai/og/homepage.webp">
<!-- Viewport & Mobile -->
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#f0a500">
<meta name="robots" content="index, follow, max-image-preview:large">
3.2 JSON-LD Schema (Structured Data)#
Schema 1: Organization
{
"@context": "https://schema.org",
"@type": "Organization",
"name": "RankFlow AI",
"url": "https://rankflow.ai",
"logo": "https://rankflow.ai/logo.svg",
"description": "RankFlow AI is India's first AI-powered local rank engine for medical clinics and doctors.",
"sameAs": [
"https://www.linkedin.com/company/rankflow-ai",
"https://www.youtube.com/@rankflowai",
"https://wa.me/918000000000"
],
"address": {
"@type": "PostalAddress",
"streetAddress": "32 Pekin Street, #05-01",
"addressLocality": "Singapore",
"postalCode": "048762",
"addressCountry": "SG"
}
}
Schema 2: SoftwareApplication
{
"@context": "https://schema.org",
"@type": "SoftwareApplication",
"name": "RankFlow AI Local Rank Engine",
"applicationCategory": "BusinessApplication",
"operatingSystem": "Web, iOS, Android",
"offers": {
"@type": "Offer",
"price": "4000",
"priceCurrency": "INR",
"priceValidUntil": "2026-12-31",
"description": "From ₹4,000/month. 7-day free trial available."
},
"aggregateRating": {
"@type": "AggregateRating",
"ratingValue": "4.8",
"reviewCount": "15"
},
"featureList": [
"30 citation building across Indian directories",
"Google Business Profile optimization",
"AI-generated directory profile with schema",
"Social media automation (Instagram, Facebook)",
"Review management with auto-reply",
"AI engine optimization for ChatGPT, Perplexity, Gemini"
]
}
Schema 3: WebSite (with Sitelinks Searchbox)
{
"@context": "https://schema.org",
"@type": "WebSite",
"name": "RankFlow AI",
"url": "https://rankflow.ai",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://rankflow.ai/search?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
}
Schema 4: FAQPage
{
"@context": "https://schema.org",
"@type": "FAQPage",
"mainEntity": [
{
"@type": "Question",
"name": "What is RankFlow AI?",
"acceptedAnswer": {
"@type": "Answer",
"text": "RankFlow AI is India's first AI-powered local rank engine for medical clinics and doctors. It builds 30 citations across Indian directories, manages your Google Business Profile, creates an SEO-optimized directory profile, posts to social media, and replies to reviews — all autonomously. You onboard in 5 minutes. Everything goes live in 60 minutes."
}
},
{
"@type": "Question",
"name": "How much does RankFlow AI cost?",
"acceptedAnswer": {
"@type": "Answer",
"text": "RankFlow AI starts at ₹4,000/month for the Starter plan. The Standard plan is ₹8,000/month, Premium is ₹15,000/month, and Enterprise is ₹25,000+/month. All plans include a 7-day free trial with no payment required."
}
},
{
"@type": "Question",
"name": "How long does it take to see results with RankFlow AI?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Most clients see their Google Maps position improve within 30-60 days. Your directory profile goes live in 60 minutes, citations are built within 24 hours, and GBP posts start immediately. Full ranking results typically appear within 60-90 days."
}
},
{
"@type": "Question",
"name": "Is RankFlow AI compliant with MCI ethics rules?",
"acceptedAnswer": {
"@type": "Answer",
"text": "Yes. RankFlow AI is designed to support MCI ethics compliance. All AI-generated content is informational, not promotional. We do not make 'best doctor' claims, guarantee cures, or use promotional language. All review replies and social posts are queued for doctor approval before publishing."
}
}
]
}
Schema 5: Review (for each testimonial)
{
"@context": "https://schema.org",
"@type": "Review",
"itemReviewed": {
"@type": "SoftwareApplication",
"name": "RankFlow AI Local Rank Engine"
},
"author": {
"@type": "Person",
"name": "Dr. Anjali Nair",
"jobTitle": "Cardiologist",
"address": {
"@type": "PostalAddress",
"addressLocality": "Kochi",
"addressCountry": "IN"
}
},
"reviewBody": "We went from #12 to #3 on Google Maps in 8 weeks. I didn't touch a single setting. RankFlow just built everything, published everywhere, and started sending me patients.",
"reviewRating": {
"@type": "Rating",
"ratingValue": "5",
"bestRating": "5"
}
}
Schema 6: BreadcrumbList
{
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
{
"@type": "ListItem",
"position": 1,
"name": "Home",
"item": "https://rankflow.ai"
}
]
}
Schema 7: LocalBusiness (for the company itself, if applicable)
{
"@context": "https://schema.org",
"@type": "LocalBusiness",
"name": "RankFlow AI",
"image": "https://rankflow.ai/logo.svg",
"url": "https://rankflow.ai",
"telephone": "+91-800-000-0000",
"address": {
"@type": "PostalAddress",
"streetAddress": "32 Pekin Street, #05-01",
"addressLocality": "Singapore",
"postalCode": "048762",
"addressCountry": "SG"
},
"geo": {
"@type": "GeoCoordinates",
"latitude": "1.2839",
"longitude": "103.8467"
},
"openingHoursSpecification": {
"@type": "OpeningHoursSpecification",
"dayOfWeek": ["Monday", "Tuesday", "Wednesday", "Thursday", "Friday"],
"opens": "09:00",
"closes": "18:00"
}
}
3.3 H1-H6 Heading Hierarchy#
| Element | Tag | Text | Notes |
|---|---|---|---|
| Hero Headline | H1 | Rank Your Clinic. Own Your Presence. Zero Effort. | Only one H1 per page |
| Answer-First | H2 | What is RankFlow AI? | GEO-optimized definition block |
| Problem | H2 | Your Patients Are Searching. You're Nowhere to Be Found. | |
| RankFlow Loop | H2 | A System That Ranks While You Treat Patients. | |
| Loop Phase 1 | H3 | 5 Minutes. One Form. Done. | Under H2 |
| Loop Phase 2 | H3 | 30 Citations. 1 Directory Profile. All Built by AI. | |
| Loop Phase 3 | H3 | Everything Goes Live. Zero Clicks From You. | |
| Loop Phase 4 | H3 | Monthly AI Refresh. Your Presence Never Stagnates. | |
| Loop Phase 5 | H3 | Rankings Rise. Patients Call. You See It All. | |
| Citations | H2 | 30 Citations. Indian Directories. Trusted by Patients. | |
| Directory Profile | H2 | Your Clinic's Directory Profile. Built by AI. Ranked by Google. | |
| GBP + Social | H2 | Google Business Profile + Social. Managed by AI. Approved by You. | |
| AI Engine | H2 | Rank on ChatGPT. Perplexity. Gemini. Not Just Google. | |
| Results | H2 | Outcomes Your Clinic Can't Ignore. | |
| Exclusivity | H3 | Only 3 Clinics Per City Per Specialty. Apply Now or Lose Your Spot. | |
| Industries | H2 | One Engine. Every Specialty. | |
| Industry Tabs | H3 | Be the First Doctor Patients Find. (etc.) | Per tab |
| Integrations | H2 | Connects With Everything You Already Use. | |
| Security | H2 | Built for Indian Healthcare. Compliant by Design. | |
| Social Proof | H2 | Trusted Where Rankings Aren't Optional. | |
| Final CTA | H2 | Ready to Rank in 60 Days? | |
| Footer SEO | H3 | RankFlow AI — India's AI Local Rank Engine for Clinics | SEO block |
3.4 EEAT Implementation Checklist#
Experience:
- At least 2 product screenshots from real deployments (anonymized if needed)
- At least 1 before/after ranking comparison with source label
- Named or anonymized customer reference with specialty and city
- GBP dashboard screenshots or directory listing samples with visible redaction where needed
Expertise:
- Content reviewed by Local SEO Subject Matter Expert (5+ years in Indian medical marketing)
- Technical review by AI/ML Engineer (multi-LLM orchestration experience)
- Author bios with credentials and LinkedIn profiles in footer or about page
- Local SEO-specific terminology used correctly ("citations," "NAP," "GBP," "schema," "DA")
Authoritativeness:
- Named customer testimonials: Dr. Anjali Nair (Kochi), Dr. Rajesh Kumar (Trivandrum), Dr. Priya Menon (Calicut)
- Backed-by logos: Antler, NVIDIA Inception, Google for Startups, Microsoft for Startups
- Industry-specific depth: 8 medical specialty tabs with detailed use cases
- Integration ecosystem: 30+ directory integrations, 4 social platforms
Trustworthiness:
- Source labeling on ALL metrics (see table below)
- Review cadence: Quarterly (last updated 2026-06-13, next review 2026-09-13)
- Reviewer names and credentials visible
- No unverified compliance claims (DPDPA 2023 uses "designed to support" until full certification)
- MCI ethics compliance: "informational, not promotional" language
- Privacy Policy, Terms of Service, Security, DPDPA Compliance links in footer
- Physical address and contact email in footer
- Sitemap link for crawler discovery
- Exclusivity guarantee: "Only 3 clinics per city per specialty" — verified and enforceable
Source Labeling (Mandatory on All Metrics):
| Metric | Value | Source Type | Display Format |
|---|---|---|---|
| Onboarding Time | 5 min | Internal UX benchmark | "Source: Internal UX benchmark, 2026-06" |
| AI Generation Time | 60 sec | Internal model benchmark | "Source: Internal benchmark, 2026-06" |
| Citations Built | 30 | Product architecture | "Source: Product architecture, 2026" |
| Sites Published | 30 | Product architecture | "Source: Product architecture, 2026" |
| Platforms Active | 4 | Product architecture | "Source: Product architecture, 2026" |
| Time to Live | <1 hr | Illustrative target | "Source: Illustrative target — not a guarantee" |
| Content Refresh | Monthly | Product architecture | "Source: Product architecture, 2026" |
| GBP Posts | 2–4x/week | Illustrative target | "Source: Illustrative target — not a guarantee" |
| NAP Consistency | 100% | Internal model benchmark | "Source: Internal benchmark, 2026-06" |
| Google Maps Position | #3 | Anonymized pilot | "Source: Anonymized pilot, 5 clinics, 2026" |
| Citations Live | 28/30 | Anonymized pilot | "Source: Anonymized pilot, 5 clinics, 2026" |
| Review Score | 4.2★ | Anonymized pilot | "Source: Anonymized pilot, 5 clinics, 2026" |
| Social Reach | 4.2K | Anonymized pilot | "Source: Anonymized pilot, 5 clinics, 2026" |
| Near Me Visibility | 87% | Anonymized pilot | "Source: Anonymized pilot, GP clinics, 2026" |
| High-Intent Calls | 72% | Anonymized pilot | "Source: Anonymized pilot, Cardiology, 2026" |
| Appointment Bookings | 68% | Anonymized pilot | "Source: Anonymized pilot, Dental, 2026" |
| Condition Traffic | 74% | Anonymized pilot | "Source: Anonymized pilot, Dermatology, 2026" |
| Injury Searches | 65% | Anonymized pilot | "Source: Anonymized pilot, Orthopedic, 2026" |
| Women's Health Calls | 79% | Anonymized pilot | "Source: Anonymized pilot, Gynecology, 2026" |
| Parent Searches | 71% | Anonymized pilot | "Source: Anonymized pilot, Pediatrics, 2026" |
| Multi-Specialty Visibility | 3× | Anonymized pilot | "Source: Anonymized pilot, Multi-Specialty, 2026" |
3.5 GEO / AI Search Optimization#
Answer-First Block (Section 1A):
- Plain text, no images, no hidden content, no JS-rendered text
- Directly answers "What is RankFlow AI?" in 40-60 words
- Formatted as standalone definition, visible to AI crawlers
FAQ Schema: Covers "What is RankFlow AI?", "How much does it cost?", "How long to see results?", "Is it MCI compliant?"
Terminology Consistency:
- "Local Rank Engine" (not "SEO tool" or "marketing platform")
- "AI Copilot" (not "dashboard" or "account manager")
- "Own Your Rankings" (not "optimization" or "management")
- "City-Category Exclusivity" (not "limited slots" or "scarcity")
- "Set It and Rank" (not "automated workflow" or "AI pipeline")
Content Freshness:
- Last updated: 2026-06-13
- Next review: 2026-09-13 (90-day cycle)
- Review within 7 days of product feature change, regulatory update, or competitive claim revision
4. Design Token Mapping#
Color Palette (Single-Accent System)#
| Token | Hex | Usage |
|---|---|---|
--accent-primary |
#f0a500 |
CTAs, icons, section numbers, dotted borders, active rank signals |
--accent-light |
#fff3d0 |
Hover fills, subtle backgrounds |
--accent-pale |
#ffd880 |
Construction lines, faint borders, secondary strokes |
--surface-base |
#ffffff |
Primary canvas |
--surface-inset |
#f4f6f8 |
Alternate sections, subtle depth |
--surface-elevated |
#ffffff |
Cards with shadow |
--surface-dark |
#0d1b2a |
Dark sections (hero, loop, directory profile, AI engine, final CTA) |
--surface-dark-elevated |
#0a1224 |
Footer, dark card variants |
--text-heading |
#0d1b2a |
Headlines, primary text |
--text-body |
#1a2a3a |
Body text, descriptions |
--text-secondary |
#5a6b7a |
Captions, labels, meta text |
--text-muted |
#5a6b7a |
Tertiary, disabled |
--text-on-dark |
#ffffff |
Text on dark surfaces |
--text-on-dark-muted |
#ffd880 |
Secondary text on dark |
--border-default |
#fff3d0 |
Subtle dividers, card borders |
--border-accent |
#f0a500 |
Active borders, focus rings |
--signal-default |
#f0a500 |
Status indicators, active states |
Typography Scale#
| Token | Size | Weight | Line Height | Usage |
|---|---|---|---|---|
--text-h1 |
clamp(2.95rem, 4vw, 4.35rem) |
900 | 1.04 | Hero H1 |
--text-h2 |
clamp(2.25rem, 3vw, 3.25rem) |
700 | 1.08 | Section H2 |
--text-h3 |
clamp(1.75rem, 2.5vw, 2.5rem) |
700 | 1.12 | Sub-section H3 |
--text-h4 |
1.25rem |
700 | 1.2 | Phase labels, card titles |
--text-body-lg |
1.125rem |
400 | 1.6 | Hero body, important text |
--text-body |
1rem |
400 | 1.6 | Standard body |
--text-body-sm |
0.875rem |
400 | 1.5 | Descriptions, bullets |
--text-caption |
0.75rem |
500 | 1.4 | Labels, meta, overlines |
--tracking-label |
0.08em |
— | — | Uppercase label letter-spacing |
Easing & Motion#
| Token | Value | Usage |
|---|---|---|
--ease-fluid-out |
cubic-bezier(0.32, 0.72, 0, 1) |
ALL transitions, entrances, hover states |
--ease-spring |
type: "spring", stiffness: 100, damping: 20 |
Framer Motion interactions |
--duration-fast |
200ms |
Hover states, micro-interactions |
--duration-normal |
300ms |
Standard transitions |
--duration-slow |
500ms |
Section entrances, reveals |
--duration-hero |
800ms |
Hero entrance sequence |
Spacing & Layout#
| Token | Value | Usage |
|---|---|---|
--section-gap |
120px (desktop) / 80px (mobile) |
Between major sections |
--content-max-width |
1280px |
Max container width |
--content-padding |
24px (mobile) / 48px (desktop) |
Horizontal page padding |
--card-padding |
24px |
Internal card padding |
--card-gap |
16px |
Gap between cards |
--radius-sm |
4px |
Small elements |
--radius-md |
8px |
Buttons, inputs |
--radius-lg |
16px |
Cards, panels |
--radius-xl |
24px |
Large containers |
5. Animation & Motion Plan#
Global Entrance Pattern (Per Section)#
Sequence: Label → Headline → Body → CTAs/Visuals → Supporting elements
Delay: 100ms between each element
Animation: translateY(20px) + opacity(0.01) → translateY(0) + opacity(1)
Duration: 600ms
Easing: cubic-bezier(0.32, 0.72, 0, 1)
Fill mode: both
Why: animation-fill-mode: both applies styles before AND after animation. Avoiding opacity: 0 prevents flash of invisible content.
Section-Specific Animations#
| Section | Animation | Tech | Notes |
|---|---|---|---|
| Hero | Blur-to-sharp entrance (800ms, staggered) | GSAP | Illustration scales 0.985→1, cards stagger 0.12s |
| Hero | Signal-lock card loop | GSAP | One card at a time: icon pulse + glass sheen |
| Problem | Stats grid cascade | Framer Motion | Cards appear with 60ms stagger, left→right |
| RankFlow Loop | Horizontal pinned scroll | GSAP ScrollTrigger | Pin: true, scrub: 1, 500vh total |
| RankFlow Loop | Lottie scroll-sync | lottie-interactivity | goToAndStop() per ScrollTrigger progress |
| RankFlow Loop | Metric count-up | GSAP | tabular-nums, staggered cascade on phase entry |
| Citations | Dashboard mockup draw-in | GSAP | Directory tiles appear with 80ms stagger |
| Directory Profile | Phone parallax entry | Framer Motion | translateX(-40px) + opacity, 0.15 parallax factor |
| Directory Profile | Screen step sequence | GSAP | Hero → services → FAQ → map → reviews, 2s total |
| GBP + Social | Workflow node draw-in | GSAP | Connector lines draw via stroke-dashoffset |
| AI Engine | Static device mockup | None | No animation (per design DNA) |
| Results | Metric count-up | GSAP | tabular-nums, 100ms stagger, triggered on scroll |
| Industries | Tab underline slide | Framer Motion | layoutId underline, 300ms fluid_out |
| Industries | Panel cascade | Framer Motion | headline → metric → body → bullets, 80ms intervals |
| Integrations | Logo grid stagger | Framer Motion | 60ms intervals, reading order |
| Security | Badge row fade-up | Framer Motion | 80ms stagger |
| Social Proof | Testimonial crossfade | CSS | 250ms opacity, auto-advance 6s |
| Final CTA | CTA background pulse | CSS | opacity 0.9→1.0, 3s, infinite, ease-in-out |
| Footer | Staggered logo cascade | Framer Motion | 60ms intervals, left→right, triggered on viewport entry |
Magnetic & Physics Effects (Where MOTION_INTENSITY > 5)#
| Element | Effect | Implementation | Performance |
|---|---|---|---|
| Integration tiles | Subtle pull toward cursor | onMouseMove transform, 1px max |
CSS transform only, no state |
| Industry tab chips | Pull ±3px toward cursor | Framer Motion useMotionValue + useTransform |
Isolated Client Component, memoized |
| Primary CTAs | Subtle scale on hover | transform: scale(1.02) |
CSS transition |
| Glass cards | Dotted signal border tracks cursor | Radial gradient background-position via CSS vars |
CSS only, no JS re-render |
Hardware Acceleration Rules#
- Animate ONLY:
transformandopacity - Never animate:
top,left,width,height,margin,padding - Use
will-change: transformsparingly, only on actively animating elements - Isolate perpetual motion in microscopic Client Components with
React.memo - Noise/grain filter: Fixed pseudo-element,
pointer-events-none, never on scroll containers
6. Responsive Architecture#
Breakpoint Strategy#
| Breakpoint | Width | Behavior |
|---|---|---|
sm |
640px | Minor adjustments |
md |
768px | Major layout switch — all asymmetric layouts stack to single column |
lg |
1024px | Full desktop layout active |
xl |
1280px | Max content width reached |
2xl |
1536px | Ultra-wide spacing adjustments |
Section-by-Section Responsive Behavior#
| Section | Desktop | Tablet | Mobile |
|---|---|---|---|
| 01 Hero | Full viewport, editorial split | Split preserved | Stack: text above visual, cards scaled, trust 2-col grid |
| 02 Problem | 2-column asymmetric | 2-column | 1-column stacked |
| 03 Loop | Horizontal pinned, 5 phases | Horizontal pinned | Vertical stack, NO pin, NO scrub |
| 04 Citations | 2-col list + mockup RIGHT | 2-col preserved | 1-col stack, mockup above text |
| 05 Directory Profile | Split, phone LEFT | Split preserved | Stack: phone centered at 70vw, copy below |
| 06 GBP + Social | Split 45/55 | Split 50/50 | Stack: text above visual |
| 07 AI Engine | Split, phone LEFT | Split preserved | Stack |
| 08 Results | 4-col metrics + callout | 2×2 metrics | Stack, callout full-width |
| 09 Industries | Tabs + panel | Tabs + panel | Horizontal-scroll chips + panel below |
| 10 Integrations | 4×4 logo grid | 3×4 grid | 2-col scroll |
| 11 Security | Horizontal row | Stack (label + bullets) | Stack |
| 12 Social Proof | Carousel + logos | Carousel + logos | Carousel + 2-row logos |
| 13 Final CTA | Centered | Centered | Centered, CTAs full-width stacked |
| 14 Footer | 4-col + SEO + Backers + address | 2×2 grid + SEO + Backers | 1-col stack + horizontal-scroll backers |
Mobile-Specific Guardrails#
- Never hide critical rank callouts on mobile — they remain visible as scaled translucent overlays
- Never use
h-screenfor hero — usemin-h-[100dvh]to prevent iOS Safari layout jumping - Pinned sections disabled below
md— no scroll hijack, no horizontal scroll, no 3D carousel - Touch-only interactions on mobile — no subtle cursor-tracking hover effects
- Max-width containers:
max-w-[1400px] mx-autowithpx-4(mobile) /px-12(desktop)
7. Asset Production Checklist#
Image Assets (To Generate)#
| Asset | Dimensions | Format | Style | Notes |
|---|---|---|---|---|
| Hero Isometric | 1200×900 | PNG | Flat isometric cityscape, Indian city elements, no text | HTML overlays handle all text |
| OG Image | 1200×630 | WebP | Light surface, cityscape + product mockup + numbered label | For social sharing |
| Citation Dashboard | 800×600 | PNG | Dark UI mockup, 30 directory tiles with status | No glow, no particles |
| Directory Profile Screens | 375×812 each | PNG | Dark app UI, directory profile preview + mobile/desktop/schema views | 4 screens total |
| GBP + Social Workflow | 600×800 | PNG | Dark vertical flow diagram, review → reply → publish | Clean lines, no decoration |
| AI Engine Response | 375×812 | PNG | Mobile device showing AI engine query + clinic recommendation | |
| Results Dashboard | 800×600 | PNG | Predictive dashboard, ranking trend, citation count, reviews | |
| Customer Logos | Various | SVG | Grayscale, monochrome variants | Kerala cities + Bangalore |
| Backer Logos | Various | SVG | Monochrome on dark, color on hover | Antler, NVIDIA, Google, Microsoft |
| Compliance Badges | 200×80 | SVG | DPDPA, MCI, Encryption, Data Residency | Only verified badges |
Animation Assets (To Produce)#
| Asset | Format | Size Target | Tool | Notes |
|---|---|---|---|---|
| "The RankFlow Loop" Lottie | JSON | <500KB total | After Effects / Rive | 6 scenes + idle loop, 30fps |
| Hero connector draw-in | SVG + CSS | Inline | GSAP | stroke-dashoffset animation |
| RankFlow diagram pulse | SVG + CSS | Inline | GSAP | Subtle rings, orbiting dots |
| Metric count-up | JS | Inline | GSAP | tabular-nums, staggered |
8. Component Inventory#
shadcn/ui Components (To Install)#
| Component | Usage | Customization Required |
|---|---|---|
| Button | CTAs throughout | Sharp rectangular (no radius), custom colors |
| Card | Glass frame base | Custom border, shadow, glass effect |
| Badge | Metric badges, status labels | Custom colors, tabular-nums |
| Tabs | Industry selector | Custom underline animation, layoutId |
| Accordion | Mobile results section | Custom styling |
| Separator | Section dividers | Custom color #fff3d0 |
| Sheet | Mobile navigation | Dark backdrop, custom animation |
Custom Components (To Build)#
| Component | Purpose | Complexity |
|---|---|---|
FloatingNav |
Centered sharp glass slab nav | Medium |
GlassCard |
Reusable glass frame card with dotted signal border | Medium |
HeroCityscape |
Illustration + 6 overlay cards | High |
RankFlowDiagram |
SVG central node + 5 orbiting cards | Medium |
RankFlowLoop |
GSAP pinned scroll + Lottie sync | High |
CitationGrid |
9-category asymmetric grid | Medium |
PhoneMockup |
CSS/SVG iPhone frame with screen content | Medium |
WorkflowDiagram |
Vertical node flow with draw-in | Medium |
MetricCounter |
Count-up with tabular-nums | Low |
IndustryTabs |
Framer Motion layoutId tabs | Medium |
LogoGrid |
4×4 staggered entrance grid | Low |
TestimonialCard |
Glass frame with quote | Medium |
SignalBorder |
Radial gradient cursor-tracking border | Medium |
DottedBorder |
SVG dotted border with animation | Low |
9. Performance & Accessibility Checklist#
Performance#
- Hero image:
<img loading="eager">withsrcsetfor responsive sizes - All other images:
loading="lazy"by default - Lottie JSON: Lazy-loaded, <500KB total, scene splitting if needed
- GSAP: Tree-shake unused plugins, import only
ScrollTrigger,gsap - Fonts: Preload Archivo Black and Figtree. Use
font-display: swap - CSS: Tailwind purges unused styles. Custom CSS in
globals.cssonly - No
h-screen— usemin-h-[100dvh]for all full-height sections - Noise/grain: Fixed pseudo-element,
pointer-events-none, never on scroll containers
Accessibility (WCAG 2.1 AA)#
- Color contrast: All text meets 4.5:1 ratio (heading) and 3:1 for large text
- Focus states: Visible
outline: 2px solid #f0a500on all interactive elements -
prefers-reduced-motion: All animations disabled, content visible immediately - Alt text: All images have descriptive alt text (no decorative image alt)
- Semantic HTML: Proper heading hierarchy, landmark regions (
<main>,<section>,<nav>,<footer>) - ARIA labels: Icon-only buttons, carousel controls, tab panels
- Keyboard navigation: All tabs, carousel, CTAs fully keyboard accessible
- Screen reader: Metric source labels read aloud, decorative elements hidden (
aria-hidden="true") - Form labels: All inputs have associated labels (future onboarding forms)
- Language:
lang="en"withml,hi,tasupport for i18n
Core Web Vitals Targets#
| Metric | Target | Strategy |
|---|---|---|
| LCP | < 2.5s | Preload hero image, optimize above-the-fold content |
| INP | < 200ms | CSS transforms only, isolate heavy JS components |
| CLS | < 0.1 | Explicit image dimensions, no layout shifts on load |
| TTFB | < 600ms | Edge caching (Vercel + Cloudflare), Next.js streaming |
| FCP | < 1.8s | Inline critical CSS, defer non-critical JS |
10. Build Execution Order#
Phase 1: Foundation (Day 1–2)#
- Initialize Next.js project with Tailwind, shadcn/ui
- Install dependencies:
gsap,framer-motion,lottie-react,lucide-react - Configure design tokens in
tailwind.config.ts(colors, fonts, spacing, easing) - Set up Google Fonts: Archivo (400, 600, 700, 900), Figtree (400, 500, 600)
- Create global styles:
globals.csswith CSS variables, noise, base typography - Build reusable components:
FloatingNav,GlassCard,SignalBorder,MetricCounter
Phase 2: Hero + Definition (Day 3–4)#
- Build
FloatingNav— centered sharp glass slab, mobile hamburger - Generate hero isometric cityscape illustration (PNG, 1200×900, no text)
- Build
HeroSection— asymmetric split, HTML overlay cards, exclusivity badge, trust bar - Build
AnswerFirstSection— GEO-optimized text + RankFlow SVG diagram - Implement hero entrance animations (GSAP timeline, staggered reveals)
- Test
prefers-reduced-motionfallback
Phase 3: Core Loop (Day 5–7)#
- Build
RankFlowLoopsection — GSAP ScrollTrigger pinned scroll, 5 phases - Create Lottie "RankFlow Loop" animation (6 scenes + idle)
- Implement Lottie ↔ ScrollTrigger sync (
goToAndStopper progress) - Build 5 phase cards with metric strips and dashboard mockups
- Implement metric count-up animations
- Test reduced-motion: vertical stack, no pin, no scrub
Phase 4: Deep Dives (Day 8–10)#
- Build
CitationSection— asymmetric split, 9-category grid, dashboard mockup - Build
LandingPageSection— profile preview, parallax, screen sequence - Build
GBPSocialSection— workflow diagram, pull quote card - Build
AIEngineSection— mobile device mockup, capability blocks - Build
ResultsSection— metrics row, exclusivity callout - Test all sections on mobile (stack, no pin, scaled visuals)
Phase 5: Supporting Sections (Day 11–12)#
- Build
IndustriesSection— 8 tabs, Framer Motion layoutId, panel cascade - Build
IntegrationsSection— logo grid, staggered entrance, hover transforms - Build
SecuritySection— compliance badges, feature bullets - Build
SocialProofSection— testimonial carousel, logo wall - Build
FinalCTASection— centered, radial background, pulsing CTA - Build
Footer— 4-column nav, SEO block, backers, address, bottom bar
Phase 6: SEO & Polish (Day 13–14)#
- Implement all JSON-LD schema (Organization, SoftwareApplication, WebSite, FAQPage, Review, BreadcrumbList, LocalBusiness)
- Add all meta tags, Open Graph, Twitter Cards, canonical, viewport
- Implement EEAT signals: reviewer names, source labels, last-updated, review cadence
- Add source labels to ALL metrics (inline beneath each number)
- Verify heading hierarchy (H1 → H2 → H3)
- Add
prefers-reduced-motionsupport across all sections - Run accessibility audit (keyboard nav, focus states, screen reader)
- Performance audit: Core Web Vitals, image optimization, font loading
- Add
lang="en"with i18n infrastructure forml,hi,ta
Phase 7: Launch (Day 15)#
- Deploy to staging, verify all animations, test responsive breakpoints
- Content review: verify all copy matches homepage-content.md
- Local SEO SME review + technical review sign-off
- Deploy to production
- Submit sitemap to Google Search Console, request indexing
- Set up Google Analytics 4 + GTM events for CTA clicks, trial starts
11. Risk & Quality Checklist#
Content Risks#
- NO "SEO tool" or "marketing agency" terminology anywhere — we are a "Local Rank Engine"
- NO unverified compliance claims — DPDPA 2023 uses "designed to support" until full certification
- NO guaranteed ranking promises — Use "expected trajectory" or "illustrative target" language
- ALL metrics have source labels — Remove any unsubstantiated claim before publish
- Customer quotes verified — Dr. Anjali Nair, Dr. Rajesh Kumar, Dr. Priya Menon are approved and accurate
- MCI ethics compliance — All content is "informational, not promotional" — no "best doctor" claims
- Exclusivity claim verified — "Only 3 clinics per city per specialty" must be enforceable and true
- NO mention of owned citation network — The 20–50 owned sites are a competitive moat and must never appear in public-facing content, marketing, or client communications. Use "trusted directories" or "30 citations" only.
Design Risks#
- NO dark surfaces without approval — Only 5 sections earn darkness (Hero, Loop, Directory Profile, AI Engine, Final CTA)
- NO rounded CTAs — Sharp rectangular only
- NO particles, glow, neon, 3D tilt — Restrained motion only (draw-in, signal-lock, pulse, glass sheen)
- NO card bobbing or racing dots — Cards stay fixed
- NO scroll hijack before hero approved — Pinned scroll only in Loop section
- NO baked text in images — All labels in HTML overlays
Technical Risks#
- NO
h-screen— Usemin-h-[100dvh]for all full-height sections - NO
useStatefor magnetic/continuous animations — Use Framer MotionuseMotionValueoutside render cycle - NO GSAP + Framer Motion in same component — Isolate GSAP to scroll/pinned sections only
- NO heavy perpetual animations on scroll containers — Fixed pseudo-element for noise only
- Dependency check — Verify
gsap,framer-motion,lottie-reactinpackage.jsonbefore import - i18n readiness — UI labels must support
ml,hi,tafrom Day 1
SEO Risks#
- Canonical tag —
https://rankflow.ai(no trailing slash conflict) - OG image — 1200×630, <1MB, absolute URL
- Schema validation — Test all JSON-LD in Google Rich Results Test
- Internal links — All footer links use descriptive anchor text (no "click here")
- Hreflang — Add when multi-language support goes live
- Robots meta —
index, followon homepage,noindexon /onboard form (post-submission) - LocalBusiness schema — Must include
address,geo,telephone,openingHours
12. Post-Launch Monitoring#
SEO Monitoring (Weekly)#
- Google Search Console: impressions, clicks, CTR, average position
- Index coverage: ensure all sections indexed, no "Crawled — currently not indexed"
- Core Web Vitals: LCP, INP, CLS reports
- Schema validation: rich results appearance in SERP
- AI search visibility: Perplexity, ChatGPT, Gemini citations for "best [specialty] in [city]"
- Local pack rankings: Track Google Maps 3-pack appearances for target keywords
Content Freshness (Quarterly)#
- Review date: 2026-09-13 (90 days from last update)
- Update metrics with new pilot data from Kerala beta clients
- Refresh customer testimonials if new quotes available
- Verify integration list accuracy (30+ directories, 4 social platforms)
- Check DPDPA 2023 compliance status (full compliance target: May 2027)
- Update "last updated" and "next review" dates in footer
- Verify exclusivity claim accuracy (spot count per city per specialty)
Summary#
This plan produces a hero-first, premium, anti-generic directory profile that:
- Follows the SAFVR homepage-content.md template exactly — 14 sections, all copy, all metrics, all layouts, all interaction notes, all SEO schema, all EEAT signals
- Is adapted for RankFlow AI — India's first AI-powered local rank engine for medical clinics, with city-category exclusivity, MCI compliance, and India-first identity
- Applies the directory profile skill's hero-first workflow — 50% effort on hero, consistent design system, section expansion
- Enforces the design-taste-frontend's premium standards — Anti-symmetric, anti-center, anti-Inter, anti-card-overuse, liquid glass, spring physics, hardware acceleration
- Is fully SEO-optimized — 7 JSON-LD schemas, EEAT signals, GEO extractability, heading hierarchy, meta tags, Open Graph, source labels, LocalBusiness schema
- Has a complete infographic plan — Every section has a visual asset: generated images, SVG diagrams, Lottie animations, CSS mockups, dashboard previews
- Is production-ready — 15-day build timeline, component inventory, asset checklist, performance targets, accessibility compliance, risk mitigations, India-specific considerations (i18n, DPDPA, MCI, rupee pricing)
Next step: Proceed to asset generation (hero isometric illustration, Lottie animation, dashboard mockups) and component development (starting with FloatingNav, GlassCard, HeroSection).