feat: add farcaster section to docs

core-concepts/plugins.mdx

@@ -36,7 +36,7 @@ export const myPlugin: Plugin = {
 
 ## Core Plugin: Bootstrap
 
-Every agent includes `@elizaos/plugin-bootstrap` which provides essential functionality for message handling, knowledge management, and basic agent operations. For detailed information, see the [Bootstrap Plugin Deep Dive](/plugins/bootstrap/complete-documentation).
+Every agent includes `@elizaos/plugin-bootstrap` which provides essential functionality for message handling, knowledge management, and basic agent operations. For detailed information, see the [Bootstrap Plugin Deep Dive](/plugins/bootstrap/complete-documentation.mdx).
 
 ## Platform Plugins
 

docs.json

@@ -327,6 +327,16 @@
                   "plugins/platform/twitter/examples",
                   "plugins/platform/twitter/testing-guide"
                 ]
+              },
+              {
+                "group": "Farcaster",
+                "pages": [
+                  "plugins/platform/farcaster",
+                  "plugins/platform/farcaster/developer-guide",
+                  "plugins/platform/farcaster/cast-flow",
+                  "plugins/platform/farcaster/examples",
+                  "plugins/platform/farcaster/testing-guide"
+                ]
               }
             ]
           },

guides/plugin-migration/advanced-migration-guide.mdx

@@ -4,7 +4,7 @@ description: "Advanced breaking changes for evaluators, services, and runtime me
 icon: "code"
 ---
 
-> **Important**: This guide covers advanced breaking changes for evaluators, services, and runtime methods. Read the main [migration guide](./migration-guide) first for actions, providers, and basic migrations.
+> **Important**: This guide covers advanced breaking changes for evaluators, services, and runtime methods. Read the main [migration guide](./migration-guide.mdx) first for actions, providers, and basic migrations.
 
 ## Table of Contents
 
