nx/tools/nx-ai-landing-page-copy.md
Juri Strumpflohner 873f2d8046
feat(nx-dev): AI landing page (#31310)
adds a new AI landing page at `/ai`
2025-05-23 10:52:51 -04:00

288 lines
11 KiB
Markdown

# Nx AI Landing Page: Content Strategy & Structure
## Executive Summary
Based on the analysis of Nx's AI blog series and existing landing pages, here's a comprehensive strategy for an AI-focused landing page that positions Nx as the essential foundation for AI-powered development in monorepos.
## Page Structure & Content Strategy
### Hero Section
**Primary Headline:** "Make Your AI Assistant 10x Smarter"
**Sub-headline:** "Integrate Nx's workspace intelligence directly into your existing AI assistant through MCP - transforming basic code helpers into architecturally-aware development partners."
**Primary CTA:** "Enhance Your AI Assistant"
**Secondary CTA:** "Watch 3-min Demo"
### Problem Statement Section
**Headline:** "Why Your AI Assistant Struggles with Enterprise Codebases"
**Four Core Problems:**
1. **Limited Context** - LLMs only see individual files, missing architectural relationships. As monorepos grow larger, this problem compounds dramatically, requiring developers to manually provide context for every interaction.
2. **Inconsistent Output** - AI generates code that doesn't follow your team's best practices and may introduce breaking changes by deprecating components it doesn't see being used elsewhere in the codebase.
3. **No Workspace Awareness** - Can't understand project dependencies, ownership, or integration points, making it difficult for AI to know where to start when fixing issues across multiple projects.
4. **Manual Context Burden** - Developers must constantly provide the same contextual information about project structure, relationships, and interdependencies, negating much of the productivity gains AI promises.
**Visual:** Diagram showing LLM with limited "street view" vs. Nx providing "map view" of codebase, with callouts showing the increasing context burden as repository size grows.
**Additional Callout Box:**
"As monorepos scale, AI tools become progressively less effective - a challenge that only architectural intelligence can solve. While type safety provides some guardrails, it's not enough without true workspace understanding."
### Solution Overview Section
**Headline:** "Nx Provides the Missing Context Your AI Needs"
**Core Value Props:**
1. **Architectural Awareness** - Move from file-level to workspace-level understanding
2. **Predictable + Intelligent** - Combine consistent generators with AI customization
3. **Integrated Workflows** - Connect editor, CI, and AI for seamless development
### Features Deep Dive
#### 1. Workspace Intelligence
**Headline:** "Elevate Your AI from File-Level to Architecture-Level Understanding"
**Content:**
- Project relationship mapping
- Dependency analysis and impact assessment
- Team ownership and responsibility identification
- Technology stack and configuration understanding
**Demo:** "Ask your AI: 'If I change the API of this library, which teams need to know?'"
**Resources:**
- 📹 [Watch: Nx Just Made Your LLM Way Smarter](https://youtu.be/RNilYmJJzdk)
- 📖 [Blog: Nx Just Made Your LLM Way Smarter](/blog/nx-just-made-your-llm-smarter)
#### 2. CI Integration & Failure Resolution
**Headline:** "Fix CI Issues Before You Even Know They Exist"
**Content:**
- Real-time CI failure notifications in your editor
- AI-powered failure analysis and suggested fixes
- Access to detailed Nx Cloud pipeline data
- Automated resolution suggestions
**Demo:** "Get notified of CI failures and let AI suggest the fix"
**Resources:**
- 📹 [Watch: Connect Your Editor, CI and LLMs](https://youtu.be/fPqPh4h8RJg)
- 📖 [Blog: Save Time: Connecting Your Editor, CI and LLMs](/blog/nx-editor-ci-llm-integration)
#### 3. Terminal Integration & Live Assistance
**Headline:** "Your AI Assistant Sees What You See in the Terminal"
**Content:**
- Real-time terminal output awareness
- Live task execution monitoring
- Contextual error analysis and fixes
- No more copy-pasting terminal errors
**Demo:** "Run a task that fails, and AI immediately offers solutions based on the actual error output"
**Resources:**
- 📖 Blog post coming soon
#### 4. Smart Code Generation
**Headline:** "Predictable Generators + AI Intelligence"
**Content:**
- Nx generators provide consistent, tested scaffolding
- AI adds contextual customization and integration
- Human-in-the-loop workflow for quality control
- Workspace-aware code integration
**Demo:** "Generate a new library and automatically connect it to existing projects"
**Resources:**
- 📹 [Watch: Enhancing Nx Generators with AI](https://youtu.be/PXNjedYhZDs)
- 📖 [Blog: Combining Predictability and Intelligence With Nx Generators and AI](/blog/nx-generators-ai-integration)
#### 5. Documentation-Aware Assistance
**Headline:** "Always Up-to-Date, Never Hallucinating"
**Content:**
- Live access to current Nx documentation
- Context-aware configuration guidance
- Best practices enforcement
- Migration assistance
**Resources:**
- 📹 [Watch: Making Cursor Smarter with MCP](https://youtu.be/V2W94Sq_v6A)
- 📖 [Blog: Making Cursor Smarter with an MCP Server For Nx](/blog/nx-made-cursor-smarter)
### Technical Implementation Section
**Headline:** "Powered by Nx's Rich Workspace Intelligence"
**Content:**
Nx already maintains comprehensive metadata about your workspace to optimize builds, manage dependencies, and enforce architectural boundaries. The Nx daemon continuously monitors your workspace, tracking project relationships and updates in real-time to keep this intelligence current and accurate.
**How It Works:**
- Nx daemon runs in the background, maintaining up-to-date workspace metadata
- This rich contextual data is processed and optimized for AI consumption
- Intelligence is exposed through the Model Context Protocol (MCP)
- Integrates seamlessly into your existing AI assistant workflows
**The key advantage:** Rather than building something entirely new, this enhances the AI tools you already use and trust, making your existing collaboration with LLMs significantly more powerful and context-aware.
**Integration Options:**
- **Nx Console Extension**: Available for VSCode, Cursor, and IntelliJ
- **Pure MCP Server**: Works with any MCP-compatible client (Claude Desktop, Cline, Windsurf, etc.)
- **Existing Workflow**: Enhances your current AI assistant without changing your development habits
### Use Cases & Examples
#### Enterprise Developer
**Scenario:** "Understanding impact of API changes across 50+ projects in a large workspace"
**Solution:** AI uses project graph to identify all affected teams and suggests migration strategy
#### New Team Member
**Scenario:** "Getting up to speed on complex multi-project architecture"
**Solution:** AI explains project relationships, ownership, and where to implement features
#### DevOps Engineer
**Scenario:** "Optimizing CI/CD pipeline performance across multiple related projects"
**Solution:** AI analyzes Nx Cloud data to suggest task distribution and caching improvements
### Competitive Differentiation
**Headline:** "Why Large Workspaces Are AI Future-Proof"
**Key Points:**
1. **Complete Context** - All related projects in one workspace vs. scattered repositories
2. **Rich Metadata** - Nx's architectural understanding vs. basic file access
3. **Predictable Patterns** - Consistent generators vs. variable AI output
4. **Integrated Tooling** - Connected workflow vs. isolated tools
### Social Proof Section
**Headline:** "Join Forward-Thinking Teams Already Using AI-Enhanced Nx"
**Featured Testimonials:**
- Focus on teams using AI + Nx successfully
- Metrics: reduced onboarding time, faster feature delivery
- Use existing customer logos where applicable
### Getting Started Section
**Headline:** "Transform Your AI Assistant in Minutes"
**Three Steps:**
1. **Install Nx Console** - Available for VSCode, Cursor, IntelliJ
2. **Enable MCP Integration** - One-click setup
3. **Start Asking Better Questions** - AI now understands your workspace
**Technical Requirements:**
- Existing Nx workspace or `nx init` for new setup
- Compatible AI assistant (Copilot, Claude, etc.)
- Nx Console extension
### Resources & Next Steps
**Featured Content:**
- 📹 [Nx Just Made Your LLM Way Smarter](https://youtu.be/RNilYmJJzdk) - Foundation overview
- 📹 [Why Nx and AI Work So Well Together](https://youtu.be/[video-url]) - Strategic perspective
- 📹 [Making Cursor Smarter with MCP](https://youtu.be/V2W94Sq_v6A) - Cursor setup guide
- 📹 [Nx MCP for VS Code Copilot](https://youtu.be/dRQq_B1HSLA) - VSCode setup guide
- 📹 [Enhancing Nx Generators with AI](https://youtu.be/PXNjedYhZDs) - Smart generation workflow
**Blog Series:**
- 📖 [Nx Just Made Your LLM Way Smarter](/blog/nx-just-made-your-llm-smarter) (foundational post)
- 📖 [Making Cursor Smarter with an MCP Server](/blog/nx-made-cursor-smarter) (Cursor integration)
- 📖 [Nx MCP Now Available for VS Code Copilot](/blog/nx-mcp-vscode-copilot) (VSCode integration)
- 📖 [Nx and AI: Why They Work so Well Together](/blog/nx-and-ai-why-they-work-together) (strategic overview)
- 📖 [Combining Predictability and Intelligence With Nx Generators and AI](/blog/nx-generators-ai-integration) (generator workflow)
**Additional Resources:**
- Live demo videos
- Documentation links
- Community Discord for questions
- Blog series for deep dives
## Page Optimization Strategy
### SEO Keywords
**Primary:** "AI workspace development", "LLM code assistant", "Nx AI integration", "multi-project AI tools"
**Secondary:** "enterprise AI development", "intelligent code generation", "MCP server", "workspace AI tools"
### Conversion Optimization
1. **Multiple entry points** - Different CTAs for different user types
2. **Progressive disclosure** - Start with benefits, dive into technical details
3. **Social proof throughout** - Testimonials and usage stats
4. **Risk reduction** - Free trial, easy setup, existing workspace compatibility
### Developer-Focused Messaging
- Technical accuracy and specificity
- Real code examples and demos
- Focus on productivity gains and workflow improvements
- Emphasis on maintaining control and predictability
## Content Tone & Voice
**Technical but Accessible:** Explain complex concepts clearly without dumbing down
**Benefit-Focused:** Lead with outcomes, support with features
**Confident but Not Overhyped:** Realistic about current capabilities while showing vision
**Developer-to-Developer:** Written by and for engineers who understand the pain points
## Success Metrics
### Primary KPIs
- Nx Console downloads/installs
- MCP server configurations
- AI-related feature adoption
- Time-to-first-AI-query in workspace
### Secondary KPIs
- Page engagement time
- Video completion rates
- Documentation page visits from AI landing page
- Community Discord joins related to AI features
## Implementation Recommendations
1. **Start with Core Message Testing** - A/B test hero section messaging
2. **Progressive Rollout** - Begin with essential features, add advanced use cases
3. **Continuous Content Updates** - Regular examples and case studies as features evolve
4. **Community Feedback Loop** - Use Discord and GitHub discussions to refine messaging
This landing page strategy positions Nx as the essential infrastructure for AI-powered development, focusing on the unique value of architectural awareness and workspace intelligence that generic AI tools simply cannot provide.