Spiceflow is a modern, high-performance API and full-stack React framework designed for absolute simplicity and type safety across all major JavaScript environments, including Node.js, Bun, and Cloudflare Workers. Created to provide a seamless developer experience, it bridges the gap between lightweight API development and full-scale React Server Components (RSC) applications within a unified codebase. The framework emphasizes web standards, utilizing native Request and Response objects, and minimizes configuration overhead to ensure that developers can move rapidly from concept to production.

Functionality: Spiceflow acts as a modular framework that allows developers to define API routes and React pages within a single router structure. It provides automatic JSON serialization for API routes, pre-rendered static routes for optimal performance, and robust React Server Components support with server actions and layouts. Its design allows for the generation of OpenAPI specifications directly from route definitions and provides a type-safe fetch client that automatically infers request and response schemas from the app's internal definitions, ensuring end-to-end type safety.

Some of the key features are:

• Full-stack React framework: Integrates RSC, server actions, and layouts with automatic client code splitting for performant, interactive applications.
• Universal Runtime Compatibility: Works identically across Node.js, Bun, and Cloudflare Workers with a consistent API.
• Type-Safe Validation: Uses Zod schemas for automatic request and response validation, ensuring runtime data integrity.
• Type-Safe Fetch Client: Automatically generates a client capable of full type inference for path parameters, query strings, request bodies, and responses.
• OpenAPI Integration: Generates complete OpenAPI 3.1 specifications automatically from route definitions without extra configuration.
• Async Generator Support: Provides native support for streaming using server-sent events (SSE) for real-time data delivery.
• Modular Mounting: Employs a robust .use() pattern for mounting sub-applications, enabling clean architectural separation.
• Built-in Tracing: Includes native OpenTelemetry support with zero-overhead configuration to monitor performance and distributed tracing.

Operation: Spiceflow operates by allowing developers to chain route definitions in a single expressive block, which the TypeScript compiler uses to build a complete type map of the application. When used as an API framework, it handles requests using standardized web objects and manages state through middleware. In full-stack mode, it integrates with Vite to manage RSC lifecycles, hydrating components where needed and streaming server-rendered HTML to the browser. The framework is designed to be self-contained; during production builds, it packages the application into a compact distribution that does not require additional dependencies at deployment time, making it ideal for containerized or edge-native environments.

Some common use cases include:

• Type-Safe API Services: Building high-performance, validated REST APIs for microservices or backend-for-frontend (BFF) layers.
• Server-Side Rendered Applications: Creating complex, dynamic web applications that leverage the speed of RSC and the simplicity of React.
• Edge Computing: Deploying lightweight, low-latency API logic and UI to Cloudflare Workers or similar edge platforms.
• AI Agent Tooling: Wiring LLM interfaces to application logic using the Model Context Protocol to serve API routes as actionable tools for language models.
• Full-Stack Internal Dashboards: Rapidly building data-intensive internal tools that require strict type safety and share data between server and client without complex prop-drilling.