docs: add Context7 configuration for gh-pages indexing

Add context7.json to configure Context7 to index documentation
from the gh-pages branch at versions/latest/markdown-docs/.

Configuration includes:
- Branch targeting: gh-pages (where docs are published)
- Folder specification: versions/latest/markdown-docs
- Exclusions: build artifacts, assets, and styles
- 14 usage rules covering web component patterns, installation,
  TypeScript support, theming, and common gotchas

This enables LLM-based tools to access accurate, version-specific
documentation for Lime Elements components.

Author: adrianschmidt

README.md

@@ -173,6 +173,23 @@ npm start  # Starts local development server
 
 ---
 
+## AI-Friendly Documentation
+
+Lime Elements generates Context7-compatible markdown documentation to help AI coding assistants and LLMs better understand and use our component library. This documentation is automatically published with each release and includes:
+
+- 📄 **Component API docs** - Detailed markdown documentation for all components
+- 📚 **Design guidelines** - Best practices and usage patterns
+- 🎯 **Usage rules** - Context7 rules for proper component usage
+- 🔗 **Navigation index** - Searchable overview of all components and guides
+
+The documentation is available at:
+- **Latest version:** [lundalogik.github.io/lime-elements/versions/latest/markdown-docs/](https://lundalogik.github.io/lime-elements/versions/latest/markdown-docs/)
+- **Configuration:** [context7.json](https://github.com/Lundalogik/lime-elements/blob/main/context7.json)
+
+This makes Lime Elements easier to work with when using AI pair programming tools like GitHub Copilot, Cursor, or Claude Code.
+
+---
+
 ## 📄 License
 
 Lime Elements is open source software licensed under the [Apache 2.0 License](https://opensource.org/licenses/Apache-2.0).

context7.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://context7.com/schema/context7.json",
+  "projectTitle": "Lime Elements",
+  "description": "Modern web component library for enterprise applications built with Stencil. Provides accessible, customizable UI components with comprehensive design system.",
+  "branch": "gh-pages",
+  "folders": ["versions/latest/markdown-docs"],
+  "excludeFolders": [
+    "versions/latest/build",
+    "versions/latest/assets",
+    "versions/latest/style",
+    "versions/latest/markdown-docs/**/examples"
+  ],
+  "rules": [
+    "Lime Elements components are web components built with Stencil",
+    "Use kebab-case for component tags (e.g., <limel-button>, <limel-input-field>)",
+    "All components are prefixed with 'limel-'",
+    "Install via npm: npm install @limetech/lime-elements",
+    "TypeScript is fully supported with built-in type definitions",
+    "Components use shadow DOM and work with any framework (React, Vue, Angular, vanilla JS)",
+    "CSS custom properties are used for theming and customization",
+    "Icons require setup - components accept icon names that correspond to SVG filenames",
+    "Most components emit custom events - listen with addEventListener or framework event bindings",
+    "Components inherit font styles from parent - set font-family on body or parent element",
+    "Use the --lime-primary-color CSS variable to set the accent color for your application",
+    "Import components via script tag or module bundler as needed",
+    "For dark mode support, load color-palette-extended.css from the package",
+    "All prop names use camelCase in JavaScript/TypeScript but kebab-case in HTML attributes"
+  ]
+}