CRUDP

A JSON/binary CRUD protocol for isomorphic Go applications. Supports batch operations, SSE responses, and runs the same handler logic on both WASM frontend and Go backend.

Features

• Isomorphic: Same handler code on frontend (WASM) and backend (Server)
• Batch Processing: Multiple operations consolidated into single HTTP requests
• SSE Responses: Async response delivery via Server-Sent Events
• TinyGo Compatible: Optimized for small WASM binaries
• Local-First: Queue-based offline support with automatic sync

Quick Start

// Handler (shared frontend/backend)
type UserHandler struct{}

func (h *UserHandler) HandlerName() string { return "user" }

func (h *UserHandler) Create(ctx context.Context, data ...any) any {
    // Backend: process and return Response
    // Frontend: update DOM and return nil
}

Documentation

Core Concepts

• docs/ARCHITECTURE.md: Main specification and implementation status
• docs/CONFIG.md: Configuration system
• docs/HANDLER_REGISTER.md: Handler interfaces and registration
• docs/RESPONSE.md: Returning responses from handlers
• docs/SSE_BROKER.md: SSE Broker and Packet Batching
• docs/PACKET_STRUCTURE.md: Packet and response structures

Guides

• docs/INTEGRATION_GUIDE.md: How to integrate CRUDP
• docs/FILE_UPLOAD.md: File handling with "Upload & Reference" pattern
• docs/HTTP_ROUTES_AND_MIDDLEWARE.md: HTTP Routes and Middleware
• docs/LIMITATIONS.md: Supported data types

Reference

• docs/INITIAL_VISION.md: Original vision and requirements
• docs/OPTIMIZATION_PLAN.md: Performance optimizations
• docs/PERFORMANCE.md: Benchmark results

---

Contributing