remorses/spiceflow

스파이스플로우 node, bun, Cloudflare를 위한 타입 안전 API 및 React Server 컴포넌트 프레임워크

Spiceflow는 절대적인 단순성을 중시한 타입 안전 API 프레임워크이자 풀스택 React RSC 프레임워크입니다. Node.js, Bun, Cloudflare Workers 등 모든 자바스크립트 런타임에서 작동합니다. GitHub에서 소스 코드를 읽어보세요. 전체 문서는 getspiceflow.com 에 보관되어 있습니다.

특징

• React 서버 컴포넌트(RSC), 서버 동작, 레이아웃, 자동 클라이언트 코드 분할을 포함한 풀스택 React 프레임워크
• 모든 곳에서 작동: Node.js, 번, 클라우드플레어 워커스에서 동일한 코드를 사용합니다
• Zod를 통한 타입 안전 스키마 기반 검증
• 경로 매개변수, 쿼리, 본문, 응답에 대한 완전한 추론을 포함하는 안전한 fetch client 타입
• 웹 표준 요청 및 응답을 사용하는 간단하고 직관적인 API
• 경로에 기반한 OpenAPI 사양을 쉽게 생성할 수 있음
• LLM으로 쉽게 앱을 연결할 수 있는 모델 컨텍스트 프로토콜 지원
• 서버에서 전송된 이벤트를 통한 스트리밍을 위한 비동기 생성기 지원
• .use()를 통한 모듈식 설계, 하위 앱 장착
• 비활성화 시 오버헤드가 없는 내장 OpenTelemetry 추적

설치

[! 중요] 스파이스플로우는 아직 사전 출시 중입니다.

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.