INDEX.md

FluxStack LLM Documentation

⚠️ DESATUALIZADO (abril/2026). Esta pasta LLMD/ descreve a v1.19/live 0.7.2 e trata RSC como experimento. O código real é v1.22.1 / @fluxstack/live 0.10.0 / RSC como modo SSR padrão / registro manual de plugins. Fonte de verdade atual: ../specs/ (app) e ../../fluxstack-live/specs/ (Live Components). Divergências detalhadas em ../specs/04-stale-knowledge.md. Em conflito, as specs vencem.

Version: 1.19.0 → 1.22.1 | Framework: Bun + Elysia + React + Eden Treaty | Live: 0.7.2 → @fluxstack/live 0.10.0

Quick Navigation

AI Agent? → agent.md - Guia completo para agentes de IA First Time? → core/framework-lifecycle.md Creating Routes? → resources/routes-eden.md REST API Auth? → resources/rest-auth.md Live Components Auth? → resources/live-auth.md Real-time Rooms? → resources/live-rooms.md (Typed LiveRoom + untyped, password rooms, directory) Debugging Logs? → resources/live-logging.md Config Issues? → config/declarative-system.md Plugin Development? → resources/plugins-external.md Errors? → reference/troubleshooting.md

Core Concepts

• Framework Lifecycle - Startup, request handling, shutdown
• Plugin System - Architecture, hooks, load order
• Build System - Dev vs production builds

Configuration

• Declarative System - defineConfig, validation, types
• Environment Variables - Complete reference
• Runtime Reload - Hot config updates

Creating Resources

• Routes with Eden Treaty - Type-safe API routes
• Controllers & Services - Business logic patterns
• Live Components - WebSocket components
• REST Auth - Session & Token guards, middleware, rate limiting
• Live Auth - Authentication for Live Components
• Live Rooms - Typed rooms (LiveRoom), password protection, room directory, untyped rooms
• Live Logging - Per-component logging control
• Live Upload - Chunked upload via Live Components
• Live Binary Delta - High-frequency binary state sync
• External Plugins - Plugin development
• Routing (React Router v7) - Frontend routing setup

Patterns & Rules

• Project Structure - Folder organization
• Type Safety - Eden Treaty type flow
• Anti-Patterns - What NOT to do

Reference

• CLI Commands - Complete command reference
• Plugin Hooks - All available hooks
• Troubleshooting - Common issues

Critical Rules

NEVER:

• Modify files in core/ (framework is read-only)
• Wrap Eden Treaty in custom functions
• Omit response schemas in routes

ALWAYS:

• Work in app/ directory
• Use native Eden Treaty: const { data, error } = await api.users.get()
• Define shared types in app/shared/
• Run bun run dev after changes

Migration & Maintenance

• MIGRATION.md - Changes from ai-context/ to LLMD/
• MAINTENANCE.md - How to update this documentation