@@ -458,6 +458,6 @@ class MyClient extends Service {
 
 If you encounter issues not covered in this guide:
 
-1. Check the main [migration guide](./migration-guide) for basic migrations
+1. Check the main [migration guide](./migration-guide.mdx) for basic migrations
 2. Review the v1.x examples in the elizaOS repository for reference implementations
 3. Join our Discord community for support

guides/plugin-migration/overview.mdx

@@ -10,7 +10,7 @@ This comprehensive guide will walk you through migrating your elizaOS plugins fr
 
 Follow these guides in order for a smooth migration:
 
-### 1. [Migration Overview](./migration-guide)
+### 1. [Migration Overview](./migration-guide.mdx)
 Start here! This guide covers:
 - Key differences between 0.x and 1.x
 - Breaking changes and new features
@@ -130,4 +130,4 @@ The 1.x architecture brings:
 - **Better performance** - Optimized runtime execution
 - **Stronger typing** - Catch errors at compile time
 
-Start with the [Migration Overview](./migration-guide) and work through each guide systematically for the best results! 
+Start with the [Migration Overview](./migration-guide.mdx) and work through each guide systematically for the best results! 

plugins/bootstrap.mdx

@@ -10,16 +10,16 @@ Welcome to the comprehensive documentation for the `@elizaos/plugin-bootstrap` p
 
 ### Core Documentation
 
-- **[Complete Developer Documentation](/plugins/bootstrap/complete-documentation)**  
+- **[Complete Developer Documentation](/plugins/bootstrap/complete-documentation.mdx)**  
   Comprehensive guide covering all components, architecture, and implementation details
 
-- **[Message Flow Diagram](/plugins/bootstrap/message-flow)**  
+- **[Message Flow Diagram](/plugins/bootstrap/message-flow.mdx)**  
   Step-by-step breakdown of how messages flow through the system with visual diagrams
 
-- **[Examples & Recipes](/plugins/bootstrap/examples)**  
+- **[Examples & Recipes](/plugins/bootstrap/examples.mdx)**  
   Practical examples, code snippets, and real-world implementations
 
-- **[Testing Guide](/plugins/bootstrap/testing-guide)**  
+- **[Testing Guide](/plugins/bootstrap/testing-guide.mdx)**  
   Testing patterns, best practices, and comprehensive test examples
 
 

plugins/defi/evm.mdx

@@ -142,7 +142,7 @@ The plugin includes comprehensive error handling for common scenarios:
 
 ## Next Steps
 
-- [Complete Documentation →](./evm/complete-documentation)
-- [DeFi Operations Flow →](./evm/defi-operations-flow)
-- [Examples →](./evm/examples)
-- [Testing Guide →](./evm/testing-guide)
+- [Complete Documentation →](./evm/complete-documentation.mdx)
+- [DeFi Operations Flow →](./evm/defi-operations-flow.mdx)
+- [Examples →](./evm/examples.mdx)
+- [Testing Guide →](./evm/testing-guide.mdx)

plugins/defi/solana.mdx

@@ -162,6 +162,6 @@ The plugin includes robust error handling for:
 ## Next Steps
 
 - [Complete Documentation →](./solana/complete-documentation.mdx)
-- [DeFi Operations Flow →](./solana/defi-operations-flow)
-- [Examples →](./solana/examples)
-- [Testing Guide →](./solana/testing-guide)
+- [DeFi Operations Flow →](./solana/defi-operations-flow.mdx)
+- [Examples →](./solana/examples.mdx)
+- [Testing Guide →](./solana/testing-guide.mdx)

plugins/llm.mdx

@@ -232,14 +232,14 @@ You can also configure API keys per character:
 
 ### Cloud Providers
 
-- [OpenAI Plugin](./openai) - Full-featured with all model types
-- [Anthropic Plugin](./anthropic) - Claude models for text generation
-- [Google GenAI Plugin](./google-genai) - Gemini models
-- [OpenRouter Plugin](./openrouter) - Access to multiple providers
+- [OpenAI Plugin](./openai.mdx) - Full-featured with all model types
+- [Anthropic Plugin](./anthropic.mdx) - Claude models for text generation
+- [Google GenAI Plugin](./google-genai.mdx) - Gemini models
+- [OpenRouter Plugin](./openrouter.mdx) - Access to multiple providers
 
 ### Local/Self-Hosted
 
-- [Ollama Plugin](./ollama) - Run models locally with Ollama
+- [Ollama Plugin](./ollama.mdx) - Run models locally with Ollama
 
 ## Best Practices
 

plugins/overview.mdx

@@ -44,7 +44,7 @@ Blockchain and DeFi integrations for Web3 functionality:
 
 Connect your agent to popular platforms:
 
-<CardGroup cols={3}>
+<CardGroup cols={2}>
   <Card title="Discord" icon="discord" href="/plugins/platform/discord">
     Full Discord integration with voice, commands, and rich interactions.
   </Card>
@@ -56,6 +56,10 @@ Connect your agent to popular platforms:
   <Card title="Twitter" icon="twitter" href="/plugins/platform/twitter">
     Twitter/X integration for posting, replying, and timeline management.
   </Card>
+
+  <Card title="Farcaster" icon="/images/icons/farcaster.svg" href="/plugins/platform/farcaster">
+    Farcaster social network integration with casting and engagement.
+  </Card>
 </CardGroup>
 
 ## LLM Providers

plugins/platform/farcaster.mdx

@@ -0,0 +1,29 @@
+---
+title: "Farcaster Integration"
+description: "Welcome to the comprehensive documentation for the @elizaos/plugin-farcaster package. This index provides organized access to all documentation resources."
+---
+
+
+The @elizaos/plugin-farcaster enables your elizaOS agent to interact with the Farcaster social network through casting, replying, and engaging with the decentralized social protocol.
+
+## 📚 Documentation
+
+- **[Developer Guide](./farcaster/developer-guide.mdx)** - Detailed technical reference
+- **[Cast Flow](./farcaster/cast-flow.mdx)** - Visual guide to cast processing
+- **[Examples](./farcaster/examples.mdx)** - Practical implementation examples
+- **[Testing Guide](./farcaster/testing-guide.mdx)** - Testing strategies and patterns
+
+## 🔧 Configuration
+
+### Required Settings
+- `FARCASTER_NEYNAR_API_KEY` - Neynar API key for authentication
+- `FARCASTER_SIGNER_UUID` - Neynar signer UUID for your account
+- `FARCASTER_FID` - Your Farcaster ID (FID)
+
+### Optional Settings
+- `ENABLE_CAST` - Enable autonomous casting (default: true)
+- `ENABLE_ACTION_PROCESSING` - Enable processing interactions (default: false)
+- `FARCASTER_DRY_RUN` - Test mode without posting (default: false)
+- `CAST_INTERVAL_MIN` - Minimum interval between casts in minutes (default: 90)
+- `CAST_INTERVAL_MAX` - Maximum interval between casts in minutes (default: 180)
+- `ACTION_TIMELINE_TYPE` - Type of timeline to use for actions (default: ForYou)