isas1/forever-ai-components

Forever AI Components is a library of over 600 self-contained animated web components, each stored as a single HTML file with no external dependencies. The project is designed primarily to be used by AI coding agents building or improving visual interfaces. Instead of having an AI generate UI from scratch each time, an agent can search this structured catalog, select an appropriate component, fetch its source code directly from GitHub, and embed or adapt it into the project. Each component is built with CSS, the browser's Canvas API, or SVG, with no JavaScript frameworks or build tools required. Every file works immediately: open it in a browser or paste it into a page. The components span 58 visual themes, including kinetic typography, generative geometry, particle systems, and editorial layouts, and each is tagged with structured metadata covering UI role, animation technique, performance cost, visual style, mood, accessibility support, and interaction type. The retrieval system works in steps. An agent first loads a compact JSON index listing all components with their discovery metadata. It then filters by whatever criteria fit the task, such as a "cheap" performance tier and a "mobile-ready" label, to narrow the list before fetching full source for only the components it needs. Each component file contains an embedded JSON block with adaptation guidance: when to use it, which elements to preserve, and which hardcoded values (colors, fonts, spacing) are safe to change. The collection covers common UI needs including loaders, backgrounds, hero sections, navigation, typography effects, cursor effects, and data visualizations. Composition rules in the README guide how to assemble coordinated sets for full pages, such as combining a kinetic typography component, a particle background, and a loader into a coherent motion-heavy hero section. The library is released under the MIT license.