IMPLEMENTATION_PLAN.md

aeo.js Implementation Plan

Core Architecture Setup

• Package.json with exports map
• tsup.config.ts for multi-entry bundling
• vitest.config.ts for testing

Core Generators (src/core/)

• detect.ts - Framework auto-detection
• utils.ts - Utilities and config resolution
• robots.ts - robots.txt with AI crawlers
• llms-txt.ts - llms.txt summary
• llms-full.ts - llms-full.txt concatenated
• raw-markdown.ts - Markdown file copying
• manifest.ts - docs.json manifest
• sitemap.ts - sitemap.xml
• ai-index.ts - ai-index.json RAG-optimized
• generate.ts - Main orchestrator

Widget Implementation (src/widget/)

• core.ts - Vanilla JS widget class
• styles.ts - CSS-in-JS styling
• icons.ts - SVG icons as strings
• extract.ts - DOM-to-markdown fallback
• react.tsx - React wrapper component
• vue.ts - Vue 3 wrapper
• svelte.ts - Svelte wrapper

Plugin Integrations (src/plugins/)

• vite.ts - Vite plugin
• next.ts - Next.js withAeo wrapper
• webpack.ts - Standalone webpack plugin
• astro.ts - Astro integration
• nuxt.ts - Nuxt module

Testing

• Core generator tests
• Widget functionality tests

Documentation

• Website scaffolding (Docusaurus)
• Usage examples
• API documentation