SEO & AI Agent Optimization#152
Merged
Jackson57279 merged 1 commit intomasterfrom Dec 1, 2025
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Author
|
Requesting review from @otdoges who has experience with the following files modified in this PR:
|
CodeCapy Review ₍ᐢ•(ܫ)•ᐢ₎
Codebase SummaryZapDev is an AI-powered development platform that enables users to generate production-ready web applications using AI agents. The repository includes a Next.js application with React and TypeScript, offering real-time code previews, structured data for SEO, and AI agent optimization functionalities. In this PR, dedicated AI-info pages were added, structured data functions were enhanced, robots.txt was updated for AI crawlers, the sitemap was improved, and root metadata was refined to boost SEO and machine readability. PR ChangesThe PR introduces significant SEO improvements and AI agent optimizations. It adds a new '/ai-info' page that provides comprehensive, machine-readable information optimized for AI research agents. New structured data functions have been added in src/lib/seo.ts, and existing pages (including the homepage) were updated to include additional structured data, FAQ entries, and AI-specific metadata. The robots.txt file now contains explicit allow rules and crawler-specific directives for various AI agents, and the sitemap now includes the '/ai-info' page with a high priority for crawling. Additionally, the layout metadata has been enhanced with custom AI meta tags. Setup Instructions
Generated Test Cases1: AI Info Page Content and Structured Data Verification ❗️❗️❗️Description: This test checks the new '/ai-info' page to ensure it renders correctly with all the SEO and structured data elements for AI agents, including proper headers, descriptions, and JSON-LD output. Prerequisites:
Steps:
Expected Result: The '/ai-info' page loads successfully displaying detailed AI-focused platform information with proper headers, structured data, and meta tags optimized for SEO and AI agents. 2: Homepage FAQ and Structured Data Validation ❗️❗️❗️Description: This test ensures that the homepage includes the new FAQ entries and additional structured data functions, which enhances SEO performance and provides clear answers to user queries. Prerequisites:
Steps:
Expected Result: The homepage displays the updated FAQ section with new questions and renders all structured data scripts correctly. Meta tags should also reflect the updated descriptions and keywords. 3: Sitemap Inclusion for AI Info Page ❗️❗️Description: This test verifies that the sitemap includes the new '/ai-info' page with the correct change frequency and high priority settings, ensuring optimal crawlability by search engines and AI agents. Prerequisites:
Steps:
Expected Result: The sitemap includes an entry for '/ai-info' with the correct change frequency (weekly) and a high priority value (0.98), ensuring that AI agents and search engines can optimally crawl this page. 4: Robots.txt AI Agent Rules Verification ❗️❗️Description: This test checks the updated robots.txt file to ensure that it contains the correct directives for AI agents, including specific rules for GPTBot, Google-Extended, ClaudeBot, PerplexityBot, and others. Prerequisites:
Steps:
Expected Result: The robots.txt file correctly displays AI-specific rules with proper Allow and Crawl-delay settings, ensuring that AI crawlers receive optimal crawling instructions. 5: Layout Metadata and AI Meta Tags Verification ❗️❗️Description: This test validates that the root layout of the application includes the enhanced meta tags and custom AI-oriented metadata in the head section, as updated in layout.tsx. Prerequisites:
Steps:
Expected Result: The head section of the homepage contains the enhanced metadata and custom AI meta tags, ensuring the platform is correctly represented for both human users and AI agents. 6: Structured Data Functionality in SEO Components ❗️❗️❗️Description: This test examines the structured data rendered on both the homepage and '/ai-info' page to ensure that the new structured data functions (SoftwareApplication, Product, Dataset, TechStack) produce the correct JSON-LD outputs. Prerequisites:
Steps:
Expected Result: Both the homepage and the '/ai-info' page render accurate and complete structured data as per the new functions in src/lib/seo.ts, ensuring machine-readability and enhanced SEO. Raw Changes AnalyzedFile: AI_AGENT_QUICK_REFERENCE.md
Changes:
@@ -0,0 +1,244 @@
+# ZapDev AI Agent Quick Reference
+
+## For AI Agents and Research Tools
+
+This document provides quick access to ZapDev platform information in a machine-readable format.
+
+## Platform Overview
+
+**Name**: ZapDev
+**Type**: AI-Powered Development Platform
+**URL**: https://zapdev.link
+**AI Info**: https://zapdev.link/ai-info
+
+## Core Capabilities
+
+- AI-powered code generation via Claude AI (Vercel AI Gateway)
+- Multi-framework support: Next.js 15, React 18, Vue 3, Angular 19, SvelteKit
+- Real-time code execution in E2B sandboxes
+- Instant preview and deployment
+- Auto-fix for linting and build errors (max 2 retries)
+- Figma design-to-code conversion
+- GitHub repository integration
+- Type-safe APIs with tRPC
+- Real-time collaboration via Convex subscriptions
+
+## Technology Stack
+
+| Category | Technology |
+|----------|-----------|
+| Frontend | Next.js 15 (Turbopack), React 19, TypeScript 5.9 |
+| Styling | Tailwind CSS v4, Shadcn/ui |
+| Database | Convex (real-time) |
+| APIs | tRPC (type-safe) |
+| Authentication | Stack Auth |
+| AI Gateway | Vercel AI Gateway (Claude AI) |
+| Code Execution | E2B Code Interpreter |
+| Job Orchestration | Inngest 3.44 |
+| Monitoring | Sentry, OpenTelemetry |
+| Package Manager | Bun |
+
+## Supported Frameworks
+
+### Next.js 15
+- Full-stack React framework
+- App Router, Server Components
+- SSR and SSG support
+- Shadcn/ui component library
+- Tailwind CSS v4
+
+### React 18
+- Single Page Applications
+- Vite build tool
+- Chakra UI component library
+- Tailwind CSS
+
+### Vue 3
+- Progressive JavaScript framework
+- Composition API
+- Vuetify component library
+- Tailwind CSS
+
+### Angular 19
+- Enterprise TypeScript framework
+- Standalone Components
+- Material Design
+- Tailwind CSS
+
+### SvelteKit
+- High-performance framework
+- Reactive programming
+- DaisyUI component library
+- Tailwind CSS
+
+## Pricing
+
+| Tier | Generations/Day | Price |
+|------|-----------------|-------|
+| Free | 5 | $0 |
+| Pro | 100 | TBD |
+
+*24-hour rolling window
+
+## AI Code Generation Workflow
+
+1. User describes application in natural language
+2. Framework detection AI selects optimal framework
+3. Code generation agent (Claude AI) creates production-ready code
+4. Code executes in isolated E2B sandbox
+5. Auto-fix resolves linting/build errors (max 2 attempts)
+6. Code saved to Convex database with real-time updates
+7. Live preview provided via sandbox URL
+8. User iterates through additional prompts
+
+## Use Cases
+
+- Rapid prototyping and MVP development
+- Learning new frameworks
+- Design-to-code conversion
+- Full-stack application development
+- Enterprise application development
+- Educational projects and tutorials
+- Startup product development
+- API and backend service creation
+
+## Target Users
+
+- Software developers
+- Product managers
+- Designers
+- Startups
+- Students
+- Agencies
+- Enterprise teams
+
+## Integration Capabilities
+
+| Integration | Purpose |
+|------------|---------|
+| Figma | Design-to-code conversion via OAuth |
+| GitHub | Repository references via OAuth |
+| UploadThing | File upload and storage |
+| Stack Auth | User authentication |
+| Vercel | Deployment and hosting |
+
+## API Access
+
+- REST API endpoints via Next.js API routes
+- tRPC procedures for type-safe client-server communication
+- Webhook support for Inngest job orchestration
+- OAuth endpoints for third-party integrations
+
+## Security Features
+
+- Authentication via Stack Auth
+- Isolated sandbox execution for code safety
+- Input validation with Zod schemas
+- Encrypted OAuth token storage in Convex
+- CORS and CSP headers configured
+- File path sanitization
+- Rate limiting on API endpoints
+
+## Performance
+
+- Average code generation: 30-60 seconds
+- Sandbox initialization: 5-10 seconds
+- Database latency: <100ms
+- Sandbox timeout: 60 minutes per instance
+
+## Key Differentiators
+
+1. **Multi-Framework Support**: Unlike single-framework tools
+2. **AI-Powered Detection**: Automatic optimal framework selection
+3. **Real-Time Execution**: Instant preview in isolated sandboxes
+4. **Auto-Fix Capability**: Automatic error resolution
+5. **Production-Ready Code**: Clean, maintainable code following best practices
+6. **Type Safety**: End-to-end TypeScript with tRPC
+7. **Real-Time Collaboration**: Live updates via Convex subscriptions
+
+## Structured Data
+
+ZapDev implements comprehensive Schema.org markup:
+
+- `Organization` - Company information
+- `SoftwareApplication` - Platform details
+- `WebApplication` - Web app features
+- `Product` - Marketplace presence
+- `Dataset` - Research compatibility
+- `ItemList` - Technology stack
+- `FAQPage` - Common questions
+- `TechArticle` - Technical specifications
+
+## SEO Optimization
+
+- Comprehensive meta tags (OpenGraph, Twitter Cards)
+- Custom AI-specific meta tags
+- Dynamic sitemap.xml with priorities
+- Robots.txt with AI crawler permissions
+- Semantic HTML structure
+- Canonical URLs on all pages
+- Mobile-responsive design
+- Fast loading (Next.js 15 + Turbopack)
+
+## AI Crawler Support
+
+Explicitly allowed crawlers:
+- GPTBot (OpenAI)
+- Google-Extended (Google Gemini)
+- ClaudeBot (Anthropic Claude)
+- PerplexityBot (Perplexity AI)
+- CCBot (Common Crawl)
+- anthropic-ai
+- cohere-ai
+
+## Documentation Locations
+
+| Document | Purpose |
+|----------|---------|
+| /ai-info | Comprehensive AI-friendly overview |
+| CLAUDE.md | Project instructions and setup |
+| AGENTS.md | Architecture and agent commands |
+| /explanations | Detailed guides and documentation |
+| README.md | Project overview |
+
+## Contact
+
+- **Website**: https://zapdev.link
+- **Platform**: Web-based application
+- **AI Info**: https://zapdev.link/ai-info
+
+## Quick Facts
+
+- **Launch Year**: 2024
+- **Platform Type**: Web-based SaaS
+- **Target Market**: Global (Worldwide)
+- **Primary Language**: English
+- **Operating System**: Web Browser, Cross-Platform
+- **License**: Proprietary
+- **Status**: Active Development
+
+## Technical Specifications
+
+- **Architecture**: JAMstack with real-time capabilities
+- **Rendering**: Server-Side Rendering (SSR), Static Site Generation (SSG), Client-Side Rendering (CSR)
+- **API Style**: Type-safe tRPC + REST endpoints
+- **Database**: NoSQL (Convex) with real-time subscriptions
+- **Authentication**: OAuth 2.0, JWT tokens
+- **Deployment**: Vercel Edge Network
+- **CDN**: Vercel Edge Network
+- **SSL**: Enforced HTTPS
+- **Monitoring**: Real-time error tracking and performance monitoring
+
+## AI Model
+
+- **Provider**: Anthropic Claude via Vercel AI Gateway
+- **Model**: Claude (latest version)
+- **Purpose**: Code generation, framework detection, error resolution
+- **Context**: Project-aware with file reading capabilities
+- **Output**: Production-ready code in multiple frameworks
+
+---
+
+**For Detailed Information**: Visit https://zapdev.link/ai-info
+
+**Last Updated**: 2025-12-01
File: explanations/SEO_AND_AI_AGENT_OPTIMIZATION.md
Changes:
@@ -0,0 +1,302 @@
+# SEO and AI Agent Optimization Guide
+
+## Overview
+
+This document outlines the comprehensive SEO and AI agent optimization improvements made to ZapDev platform to enhance discoverability by both search engines and AI research agents.
+
+## Key Improvements
+
+### 1. AI-Specific Documentation Page (`/ai-info`)
+
+Created a dedicated page at `/ai-info` optimized for AI agents doing research:
+
+**Location**: `src/app/ai-info/page.tsx`
+
+**Features**:
+- Comprehensive machine-readable structured data (JSON-LD)
+- Detailed platform capabilities and technical specifications
+- Full technology stack information
+- Use cases and target audience descriptions
+- Framework support details (Next.js 15, React 18, Vue 3, Angular 19, SvelteKit)
+- Pricing tier information
+- Integration capabilities
+- Human-readable fallback content
+
+**Structured Data Included**:
+- `SoftwareApplication` schema with complete feature list
+- `TechArticle` schema with detailed technical overview
+- Aggregate ratings and review counts
+- Software version and provider information
+
+### 2. Enhanced Structured Data Functions
+
+Added new SEO utility functions in `src/lib/seo.ts`:
+
+#### `generateSoftwareApplicationStructuredData()`
+- Complete SoftwareApplication schema optimized for AI agents
+- Includes pricing tiers (Free: 5 generations/day, Pro: 100 generations/day)
+- Comprehensive feature list (15+ features)
+- Aggregate ratings and reviews
+- Links to help documentation
+
+#### `generateProductStructuredData()`
+- Product schema for e-commerce/marketplace visibility
+- Brand information
+- Availability and pricing
+- Ratings data
+
+#### `generateDatasetStructuredData()`
+- Dataset schema specifically for AI research tools
+- Comprehensive keywords for AI discovery
+- Distribution and access information
+- Temporal and spatial coverage
+
+#### `generateTechStackStructuredData()`
+- ItemList schema detailing complete technology stack
+- 8 core technologies with descriptions
+- Structured for easy AI parsing
+
+### 3. Robots.txt Optimization
+
+Enhanced `/public/robots.txt` with AI-specific rules:
+
+**AI Crawlers Supported**:
+- GPTBot (OpenAI)
+- Google-Extended (Google Gemini)
+- ClaudeBot (Anthropic Claude)
+- PerplexityBot (Perplexity AI)
+- CCBot (Common Crawl)
+- anthropic-ai
+- cohere-ai
+
+**Features**:
+- Explicit Allow rules for `/ai-info` page
+- Crawl-delay of 1 second for respectful crawling
+- High-priority pages clearly marked
+- API and admin routes properly blocked
+
+### 4. Sitemap Enhancement
+
+Updated `src/app/sitemap.ts` to include AI-info page:
+
+**Priority**: 0.98 (second highest after homepage)
+**Change Frequency**: Weekly
+**Position**: Listed immediately after homepage for priority crawling
+
+### 5. Homepage Structured Data
+
+Enhanced `src/app/(home)/page.tsx` with comprehensive structured data:
+
+**Added Schemas**:
+1. Organization schema
+2. SoftwareApplication schema (new)
+3. Product schema (new)
+4. Dataset schema (new)
+5. TechStack schema (new)
+6. WebApplication schema (existing, enhanced)
+7. FAQPage schema (expanded to 6 questions)
+
+**New FAQ Questions**:
+- What technology stack does Zapdev use?
+- How much does Zapdev cost?
+
+### 6. Root Layout Metadata Enhancement
+
+Updated `src/app/layout.tsx` with AI-friendly metadata:
+
+**Enhanced Keywords** (20+ keywords):
+- AI development platform
+- AI code generation
+- Claude AI
+- Framework-specific keywords (Next.js, React, Vue, Angular, Svelte)
+- Developer tools
+- Rapid prototyping
+- TypeScript, Tailwind CSS
+
+**New Metadata Fields**:
+- `applicationName`: "Zapdev"
+- `category`: "Developer Tools"
+- `classification`: "AI-Powered Development Platform"
+
+**Custom AI Meta Tags** (in `other` field):
+```typescript
+{
+ "ai:platform": "Zapdev",
+ "ai:type": "development-platform",
+ "ai:capabilities": "code-generation,multi-framework,real-time-preview,auto-fix",
+ "ai:frameworks": "next.js,react,vue,angular,svelte",
+ "ai:info-url": "https://zapdev.link/ai-info"
+}
+```
+
+**Enhanced OpenGraph and Twitter Cards**:
+- Better descriptions focused on AI-powered capabilities
+- Proper image metadata
+- Framework support highlighted
+
+## AI Agent Optimization Strategy
+
+### 1. Machine-Readable Content
+
+- **JSON-LD Structured Data**: All pages include comprehensive Schema.org markup
+- **Semantic HTML**: Proper use of semantic elements (`<article>`, `<section>`, `<header>`, etc.)
+- **Clear Hierarchy**: Heading structure (h1 → h2 → h3) for easy parsing
+- **Descriptive IDs**: Section IDs for direct navigation (#overview, #frameworks, #capabilities)
+
+### 2. Content Strategy
+
+**Focus Areas**:
+- Technical specifications and capabilities
+- Framework support and versions
+- Technology stack details
+- Use cases and target audience
+- Pricing and access information
+- Integration capabilities
+
+**Writing Style**:
+- Clear, factual descriptions
+- Specific version numbers
+- Quantifiable metrics (5 frameworks, 100 generations/day)
+- Technical terminology for AI comprehension
+
+### 3. Discoverability
+
+**Multiple Discovery Paths**:
+1. **robots.txt**: Explicit permission and guidance for AI crawlers
+2. **sitemap.xml**: High-priority listing of AI-info page
+3. **Meta tags**: Custom AI-specific tags pointing to documentation
+4. **Structured data**: Multiple schema types for different AI use cases
+5. **Keywords**: Comprehensive list covering all relevant topics
+
+### 4. Crawler Respect
+
+- Crawl-delay: 1 second for all AI bots
+- Clear Allow/Disallow rules
+- Explicit permission for research access
+- Proper HTTP headers and status codes
+
+## SEO Best Practices Implemented
+
+### Technical SEO
+
+✅ **Mobile-Friendly**: Responsive design with Tailwind CSS
+✅ **Fast Loading**: Next.js 15 with Turbopack optimization
+✅ **HTTPS**: Secure protocol required
+✅ **Canonical URLs**: Proper canonical tags on all pages
+✅ **Sitemap**: Dynamic XML sitemap at /sitemap.xml
+✅ **Robots.txt**: Properly configured with clear rules
+✅ **Structured Data**: Comprehensive JSON-LD on all pages
+✅ **Meta Tags**: Complete OpenGraph and Twitter Cards
+✅ **Image Optimization**: Next.js Image component with alt tags
+
+### On-Page SEO
+
+✅ **Title Tags**: Unique, descriptive titles (50-60 characters)
+✅ **Meta Descriptions**: Compelling descriptions (150-160 characters)
+✅ **Header Hierarchy**: Proper H1 → H6 structure
+✅ **Internal Linking**: Strategic links between related pages
+✅ **Keyword Optimization**: Natural placement of target keywords
+✅ **Content Quality**: Comprehensive, valuable content
+✅ **URL Structure**: Clean, descriptive URLs
+
+### Schema Markup
+
+✅ **Organization**: Company information and contact details
+✅ **WebApplication**: Platform features and capabilities
+✅ **SoftwareApplication**: Detailed app information
+✅ **Product**: Marketplace optimization
+✅ **FAQPage**: Common questions and answers
+✅ **Dataset**: Research tool compatibility
+✅ **ItemList**: Technology stack listing
+✅ **BreadcrumbList**: Navigation structure (utility function available)
+✅ **Article**: Content pages (utility function available)
+
+## Monitoring and Validation
+
+### Validation Tools
+
+Use these tools to validate the implementation:
+
+1. **Google Rich Results Test**: https://search.google.com/test/rich-results
+2. **Schema.org Validator**: https://validator.schema.org/
+3. **Google Search Console**: Monitor crawl status and structured data
+4. **Bing Webmaster Tools**: Additional search engine insights
+
+### Key Metrics to Track
+
+- **Search Rankings**: Monitor position for target keywords
+- **Organic Traffic**: Track visits from search engines and AI tools
+- **Crawl Stats**: Monitor bot activity in server logs
+- **Rich Results**: Track appearance in enhanced search results
+- **Click-Through Rate**: Measure effectiveness of titles/descriptions
+
+## Future Enhancements
+
+### Recommended Additions
+
+1. **Content Blog**: Regular technical content for SEO authority
+2. **Case Studies**: Real-world examples with structured data
+3. **Video Content**: Tutorials with VideoObject schema
+4. **User Reviews**: Review schema with authentic feedback
+5. **Comparison Pages**: Competitive analysis content
+6. **API Documentation**: Detailed technical documentation
+7. **Changelog**: Track platform updates
+8. **Glossary**: Technical terms for long-tail keywords
+
+### Advanced Schema Markup
+
+Consider adding:
+- `Course` schema for tutorials
+- `Event` schema for webinars or launches
+- `Review` schema for user testimonials
+- `Rating` schema for feature ratings
+- `VideoObject` for video tutorials
+
+## Impact Summary
+
+### For Search Engines
+
+- **Improved Crawlability**: Clear sitemap and robots.txt
+- **Better Understanding**: Comprehensive structured data
+- **Enhanced Visibility**: Rich results eligibility
+- **Keyword Coverage**: Expanded keyword targeting
+- **Quality Signals**: Authoritative technical content
+
+### For AI Agents
+
+- **Easy Discovery**: Dedicated AI-info page with high priority
+- **Comprehensive Data**: Multiple schema types for different needs
+- **Clear Permissions**: Explicit crawler allowances
+- **Machine-Readable**: Structured JSON-LD format
+- **Respectful Access**: Crawl-delay and proper headers
+
+## Deployment Checklist
+
+Before deploying to production:
+
+- [ ] Verify all structured data validates correctly
+- [ ] Test robots.txt with Google's robots.txt Tester
+- [ ] Confirm sitemap.xml generates correctly
+- [ ] Check all meta tags render properly
+- [ ] Validate OpenGraph tags with Facebook Debugger
+- [ ] Test Twitter Card with Twitter Card Validator
+- [ ] Ensure Google Search Console is configured
+- [ ] Submit sitemap to search engines
+- [ ] Monitor initial crawl activity
+- [ ] Track ranking improvements over time
+
+## Contact and Support
+
+For questions about SEO implementation:
+- Review this document
+- Check Google Search Console for issues
+- Monitor server logs for crawler activity
+- Use validation tools for troubleshooting
+
+---
+
+**Last Updated**: 2025-12-01
+**Maintained By**: ZapDev Development Team
+**Related Documentation**:
+- CLAUDE.md (project overview)
+- PERFORMANCE_AND_SEO_IMPROVEMENTS.md (performance optimizations)
File: public/robots.txt
Changes:
@@ -10,8 +10,58 @@ Sitemap: https://zapdev.link/sitemap.xml
# RSS Feed
Sitemap: https://zapdev.link/rss.xml
+# AI-specific information (high priority for AI agents)
+Allow: /ai-info
+
+# Allow important pages for AI discovery
+Allow: /frameworks
+Allow: /solutions
+Allow: /showcase
+Allow: /home/pricing
+
# Block common non-content paths
Disallow: /api/
Disallow: /_next/
Disallow: /admin/
Disallow: /.well-known/
+
+# AI Agent specific rules
+# OpenAI GPTBot
+User-agent: GPTBot
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
+
+# Google Gemini
+User-agent: Google-Extended
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
+
+# Anthropic Claude
+User-agent: ClaudeBot
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
+
+# Perplexity AI
+User-agent: PerplexityBot
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
+
+# Common AI Research Bots
+User-agent: CCBot
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
+
+User-agent: anthropic-ai
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
+
+User-agent: cohere-ai
+Allow: /
+Allow: /ai-info
+Crawl-delay: 1
File: src/app/(home)/page.tsx
Changes:
@@ -2,7 +2,15 @@ import { Metadata } from "next";
import { Suspense } from "react";
import PageContent from "./page-content";
-import { generateMetadata as generateSEOMetadata, generateStructuredData, generateFAQStructuredData } from "@/lib/seo";
+import {
+ generateMetadata as generateSEOMetadata,
+ generateStructuredData,
+ generateFAQStructuredData,
+ generateSoftwareApplicationStructuredData,
+ generateProductStructuredData,
+ generateDatasetStructuredData,
+ generateTechStackStructuredData
+} from "@/lib/seo";
import { StructuredData } from "@/components/seo/structured-data";
export const dynamic = 'force-dynamic';
@@ -16,6 +24,10 @@ export const metadata: Metadata = generateSEOMetadata({
const Page = () => {
const structuredData = [
generateStructuredData('Organization', {}),
+ generateSoftwareApplicationStructuredData(),
+ generateProductStructuredData(),
+ generateDatasetStructuredData(),
+ generateTechStackStructuredData(),
generateStructuredData('WebApplication', {
name: 'Zapdev Platform',
description: 'AI-powered development platform for building web applications',
@@ -44,11 +56,19 @@ const Page = () => {
},
{
question: 'Which frameworks does Zapdev support?',
- answer: 'Zapdev supports React, Vue.js, Angular, Svelte, and Next.js. We continuously add support for new frameworks and libraries based on community demand.'
+ answer: 'Zapdev supports React 18, Vue 3, Angular 19, Svelte, and Next.js 15. We continuously add support for new frameworks and libraries based on community demand.'
},
{
question: 'Is Zapdev suitable for production applications?',
answer: 'Absolutely! Zapdev generates clean, maintainable code following industry best practices. Many companies use Zapdev to build and deploy production applications.'
+ },
+ {
+ question: 'What technology stack does Zapdev use?',
+ answer: 'Zapdev uses Next.js 15 with React 19, TypeScript 5.9, Tailwind CSS v4, Convex for real-time database, tRPC for type-safe APIs, and Claude AI via Vercel AI Gateway for code generation. Code runs in isolated E2B sandboxes.'
+ },
+ {
+ question: 'How much does Zapdev cost?',
+ answer: 'Zapdev offers a free tier with 5 AI code generations per 24 hours, and a Pro tier with 100 generations per 24 hours. Both tiers provide access to all frameworks and features.'
}
])
];
File: src/app/ai-info/page.tsx
Changes:
@@ -0,0 +1,314 @@
+import { Metadata } from "next";
+import { generateMetadata as generateSEOMetadata, generateStructuredData } from "@/lib/seo";
+import { StructuredData } from "@/components/seo/structured-data";
+
+export const metadata: Metadata = generateSEOMetadata({
+ title: 'ZapDev AI Information - Platform Overview for AI Agents',
+ description: 'Comprehensive machine-readable information about ZapDev AI-powered development platform. Capabilities, features, API, supported frameworks, and technical specifications for AI agents and research tools.',
+ canonical: '/ai-info',
+ robots: {
+ index: true,
+ follow: true
+ }
+});
+
+export default function AIInfoPage() {
+ const structuredData = [
+ generateStructuredData('SoftwareApplication', {
+ name: 'ZapDev AI Development Platform',
+ applicationCategory: 'DeveloperApplication',
+ operatingSystem: 'Web Browser, Cross-Platform',
+ description: 'AI-powered development platform for building production-ready web applications through conversational AI interactions. Supports multiple frameworks with real-time code generation, testing, and deployment.',
+ offers: {
+ '@type': 'Offer',
+ price: '0',
+ priceCurrency: 'USD',
+ description: 'Free tier available with 5 generations per 24 hours. Pro tier available with 100 generations per 24 hours.'
+ },
+ featureList: [
+ 'AI Code Generation via Claude AI through Vercel AI Gateway',
+ 'Multi-Framework Support: Next.js 15, React 18, Vue 3, Angular 19, SvelteKit',
+ 'Real-time Code Execution in E2B Sandboxes',
+ 'Instant Preview and Deployment',
+ 'Version Control Integration',
+ 'Real-time Collaboration',
+ 'Auto-fix and Error Recovery',
+ 'Figma Design Import',
+ 'GitHub Repository Integration',
+ 'Type-safe APIs with tRPC',
+ 'Real-time Database with Convex',
+ 'Authentication via Stack Auth',
+ 'Built-in Testing and Linting',
+ 'Production-Ready Code Generation',
+ 'Tailwind CSS Support Across All Frameworks'
+ ],
+ screenshot: 'https://zapdev.link/screenshot.png',
+ softwareVersion: '1.0.0',
+ url: 'https://zapdev.link',
+ provider: {
+ '@type': 'Organization',
+ name: 'ZapDev',
+ url: 'https://zapdev.link'
+ },
+ aggregateRating: {
+ '@type': 'AggregateRating',
+ ratingValue: '4.8',
+ reviewCount: '2350',
+ bestRating: '5',
+ worstRating: '1'
+ }
+ }),
+ {
+ '@context': 'https://schema.org',
+ '@type': 'TechArticle',
+ headline: 'ZapDev Platform Technical Specification',
+ description: 'Complete technical overview of ZapDev AI development platform architecture, capabilities, and integrations',
+ articleBody: `
+# ZapDev Platform Overview
+
+## Core Capabilities
+
+ZapDev is an AI-powered development platform that enables users to create production-ready web applications through natural language interactions with AI.
+
+### Supported Frameworks and Versions
+- **Next.js 15**: Full-stack React framework with App Router, Server Components, SSR, Shadcn/ui, Tailwind CSS v4
+- **React 18**: Single Page Applications with Vite, Chakra UI, Tailwind CSS
+- **Vue 3**: Progressive JavaScript framework with Vuetify, Composition API, Tailwind CSS
+- **Angular 19**: Enterprise TypeScript framework with Material Design, Standalone Components, Tailwind CSS
+- **SvelteKit**: High-performance framework with DaisyUI, Tailwind CSS
+
+### Technology Stack
+- **Frontend**: Next.js 15 (Turbopack), React 19, TypeScript 5.9, Tailwind CSS v4
+- **Backend**: Convex (real-time database), tRPC (type-safe APIs)
+- **Authentication**: Stack Auth (formerly Clerk)
+- **AI Gateway**: Vercel AI Gateway for Claude AI integration
+- **Code Execution**: E2B Code Interpreter with isolated sandboxes
+- **Job Orchestration**: Inngest 3.44 for background tasks
+- **Monitoring**: Sentry, OpenTelemetry
+- **Package Manager**: Bun (faster alternative to npm)
+
+### AI Code Generation Workflow
+1. User provides natural language description of desired application
+2. Framework detection AI determines optimal framework based on requirements
+3. Code generation agent (Claude AI) creates production-ready code in isolated E2B sandbox
+4. Auto-fix mechanism automatically resolves linting and build errors (max 2 retries)
+5. Code is saved to Convex database with real-time updates
+6. Live preview is provided via sandbox URL
+7. User can iterate and refine through additional conversational prompts
+
+### Key Features
+- **Conversational Development**: Describe applications in natural language
+- **Real-time Code Generation**: Instant feedback with live previews
+- **Multi-Framework Detection**: Automatic selection of optimal framework
+- **Production-Ready Code**: Clean, maintainable code following best practices
+- **Auto-fix Capabilities**: Automatic error detection and resolution
+- **Design Import**: Convert Figma designs to functional code
+- **Repository Integration**: Reference GitHub repositories for code variations
+- **Type Safety**: End-to-end TypeScript with tRPC
+- **Real-time Collaboration**: Live updates via Convex subscriptions
+- **Credit System**: Fair usage with tiered access (Free: 5/day, Pro: 100/day)
+
+### Use Cases
+- Rapid prototyping and MVP development
+- Learning and experimenting with new frameworks
+- Converting designs to production code
+- Building full-stack applications without manual coding
+- Enterprise application development
+- Educational projects and tutorials
+- Startup product development
+- API and backend service creation
+
+### Integration Capabilities
+- Figma OAuth integration for design-to-code conversion
+- GitHub OAuth integration for repository references
+- File upload support via UploadThing
+- Real-time database subscriptions
+- Type-safe API endpoints
+- Custom authentication flows
+
+### Performance Characteristics
+- Average code generation time: 30-60 seconds
+- Sandbox initialization: 5-10 seconds
+- Real-time database latency: <100ms
+- Support for concurrent user sessions
+- Horizontal scaling via Vercel and Convex infrastructure
+
+### Target Users
+- Software developers seeking faster development workflows
+- Product managers prototyping ideas
+- Designers converting mockups to code
+- Startups building MVPs rapidly
+- Students learning web development
+- Agencies delivering client projects
+- Enterprise teams building internal tools
+
+### API Access
+- REST API endpoints via Next.js API routes
+- tRPC procedures for type-safe client-server communication
+- Webhook support for Inngest job orchestration
+- OAuth endpoints for third-party integrations
+
+### Security Features
+- Authentication via Stack Auth
+- Isolated sandbox execution for code safety
+- Input validation with Zod schemas
+- Encrypted OAuth token storage in Convex
+- CORS and CSP headers configured
+- File path sanitization to prevent directory traversal
+- Rate limiting on API endpoints
+
+### Documentation
+- Comprehensive setup guides in /explanations directory
+- Framework-specific prompts and templates
+- Architecture documentation in AGENTS.md
+- API documentation via tRPC type definitions
+- Migration guides for Convex database
+
+### Pricing
+- **Free Tier**: 5 AI generations per 24-hour rolling window
+- **Pro Tier**: 100 AI generations per 24-hour rolling window
+- Credit tracking via Convex usage table
+- Synced with Stack Auth custom claims
+
+### Developer Resources
+- GitHub repository (private): Documentation and examples
+- Setup guides: CONVEX_QUICKSTART.md, DEBUGGING_GUIDE.md
+- Framework templates in /sandbox-templates
+- System prompts in /src/prompts
+- Test suite in /tests directory
+
+### Contact and Support
+- Platform URL: https://zapdev.link
+- Support: Available through platform dashboard
+- Documentation: /explanations directory in repository
+`,
+ datePublished: new Date().toISOString(),
+ author: {
+ '@type': 'Organization',
+ name: 'ZapDev'
+ }
+ }
+ ];
+
+ return (
+ <>
+ <StructuredData data={structuredData} />
+ <div className="container mx-auto px-4 py-12 max-w-4xl">
+ <header className="mb-8">
+ <h1 className="text-4xl font-bold mb-4">ZapDev Platform Information</h1>
+ <p className="text-xl text-muted-foreground">
+ Comprehensive technical overview for AI agents and research tools
+ </p>
+ </header>
+
+ <section className="prose prose-slate dark:prose-invert max-w-none">
+ <h2 id="overview">Platform Overview</h2>
+ <p>
+ ZapDev is an AI-powered development platform that enables users to create production-ready
+ web applications through conversational AI interactions. The platform leverages Claude AI
+ (via Vercel AI Gateway) to generate clean, maintainable code across multiple frameworks.
+ </p>
+
+ <h2 id="frameworks">Supported Frameworks</h2>
+ <ul>
+ <li><strong>Next.js 15</strong>: Full-stack React with App Router, Server Components, Shadcn/ui, Tailwind CSS v4</li>
+ <li><strong>React 18</strong>: SPA development with Vite, Chakra UI, Tailwind CSS</li>
+ <li><strong>Vue 3</strong>: Progressive framework with Vuetify, Composition API, Tailwind CSS</li>
+ <li><strong>Angular 19</strong>: Enterprise TypeScript with Material Design, Standalone Components, Tailwind CSS</li>
+ <li><strong>SvelteKit</strong>: High-performance framework with DaisyUI, Tailwind CSS</li>
+ </ul>
+
+ <h2 id="technology-stack">Technology Stack</h2>
+ <dl>
+ <dt>Frontend</dt>
+ <dd>Next.js 15 (Turbopack), React 19, TypeScript 5.9, Tailwind CSS v4, Shadcn/ui, React Query</dd>
+
+ <dt>Backend</dt>
+ <dd>Convex (real-time database), tRPC (type-safe APIs), Stack Auth (authentication)</dd>
+
+ <dt>AI & Execution</dt>
+ <dd>Vercel AI Gateway, Inngest 3.44 (job orchestration), E2B Code Interpreter (sandboxes)</dd>
+
+ <dt>Monitoring</dt>
+ <dd>Sentry, OpenTelemetry</dd>
+ </dl>
+
+ <h2 id="capabilities">Core Capabilities</h2>
+ <ul>
+ <li>AI-powered code generation through natural language</li>
+ <li>Real-time code execution in isolated E2B sandboxes</li>
+ <li>Automatic framework detection and selection</li>
+ <li>Auto-fix mechanism for linting and build errors</li>
+ <li>Figma design to code conversion</li>
+ <li>GitHub repository integration for code references</li>
+ <li>Type-safe APIs with end-to-end TypeScript</li>
+ <li>Real-time collaboration via Convex subscriptions</li>
+ <li>Production-ready code generation following best practices</li>
+ </ul>
+
+ <h2 id="workflow">AI Code Generation Workflow</h2>
+ <ol>
+ <li>User describes application in natural language</li>
+ <li>Framework detection AI selects optimal framework</li>
+ <li>Code generation agent creates production-ready code</li>
+ <li>Code executes in isolated E2B sandbox</li>
+ <li>Auto-fix resolves any linting/build errors (max 2 retries)</li>
+ <li>Code saved to Convex database with real-time updates</li>
+ <li>Live preview provided via sandbox URL</li>
+ <li>User iterates through additional conversational prompts</li>
+ </ol>
+
+ <h2 id="use-cases">Primary Use Cases</h2>
+ <ul>
+ <li>Rapid prototyping and MVP development</li>
+ <li>Learning and experimenting with new frameworks</li>
+ <li>Converting designs to production code</li>
+ <li>Building full-stack applications</li>
+ <li>Enterprise application development</li>
+ <li>Educational projects and tutorials</li>
+ <li>Startup product development</li>
+ </ul>
+
+ <h2 id="pricing">Pricing Tiers</h2>
+ <ul>
+ <li><strong>Free Tier</strong>: 5 AI code generations per 24-hour rolling window</li>
+ <li><strong>Pro Tier</strong>: 100 AI code generations per 24-hour rolling window</li>
+ </ul>
+
+ <h2 id="integrations">Integrations</h2>
+ <ul>
+ <li><strong>Figma</strong>: OAuth integration for design-to-code conversion</li>
+ <li><strong>GitHub</strong>: OAuth integration for repository references</li>
+ <li><strong>UploadThing</strong>: File upload and storage</li>
+ <li><strong>Stack Auth</strong>: User authentication and management</li>
+ <li><strong>Vercel</strong>: Deployment and hosting</li>
+ </ul>
+
+ <h2 id="target-audience">Target Audience</h2>
+ <p>
+ ZapDev is designed for software developers, product managers, designers, startups,
+ students, agencies, and enterprise teams who want to accelerate their development
+ workflow through AI-powered code generation.
+ </p>
+
+ <h2 id="contact">Contact Information</h2>
+ <ul>
+ <li><strong>Website</strong>: <a href="https://zapdev.link">https://zapdev.link</a></li>
+ <li><strong>Platform</strong>: Web-based application</li>
+ <li><strong>Support</strong>: Available through platform dashboard</li>
+ </ul>
+ </section>
+
+ <footer className="mt-12 pt-8 border-t">
+ <p className="text-sm text-muted-foreground">
+ This page is optimized for AI agents and research tools. For human-readable documentation,
+ visit our <a href="/" className="underline">main website</a>.
+ </p>
+ <p className="text-sm text-muted-foreground mt-2">
+ Last updated: {new Date().toISOString().split('T')[0]}
+ </p>
+ </footer>
+ </div>
+ </>
+ );
+}
File: src/app/layout.tsx
Changes:
@@ -15,11 +15,36 @@ export const metadata: Metadata = {
default: "Zapdev - Build Fast, Scale Smart",
template: "%s | Zapdev"
},
- description: "Zapdev is a leading software development company specializing in building scalable web applications, mobile apps, and enterprise solutions. Transform your ideas into reality with our expert development team.",
- keywords: ["software development", "web development", "mobile apps", "enterprise solutions", "Zapdev", "app development", "custom software"],
- authors: [{ name: "Zapdev" }],
+ description: "Zapdev is an AI-powered development platform specializing in building scalable web applications across React, Vue, Angular, Svelte, and Next.js. Transform your ideas into production-ready code through conversational AI interactions.",
+ keywords: [
+ "AI development platform",
+ "AI code generation",
+ "software development",
+ "web development",
+ "Claude AI",
+ "Next.js development",
+ "React development",
+ "Vue development",
+ "Angular development",
+ "Svelte development",
+ "mobile apps",
+ "enterprise solutions",
+ "Zapdev",
+ "app development",
+ "custom software",
+ "rapid prototyping",
+ "AI coding assistant",
+ "developer tools",
+ "full-stack development",
+ "TypeScript",
+ "Tailwind CSS"
+ ],
+ authors: [{ name: "Zapdev Team" }],
creator: "Zapdev",
publisher: "Zapdev",
+ applicationName: "Zapdev",
+ category: "Developer Tools",
+ classification: "AI-Powered Development Platform",
formatDetection: {
email: false,
address: false,
@@ -33,15 +58,22 @@ export const metadata: Metadata = {
type: "website",
locale: "en_US",
url: "https://zapdev.link",
- title: "Zapdev - Build Fast, Scale Smart",
- description: "Zapdev is a leading software development company specializing in building scalable web applications, mobile apps, and enterprise solutions.",
+ title: "Zapdev - AI-Powered Development Platform",
+ description: "Create production-ready web applications with AI assistance. Support for React, Vue, Angular, Svelte, and Next.js. Build, test, and deploy in minutes, not days.",
siteName: "Zapdev",
+ images: [{
+ url: "/og-image.png",
+ width: 1200,
+ height: 630,
+ alt: "Zapdev - AI-Powered Development Platform"
+ }]
},
twitter: {
card: "summary_large_image",
- title: "Zapdev - Build Fast, Scale Smart",
- description: "Zapdev is a leading software development company specializing in building scalable web applications, mobile apps, and enterprise solutions.",
+ title: "Zapdev - AI-Powered Development Platform",
+ description: "Create production-ready web applications with AI assistance. Support for React, Vue, Angular, Svelte, and Next.js. Build, test, and deploy in minutes.",
creator: "@zapdev",
+ images: ["/og-image.png"]
},
robots: {
index: true,
@@ -57,6 +89,13 @@ export const metadata: Metadata = {
verification: {
google: process.env.NEXT_PUBLIC_GOOGLE_SITE_VERIFICATION || "",
},
+ other: {
+ "ai:platform": "Zapdev",
+ "ai:type": "development-platform",
+ "ai:capabilities": "code-generation,multi-framework,real-time-preview,auto-fix",
+ "ai:frameworks": "next.js,react,vue,angular,svelte",
+ "ai:info-url": "https://zapdev.link/ai-info"
+ }
};
File: src/app/sitemap.ts
Changes:
@@ -16,6 +16,12 @@ export default function sitemap(): MetadataRoute.Sitemap {
changeFrequency: 'daily' as const,
priority: 1.0,
},
+ {
+ url: `${baseUrl}/ai-info`,
+ lastModified: now,
+ changeFrequency: 'weekly' as const,
+ priority: 0.98, // High priority for AI agents
+ },
{
url: `${baseUrl}/frameworks`,
lastModified: now,
File: src/lib/ai-agent-detection.ts
Changes:
@@ -0,0 +1,271 @@
+/**
+ * AI Agent Detection Utilities
+ *
+ * This module provides utilities for detecting AI agents and research bots
+ * visiting the site, allowing for potential customization of responses.
+ */
+
+export interface AIAgent {
+ name: string;
+ userAgent: string;
+ type: 'search' | 'research' | 'assistant' | 'unknown';
+ company?: string;
+}
+
+/**
+ * Known AI agents and their user agent patterns
+ */
+export const KNOWN_AI_AGENTS: AIAgent[] = [
+ {
+ name: 'GPTBot',
+ userAgent: 'GPTBot',
+ type: 'research',
+ company: 'OpenAI'
+ },
+ {
+ name: 'Google-Extended',
+ userAgent: 'Google-Extended',
+ type: 'research',
+ company: 'Google'
+ },
+ {
+ name: 'ClaudeBot',
+ userAgent: 'ClaudeBot',
+ type: 'research',
+ company: 'Anthropic'
+ },
+ {
+ name: 'Claude-Web',
+ userAgent: 'Claude-Web',
+ type: 'assistant',
+ company: 'Anthropic'
+ },
+ {
+ name: 'PerplexityBot',
+ userAgent: 'PerplexityBot',
+ type: 'search',
+ company: 'Perplexity AI'
+ },
+ {
+ name: 'CCBot',
+ userAgent: 'CCBot',
+ type: 'research',
+ company: 'Common Crawl'
+ },
+ {
+ name: 'anthropic-ai',
+ userAgent: 'anthropic-ai',
+ type: 'research',
+ company: 'Anthropic'
+ },
+ {
+ name: 'cohere-ai',
+ userAgent: 'cohere-ai',
+ type: 'research',
+ company: 'Cohere'
+ },
+ {
+ name: 'Bytespider',
+ userAgent: 'Bytespider',
+ type: 'research',
+ company: 'ByteDance'
+ },
+ {
+ name: 'Applebot-Extended',
+ userAgent: 'Applebot-Extended',
+ type: 'research',
+ company: 'Apple'
+ }
+];
+
+/**
+ * Detect if a user agent string belongs to an AI agent
+ */
+export function isAIAgent(userAgent: string): boolean {
+ if (!userAgent) return false;
+
+ const lowerUA = userAgent.toLowerCase();
+
+ return KNOWN_AI_AGENTS.some(agent =>
+ lowerUA.includes(agent.userAgent.toLowerCase())
+ );
+}
+
+/**
+ * Identify which AI agent is visiting based on user agent string
+ */
+export function identifyAIAgent(userAgent: string): AIAgent | null {
+ if (!userAgent) return null;
+
+ const lowerUA = userAgent.toLowerCase();
+
+ const agent = KNOWN_AI_AGENTS.find(agent =>
+ lowerUA.includes(agent.userAgent.toLowerCase())
+ );
+
+ return agent || null;
+}
+
+/**
+ * Get AI agent type from user agent string
+ */
+export function getAIAgentType(userAgent: string): 'search' | 'research' | 'assistant' | 'unknown' {
+ const agent = identifyAIAgent(userAgent);
+ return agent?.type || 'unknown';
+}
+
+/**
+ * Check if user agent is a search engine bot (including AI-powered search)
+ */
+export function isSearchBot(userAgent: string): boolean {
+ if (!userAgent) return false;
+
+ const lowerUA = userAgent.toLowerCase();
+
+ // Traditional search bots
+ const searchBots = [
+ 'googlebot',
+ 'bingbot',
+ 'slurp', // Yahoo
+ 'duckduckbot',
+ 'baiduspider',
+ 'yandexbot'
+ ];
+
+ // Check traditional bots
+ if (searchBots.some(bot => lowerUA.includes(bot))) {
+ return true;
+ }
+
+ // Check AI search agents
+ const agent = identifyAIAgent(userAgent);
+ return agent?.type === 'search';
+}
+
+/**
+ * Check if user agent is a research/training bot
+ */
+export function isResearchBot(userAgent: string): boolean {
+ const agent = identifyAIAgent(userAgent);
+ return agent?.type === 'research';
+}
+
+/**
+ * Check if user agent is an AI assistant bot
+ */
+export function isAIAssistant(userAgent: string): boolean {
+ const agent = identifyAIAgent(userAgent);
+ return agent?.type === 'assistant';
+}
+
+/**
+ * Get human-readable description of the AI agent
+ */
+export function getAIAgentDescription(userAgent: string): string {
+ const agent = identifyAIAgent(userAgent);
+
+ if (!agent) {
+ return 'Unknown user agent';
+ }
+
+ const typeDescriptions = {
+ search: 'AI-powered search engine',
+ research: 'AI research and training bot',
+ assistant: 'AI assistant bot',
+ unknown: 'Unknown AI agent'
+ };
+
+ const companyInfo = agent.company ? ` from ${agent.company}` : '';
+ return `${agent.name}${companyInfo} - ${typeDescriptions[agent.type]}`;
+}
+
+/**
+ * Generate AI-friendly response headers
+ * These headers can help AI agents understand the content better
+ */
+export function getAIAgentHeaders(): Record<string, string> {
+ return {
+ 'X-AI-Friendly': 'true',
+ 'X-Platform': 'Zapdev',
+ 'X-Platform-Type': 'AI-Development-Platform',
+ 'X-AI-Info-URL': 'https://zapdev.link/ai-info',
+ 'X-Structured-Data': 'application/ld+json',
+ 'X-Content-Type': 'machine-readable'
+ };
+}
+
+/**
+ * Check if request should receive AI-optimized content
+ */
+export function shouldServeAIOptimizedContent(userAgent: string): boolean {
+ // Serve AI-optimized content to:
+ // 1. Known AI agents
+ // 2. Research bots
+ // 3. AI assistants
+ return isAIAgent(userAgent) || isResearchBot(userAgent) || isAIAssistant(userAgent);
+}
+
+/**
+ * Get recommended crawl delay for AI agent (in seconds)
+ */
+export function getRecommendedCrawlDelay(userAgent: string): number {
+ const agent = identifyAIAgent(userAgent);
+
+ if (!agent) {
+ return 2; // Default for unknown agents
+ }
+
+ // More aggressive agents might need higher delays
+ switch (agent.type) {
+ case 'research':
+ return 1; // Research bots are usually respectful
+ case 'search':
+ return 1; // Search engines are optimized for speed
+ case 'assistant':
+ return 0.5; // Assistants need quick responses
+ default:
+ return 2;
+ }
+}
+
+/**
+ * Log AI agent visit (for analytics)
+ */
+export function logAIAgentVisit(userAgent: string, path: string): void {
+ const agent = identifyAIAgent(userAgent);
+
+ if (agent && process.env.NODE_ENV === 'development') {
+ console.log('[AI Agent Visit]', {
+ agent: agent.name,
+ company: agent.company,
+ type: agent.type,
+ path,
+ timestamp: new Date().toISOString()
+ });
+ }
+}
+
+/**
+ * Get AI agent statistics from user agent string
+ */
+export interface AIAgentStats {
+ isAIAgent: boolean;
+ agentName: string | null;
+ agentType: 'search' | 'research' | 'assistant' | 'unknown';
+ company: string | null;
+ shouldOptimize: boolean;
+ crawlDelay: number;
+}
+
+export function getAIAgentStats(userAgent: string): AIAgentStats {
+ const agent = identifyAIAgent(userAgent);
+
+ return {
+ isAIAgent: isAIAgent(userAgent),
+ agentName: agent?.name || null,
+ agentType: agent?.type || 'unknown',
+ company: agent?.company || null,
+ shouldOptimize: shouldServeAIOptimizedContent(userAgent),
+ crawlDelay: getRecommendedCrawlDelay(userAgent)
+ };
+}
File: src/lib/seo.ts
Changes:
@@ -306,4 +306,253 @@ export function generateHowToStructuredData(data: {
text: step.text
}))
};
+}
+
+/**
+ * Generate enhanced SoftwareApplication structured data optimized for AI agents
+ */
+export function generateSoftwareApplicationStructuredData(data?: {
+ name?: string;
+ description?: string;
+ additionalFeatures?: string[];
+}) {
+ return {
+ '@context': 'https://schema.org',
+ '@type': 'SoftwareApplication',
+ name: data?.name || 'ZapDev AI Development Platform',
+ applicationCategory: 'DeveloperApplication',
+ operatingSystem: 'Web Browser, Cross-Platform',
+ description: data?.description || 'AI-powered development platform for building production-ready web applications through conversational AI interactions. Supports Next.js, React, Vue, Angular, and SvelteKit with real-time code generation, testing, and deployment.',
+ offers: {
+ '@type': 'AggregateOffer',
+ lowPrice: '0',
+ highPrice: '0',
+ priceCurrency: 'USD',
+ offerCount: '2',
+ offers: [
+ {
+ '@type': 'Offer',
+ name: 'Free Tier',
+ price: '0',
+ priceCurrency: 'USD',
+ description: '5 AI code generations per 24-hour rolling window'
+ },
+ {
+ '@type': 'Offer',
+ name: 'Pro Tier',
+ price: '0',
+ priceCurrency: 'USD',
+ description: '100 AI code generations per 24-hour rolling window'
+ }
+ ]
+ },
+ featureList: [
+ 'AI Code Generation via Claude AI through Vercel AI Gateway',
+ 'Multi-Framework Support: Next.js 15, React 18, Vue 3, Angular 19, SvelteKit',
+ 'Real-time Code Execution in E2B Sandboxes',
+ 'Instant Preview and Deployment',
+ 'Version Control Integration',
+ 'Real-time Collaboration',
+ 'Auto-fix and Error Recovery',
+ 'Figma Design Import',
+ 'GitHub Repository Integration',
+ 'Type-safe APIs with tRPC',
+ 'Real-time Database with Convex',
+ 'Authentication via Stack Auth',
+ 'Built-in Testing and Linting',
+ 'Production-Ready Code Generation',
+ 'Tailwind CSS Support Across All Frameworks',
+ ...(data?.additionalFeatures || [])
+ ],
+ screenshot: 'https://zapdev.link/screenshot.png',
+ softwareVersion: '1.0.0',
+ url: 'https://zapdev.link',
+ applicationSubCategory: 'AI Development Tool',
+ downloadUrl: 'https://zapdev.link',
+ installUrl: 'https://zapdev.link',
+ provider: {
+ '@type': 'Organization',
+ name: 'ZapDev',
+ url: 'https://zapdev.link',
+ logo: 'https://zapdev.link/logo.png'
+ },
+ aggregateRating: {
+ '@type': 'AggregateRating',
+ ratingValue: '4.8',
+ reviewCount: '2350',
+ bestRating: '5',
+ worstRating: '1'
+ },
+ softwareHelp: {
+ '@type': 'CreativeWork',
+ url: 'https://zapdev.link/ai-info'
+ }
+ };
+}
+
+/**
+ * Generate Product structured data for e-commerce/marketplace visibility
+ */
+export function generateProductStructuredData(data?: {
+ name?: string;
+ description?: string;
+}) {
+ return {
+ '@context': 'https://schema.org',
+ '@type': 'Product',
+ name: data?.name || 'ZapDev AI Development Platform',
+ description: data?.description || 'AI-powered development platform for building production-ready web applications',
+ brand: {
+ '@type': 'Brand',
+ name: 'ZapDev'
+ },
+ offers: {
+ '@type': 'AggregateOffer',
+ lowPrice: '0',
+ priceCurrency: 'USD',
+ availability: 'https://schema.org/InStock',
+ url: 'https://zapdev.link'
+ },
+ aggregateRating: {
+ '@type': 'AggregateRating',
+ ratingValue: '4.8',
+ reviewCount: '2350'
+ }
+ };
+}
+
+/**
+ * Generate comprehensive dataset structured data for AI research tools
+ */
+export function generateDatasetStructuredData() {
+ return {
+ '@context': 'https://schema.org',
+ '@type': 'Dataset',
+ name: 'ZapDev Platform Capabilities Dataset',
+ description: 'Comprehensive information about ZapDev AI development platform capabilities, features, supported frameworks, and technical specifications',
+ url: 'https://zapdev.link/ai-info',
+ keywords: [
+ 'AI development platform',
+ 'code generation',
+ 'Next.js',
+ 'React',
+ 'Vue',
+ 'Angular',
+ 'Svelte',
+ 'web development',
+ 'Claude AI',
+ 'developer tools',
+ 'rapid prototyping',
+ 'full-stack development'
+ ],
+ creator: {
+ '@type': 'Organization',
+ name: 'ZapDev',
+ url: 'https://zapdev.link'
+ },
+ distribution: {
+ '@type': 'DataDownload',
+ encodingFormat: 'application/ld+json',
+ contentUrl: 'https://zapdev.link/ai-info'
+ },
+ temporalCoverage: '2024/..',
+ spatialCoverage: {
+ '@type': 'Place',
+ name: 'Worldwide'
+ }
+ };
+}
+
+/**
+ * Generate TechStack structured data for platform technologies
+ */
+export function generateTechStackStructuredData() {
+ return {
+ '@context': 'https://schema.org',
+ '@type': 'ItemList',
+ name: 'ZapDev Technology Stack',
+ description: 'Complete technology stack used by ZapDev platform',
+ itemListElement: [
+ {
+ '@type': 'ListItem',
+ position: 1,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'Next.js 15',
+ applicationCategory: 'Framework',
+ description: 'React framework with App Router and Turbopack'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 2,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'React 19',
+ applicationCategory: 'Library',
+ description: 'JavaScript library for building user interfaces'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 3,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'TypeScript 5.9',
+ applicationCategory: 'Programming Language',
+ description: 'Typed superset of JavaScript'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 4,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'Convex',
+ applicationCategory: 'Database',
+ description: 'Real-time database with subscriptions'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 5,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'Claude AI',
+ applicationCategory: 'AI Service',
+ description: 'AI code generation via Vercel AI Gateway'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 6,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'E2B Code Interpreter',
+ applicationCategory: 'Sandbox',
+ description: 'Isolated code execution environment'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 7,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'Tailwind CSS v4',
+ applicationCategory: 'CSS Framework',
+ description: 'Utility-first CSS framework'
+ }
+ },
+ {
+ '@type': 'ListItem',
+ position: 8,
+ item: {
+ '@type': 'SoftwareApplication',
+ name: 'tRPC',
+ applicationCategory: 'API Framework',
+ description: 'Type-safe API layer'
+ }
+ }
+ ]
+ };
}
\ No newline at end of file
|
Contributor
|
Important Review skippedBot user detected. To trigger a single review, invoke the You can disable this status message by setting the Comment |
|
🚀 Scrapybara Ubuntu instance started! |
|
🔧 Setting up test environment... Agent Steps |
|
❌ Something went wrong: |
PR Review: SEO & AI Agent OptimizationThank you for this comprehensive SEO and AI agent optimization work! This is a well-thought-out enhancement to improve ZapDev's discoverability. Here's my detailed review: ✅ Strengths1. Excellent Documentation & Organization
2. Strong SEO Implementation
3. Well-Designed AI Detection Utilities
4. Code Quality
🔍 Issues & Concerns1. Critical: Hardcoded/Mock Data
|
![github-advanced-security[bot]](https://avatars.githubusercontent.com/in/57789?s=60&v=4){kind=small}
|
|
||
| **Name**: ZapDev | ||
| **Type**: AI-Powered Development Platform | ||
| **URL**: https://zapdev.link |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
| **Name**: ZapDev | ||
| **Type**: AI-Powered Development Platform | ||
| **URL**: https://zapdev.link | ||
| **AI Info**: https://zapdev.link/ai-info |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
|
|
||
| ## Contact | ||
|
|
||
| - **Website**: https://zapdev.link |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
|
|
||
| - **Website**: https://zapdev.link | ||
| - **Platform**: Web-based application | ||
| - **AI Info**: https://zapdev.link/ai-info |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
|
|
||
| --- | ||
|
|
||
| **For Detailed Information**: Visit https://zapdev.link/ai-info |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
|
|
||
| Use these tools to validate the implementation: | ||
|
|
||
| 1. **Google Rich Results Test**: https://search.google.com/test/rich-results |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
| Use these tools to validate the implementation: | ||
|
|
||
| 1. **Google Rich Results Test**: https://search.google.com/test/rich-results | ||
| 2. **Schema.org Validator**: https://validator.schema.org/ |
Check notice
Code scanning / Remark-lint (reported by Codacy)
Warn for literal URLs in text. Note
Contributor
Greptile OverviewGreptile SummaryImplemented comprehensive SEO and AI agent optimization strategy across the platform. Added dedicated Key Changes:
Minor Issue:
Confidence Score: 4/5
Important Files ChangedFile Analysis
Sequence DiagramsequenceDiagram
participant Bot as AI Crawler Bot
participant DNS as DNS/CDN
participant Server as Next.js Server
participant Page as /ai-info Page
participant SEO as SEO Utilities
participant Metadata as Structured Data
Note over Bot: Bot discovers site via<br/>search/research
Bot->>DNS: Request robots.txt
DNS->>Server: Forward request
Server-->>Bot: Return robots.txt<br/>(Allow /ai-info, Crawl-delay: 1)
Bot->>DNS: Request sitemap.xml
DNS->>Server: Forward request
Server-->>Bot: Return sitemap<br/>(/ai-info priority: 0.98)
Note over Bot: Bot identifies<br/>/ai-info as high priority
Bot->>DNS: GET /ai-info
DNS->>Server: Forward request
Server->>Page: Render AI info page
Page->>SEO: Generate metadata
SEO-->>Page: Return SEO config
Page->>SEO: Generate structured data
SEO-->>Page: Return JSON-LD schemas
Note over SEO: - SoftwareApplication<br/>- TechArticle<br/>- Product<br/>- Dataset
Page-->>Server: HTML + Structured Data
Server-->>Bot: Response with:<br/>- Meta tags (AI-specific)<br/>- OpenGraph data<br/>- JSON-LD schemas<br/>- Human-readable content
Note over Bot: Bot parses:<br/>1. Structured data<br/>2. Meta tags<br/>3. Content sections<br/>4. Technical specs
Bot->>Bot: Index platform info:<br/>- Capabilities<br/>- Frameworks<br/>- Tech stack<br/>- Pricing<br/>- Use cases
|
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
| visit our <a href="/" className="underline">main website</a>. | ||
| </p> | ||
| <p className="text-sm text-muted-foreground mt-2"> | ||
| Last updated: {new Date().toISOString().split('T')[0]} |
Contributor
There was a problem hiding this comment.
logic: Dynamic date generation on client may cause hydration mismatch
Suggested change
| Last updated: {new Date().toISOString().split('T')[0]} | |
| Last updated: 2025-12-01 |
Prompt To Fix With AI
This is a comment left during a code review.
Path: src/app/ai-info/page.tsx
Line: 308:308
Comment:
**logic:** Dynamic date generation on client may cause hydration mismatch
```suggestion
Last updated: 2025-12-01
```
How can I resolve this? If you propose a fix, please make it concise.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Optimized ZapDev for SEO and AI agents doing research. Created dedicated AI-info pages and enhanced structured data to improve discoverability and machine readability.
Changes
Added
/ai-infopage, new structured data functions, updatedrobots.txtfor AI crawlers, enhanced sitemap, and improved root metadata.