remorses/spiceflow

spiceflow type safe API и фреймворк компонентов React Server для Node, Bun и Cloudflare

Spiceflow — это типово-безопасный API фреймворк и fullstack фреймворк React RSC, ориентированный на абсолютную простоту. Он работает во всех процессах выполнения JavaScript: Node.js, Bun и Cloudflare Workers. Читайте исходный код на GitHub. Полная документация доступна на getspiceflow.com.

Особенности

• Full-stack фреймворк React с компонентами React Server (RSC), действиями сервера, макетами и автоматическим разделением клиентского кода
• Работает везде: Node.js, Bun и Cloudflare Workers с одинаковым кодом
• Валидация на основе схем с безопасным типом через Zod
• Безопасное введение клиента с полным выводом параметров пути, запроса, тела и ответа
• Простой и интуитивно понятный API с использованием веб-стандарта Request and Response
• Легко генерировать спецификацию OpenAPI на основе ваших маршрутов
• Поддержка протокола Model Context Protocol для удобного подключения вашего приложения к LLM
• Поддержка асинхронных генераторов для потоковой передачи через события, отправленные сервером
• Модульная конструкция с .use() для монтажа подприложений
• Встроенная трассировка OpenTelemetry без накладных расходов при отключении

Установка

[! ВАЖНО] Spiceflow всё ещё находится в предрелизе.

Spiceflow is a type-safe API framework and full-stack React RSC framework focused on absolute simplicity. It works across all JavaScript runtimes: Node.js, Bun, and Cloudflare Workers. Read the source code on GitHub. Full documentation lives at getspiceflow.com.

Features

• Full-stack React framework with React Server Components (RSC), server actions, layouts, and automatic client code splitting
• Works everywhere: Node.js, Bun, and Cloudflare Workers with the same code
• Type safe schema based validation via Zod
• Type safe fetch client with full inference on path params, query, body, and response
• Simple and intuitive API using web standard Request and Response
• Can easily generate OpenAPI spec based on your routes
• Support for Model Context Protocol to easily wire your app with LLMs
• Supports async generators for streaming via server sent events
• Modular design with .use() for mounting sub-apps
• Built-in OpenTelemetry tracing with zero overhead when disabled

Installation

npm install spiceflow@rsc

[!IMPORTANT] Spiceflow is still in pre-release. Install with spiceflow@rsc, not spiceflow@latest.

AI Agents

To let your AI coding agent know how to use spiceflow, run:

npx -y skills add remorses/spiceflow -g -y

Every documentation page is also available as raw markdown: append .md to any getspiceflow.com URL, for example https://getspiceflow.com/react-data.md.

Basic Usage

API routes return JSON automatically. React pages use .page() and .layout() for server-rendered UI with client interactivity:

import { Spiceflow } from 'spiceflow'
import { Counter } from './counter'

export const app = new Spiceflow()
  .get('/api/hello', () => {
    return { message: 'Hello, World!' }
  })
  .layout('/*', async ({ children }) => {
    return (
      
        {children}
      
    )
  })
  .page('/', async () => {
    return (
      
    )
  })
  .page('/about', async () => {
    return About
  })

app.listen(3000)

Two Ways to Use Spiceflow

Spiceflow works as a standalone API framework or as a full-stack React framework — same router, same type safety, same code.