Introduction

What is Lumenize?

Today (October 2025)

Lumenize is a toolkit for building and testing scalable and maintainable applications on Cloudflare Durable Objects (DOs). The main features available today focus on RPC:

1. In-process integration testing. Provides more capability and a more de✨light✨ful DX than cloudflare:test's runInDurableObjects particularly for testing DOs that implement WebSockets. Supports new WebSockets(), client libraries, auto-response pair testing, test coverage, and more.

2. In-production RPC from the browser: Enables secure, production-grade RPC with a de✨light✨ful developer experience:

// Store a value in Durable Object storage
await client.ctx.storage.put('count', '10');
// Invoke a method on the Durable Object
const currentCount = await client.increment(); // returns 11

Lumenize also provides utilities like routeDORequest, a near drop-in replacement for routeAgentRequest and routePartyRequest, offering robust CORS support and a cleaner API.

Looking Ahead

This repository will soon include two additional projects:

LumenizeBase: A modular base class and plugin system for Durable Objects, offering opinionated best practices along with flexible extensions.

Lumenize: The next-generation backend platform for vibe coding internal enterprise or B2B SaaS applications, built around Model Context Protocol (MCP). This MCP-first architecture enables seamless integration with agentic AI workflows and is designed to be secure by default.

de✨light✨ful Developer Experience

Opinionated Yet Flexible

Lumenize is opinionated where it counts—providing clear guidance and best practices for robust, scalable DO applications—while remaining flexible. Install only the plugins you need, and extend functionality with the same modular plugin system.

Standing on the Shoulders of Giants

Lumenize builds on the best of Agent, PartyKit, Actor, and durable-utils, adding robustness and unique features. See our blog post on the Lumenize journey for more.

Engineering Excellence

• Over 90% test coverage with meaningful assertions beyond happy-path scenarios
• Comprehensive documentation with runnable examples
• Documentation kept in sync with code via doc-testing
• Toggle logging by namespace, Durable Object instance, or other context
• Committed to rapid bug fixes
• Design so the right way for a user to do something is the easy way, particularly when it comes to security

Release Status

We are now in a position to start releasing pieces under open source licenses as we clean up the documentation for external consumption. See below for the status of what is out and what's coming out next.

Name	Description	License	Released
@lumenize/testing	In-process Integration Testing	MIT	✓
@lumenize/rpc	In-production RPC w/ browser client	MIT	✓
@lumenize/utils	Useful utilities for DO projects	MIT	✓
@lumenize/lumenize-base	LumenizeBase base class	MIT
@lumenize/lumenize	Vibe code enterprise or B2B SaaS apps	BSI 1.1