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

11 KiB

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:

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:

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:

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:

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:

Blog Series:

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.