Skip to content
Back to search

lunora

MarketplaceWorks with Claude CodeGitHub

Plugins for building on Lunora — a type-safe, real-time backend on Cloudflare Workers + Durable Objects.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/anolilab/lunora with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/anolilab/lunora'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anolilab--lunora/badge.svg)](/listings/anolilab--lunora)

HTML

<a href="/listings/anolilab--lunora"><img src="/api/listings/anolilab--lunora/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

pnpm dlx lunorash@alpha init my-app
cd my-app
pnpm install
pnpm dev

> **Alpha:** the npm package is **`lunorash`** (the unscoped `lunora` name is taken on npm); the CLI binary it installs is still **`lunora`**. Install from the `@alpha` dist-tag and expect breaking changes until the first stable release. `npm view <pkg> version` reports a `0.0.x` placeholder on `latest` for every Lunora package — the real version lives on the `alpha` dist-tag (`npm view <pkg> dist-tags`).

> Prefer managed hosting, or just want one email when v1 is stable? **[Join the Lunora Cloud waitlist →](https://lunora.sh/cloud)**

Three visible files in a fresh app:

// lunora/schema.ts
import { defineSchema, defineTable, v } from "lunorash/server";

export default defineSchema({
    messages: defineTable({
        author: v.string(),
        body: v.string(),
        ts: v.number(),
    }),
});
// lunora/messages.ts
import { mutation, query, v } from "./_generated/server";

export const list = query.query(async ({ ctx }) => ctx.db.query("messages").order("desc").take(50));

export const send = mutation.input({ author: v.string(), body: v.string() }).mutation(async ({ ctx, args }) => {
    await ctx.db.insert("messages", { ...args, ts: Date.now() });
});
// src/App.tsx
import { useQuery, useMutation } from "@lunora/react";
import { api } from "../lunora/_generated/api";

export default function App() {
    const messages = useQuery(api.messages.list) ?? [];
    const send = useMutation(api.messages.send);
    return (
        <ul>
            {messages.map((m) => (
                <li key={m._id}>
                    {m.author}: {m.body}
                </li>
            ))}
        </ul>
    );
}

`pnpm dev` boots workerd, generates the client types, opens the Vite dev server, and live-reloads on every save.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 17 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "lunora",
  3. "description": "Plugins for building on Lunora — a type-safe, real-time backend on Cloudflare Workers + Durable Objects.",
  4. "owner": {
  5. "name": "Anolilab",
  6. "email": "d.bannert@anolilab.de",
  7. "url": "https://github.com/anolilab"
  8. },
  9. "plugins": [
  10. {
  11. "name": "lunora",
  12. "source": "./plugins/lunora",
  13. "category": "Engineering",
  14. "tags": ["backend", "cloudflare", "realtime", "typescript"]
  15. }
  16. ]
  17. }
README.md · README · 378 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="./.github/assets/package-og.svg" alt="Lunora" />
  3. **Type-safe, real-time backend on your own Cloudflare account. Vite-first.**
  4. [**Documentation**](https://lunora.sh/docs) · [**Website**](https://lunora.sh) · [**Packages**](https://lunora.sh/packages) · [**Quick start**](#quick-start)
  5. <br />
  6. [![typescript-image][typescript-badge]][typescript-url]
  7. [![Apache-2.0 licence][license-badge]][license]
  8. [![Status][status-badge]][status]
  9. [![Node][node-badge]][node]
  10. [![pnpm][pnpm-badge]][pnpm]
  11. [![CI][ci-badge]][ci]
  12. [![npm version][npm-version-badge]][npm-version]
  13. [![PRs Welcome][prs-welcome-badge]][prs-welcome]
  14. [![OpenSSF Scorecard][scorecard-badge]][scorecard]
  15. </div>
  16. ---
  17. <div align="center">
  18. <p>
  19. <sup>
  20. Daniel Bannert's open source work is supported by the community on <a href="https://github.com/sponsors/prisis">GitHub Sponsors</a>.
  21. See <a href="https://lunora.sh/sponsors">lunora.sh/sponsors</a> for what sponsorship funds.
  22. </sup>
  23. </p>
  24. </div>
  25. ---
  26. ## What is Lunora?
  27. Lunora gives you Convex-style DX on infrastructure you control. You write type-safe queries, mutations, and actions in TypeScript. In production, Lunora deploys them as Cloudflare Workers: Durable Objects hold real-time state, D1 handles SQL, R2 stores blobs, and Queues run jobs. Nothing runs on servers we operate; the production stack lives in the Cloudflare account you already pay for. See [Where it runs](#where-it-runs) for the other targets.
  28. Lunora is Vite-first. The dev loop, codegen, and client bindings plug into a Vite project through `@cloudflare/vite-plugin`, so local dev runs on workerd, the same runtime as production. Rsbuild and Rspack projects get the same loop through `@lunora/rspack`, and a standalone CLI covers everything else.
  29. ## Quick start
  30. ```bash
  31. pnpm dlx lunorash@alpha init my-app
  32. cd my-app
  33. pnpm install
  34. pnpm dev
  35. ```
  36. > **Alpha.** The npm package is `lunorash` because the unscoped `lunora` name is taken; the CLI it installs is still called `lunora`. Install from the `@alpha` dist-tag and expect breaking changes until the first stable release (see [Status](#status)).
  37. > Prefer managed hosting, or just want one email when v1 is stable? **[Join the Lunora Cloud waitlist →](https://lunora.sh/cloud)**
  38. A fresh app has three files you edit:
  39. ```ts
  40. // lunora/schema.ts
  41. import { defineSchema, defineTable, v } from "lunorash/server";
  42. export default defineSchema({
  43. messages: defineTable({
  44. author: v.string(),
  45. body: v.string(),
  46. ts: v.number(),
  47. }),
  48. });
  49. ```
  50. ```ts
  51. // lunora/messages.ts
  52. import { mutation, query, v } from "./_generated/server";
  53. export const list = query.query(async ({ ctx }) => ctx.db.query("messages").order("desc").take(50));
  54. export const send = mutation.input({ author: v.string(), body: v.string() }).mutation(async ({ ctx, args }) => {
  55. await ctx.db.insert("messages", { ...args, ts: Date.now() });
  56. });
  57. ```
  58. ```tsx
  59. // src/App.tsx
  60. import { useQuery, useMutation } from "@lunora/react";
  61. import { api } from "../lunora/_generated/api";
  62. export default function App() {
  63. const messages = useQuery(api.messages.list, {}) ?? [];
  64. const { mutate: send } = useMutation(api.messages.send);
  65. return (
  66. <>
  67. <button onClick={() => send({ author: "me", body: "hello" })}>Send</button>
  68. <ul>
  69. {messages.map((m) => (
  70. <li key={m._id}>
  71. {m.author}: {m.body}
  72. </li>
  73. ))}
  74. </ul>
  75. </>
  76. );
  77. }
  78. ```
  79. `pnpm dev` boots workerd, generates the client types, starts the Vite dev server, and reloads on every save. Click the button and the list updates in every open tab; the query re-runs on the server and pushes the new result.
  80. `lunora init` asks which framework to use and defaults to a React SPA. Pass `-t` to pick one directly: `next`, `nuxt`, `sveltekit`, `astro`, `analog`, `tanstack-start-react`, `tanstack-start-solid`, `solid-v2`, `expo`, `vinext`, `rspack-react`, `standalone`, and a few more (`lunora init --help` lists them). Use `--vite <framework>` for a plain React, Vue, Solid, or Svelte SPA, and `lunora init --here` to add Lunora to an app you already have.
  81. ## Why Lunora
  82. **Types run end to end.** The schema, validators, query results, and client hooks come from one source of truth. The dev server regenerates client types on save, so there is no codegen step to forget.
  83. **Queries are live.** Clients subscribe over WebSocket, and a mutation pushes the change to every subscriber. You don't write cache invalidation.
  84. **Production runs on your account.** Cloudflare is the production target: Workers, Durable Objects, D1, R2, Queues, and KV all live in your Cloudflare account. An idle app costs about nothing, and at scale you pay Cloudflare's prices rather than a SaaS markup.
  85. **It grows past one Durable Object.** Every app starts on a single Durable Object. When one tenant needs its own, add `.shardBy(key)` to the function; for geo-replicated reads, add `.global()`. The rest of the app stays the same.
  86. **Features come as add-ons.** Auth, mail, storage, scheduling, queues and pub/sub topics, workflows, AI agents, payments, feature flags, rate limiting, and notifications ship as `@lunora/*` packages or as items you copy in with `lunora registry add`. Other packages add typed access to Cloudflare Containers, Browser Rendering, Hyperdrive, AI Search, and service bindings to sibling Workers.
  87. **Sign-in is more than passwords.** `@lunora/auth` wraps better-auth, so passkeys, magic links, email OTP, two-factor, anonymous sessions, and OAuth providers are available through its plugins.
  88. **Built for AI agents.** `@lunora/mcp` exposes your deployment's tables, functions, logs, issues, and advisories to MCP clients, so an agent can inspect and debug your app the way you do.
  89. **Clients aren't limited to JavaScript.** There are adapters for React, Vue, Solid, Svelte, Angular, and React Native, and `lunora sdk generate` writes typed clients for Python, Go, Ruby, Rust, Swift, Java, Kotlin, and Dart (see [`sdks/`](./sdks/README.md)).
  90. **The core doesn't depend on Cloudflare.** The reactive engine (`@lunora/shard-engine`) talks to a small set of host contracts in `@lunora/platform`, not to Cloudflare APIs. `@lunora/platform-cloudflare` implements those contracts for production and `@lunora/platform-node` for dev and test. A capability matrix marks each feature as native, emulated, or unsupported per host; codegen leaves out what a host can't run and tells you why.
  91. ## Where it runs
  92. | Target | Status | Use it for |
  93. | ----------------------------------------------- | ------------ | ---------------------------------------------- |
  94. | Cloudflare Workers and Durable Objects | Production | Deploying your app |
  95. | Node (`@lunora/platform-node`) | Dev and test | Local runs and tests. Not a production target. |
  96. | Self-hosted on celld (`@lunora/platform-celld`) | Experimental | Self-hosting on machines you run |
  97. Build with Vite (`@lunora/vite`), with Rsbuild or Rspack (`@lunora/rspack`), or with the standalone CLI. The core does not depend on Cloudflare APIs; each target implements the same host contracts in `@lunora/platform`. Each target's capability matrix says which features it supports.
  98. ## Lunora Studio
  99. `pnpm dev` also serves Lunora Studio, a local admin UI for your app. In it you can browse and edit data, run SQL, watch live connections and function metrics, follow logs and traces, and see errors grouped into Issues. Time Travel replays past state, the architecture view draws a diagram from your code's call graph, and the advisors flag security and performance problems in your schema.
  100. <div align="center">
  101. <picture>
  102. <source media="(prefers-color-scheme: dark)" srcset="./.github/assets/studio-home-dark.png" />
  103. <img src="./.github/assets/studio-home-light.png" alt="Lunora Studio, the local admin UI for your schema, data, functions, and advisors" width="900" />
  104. </picture>
  105. </div>
  106. > Read the [Studio deep dive →](https://lunora.sh/blog/lunora-studio-deep-dive)
  107. ## Lunora vs. the alternatives
  108. | | **Lunora** | Convex | Firebase | Plain Cloudflare |
  109. | ------------------------------------------------ | ---------------------- | ----------------- | ----------------- | ---------------- |
  110. | Type-safe end-to-end | Yes | Yes | Partial | DIY |
  111. | Real-time subscriptions | Yes (WS, reactive) | Yes | Yes | DIY |
  112. | Runs on your account | **Yes (Cloudflare)** | No (managed SaaS) | No (managed SaaS) | Yes |
  113. | Scales past single DO | **Yes (`.shardBy()`)** | n/a | n/a | DIY (manual) |
  114. | Vite-first DX | **Yes** | n/a | n/a | DIY |
  115. | Feature breadth (auth, mail, storage, scheduler) | Add-ons (alpha) | Broad (built-in) | Broad (built-in) | DIY |
  116. | Cost at idle | ≈ $0 (CF free tier) | Paid | ≈ $0 (Spark tier) | ≈ $0 |
  117. Convex still has more built in than Lunora. What you get in exchange is ownership of the infrastructure and its cost: an idle Lunora app costs nothing, and at scale you pay Cloudflare's prices rather than a SaaS markup.
  118. ## Architecture
  119. ```
  120. ┌────────────────────────────────────┐
  121. │ Browser / Node / RN client │
  122. │ @lunora/client · @lunora/react │
  123. └─────────────────┬──────────────────┘
  124. │ HTTPS + WebSocket (RPC envelope)
  125. ▼
  126. ┌────────────────────────────────────┐
  127. │ Vite / Rspack dev (workerd) │
  128. │ @lunora/vite · @lunora/rspack │
  129. │ or standalone: @lunora/cli │
  130. └─────────────────┬──────────────────┘
  131. │
  132. ▼
  133. ┌─────────────────────────────────────────────────┐
  134. │ Cloudflare Worker — @lunora/runtime │
  135. │ · parses RPC · auth · routing │
  136. │ · upgrades WS to ShardDO via idFromName(key) │
  137. └───┬──────────┬───────────┬───────────┬──────────┘
  138. │ │ │ │
  139. ▼ ▼ ▼ ▼
  140. ┌───────┐ ┌────────┐ ┌──────┐ ┌──────────┐
  141. │ Shard │ │Session │ │ D1 │ │R2/Queues │
  142. │ DO │ │ DO │ │ SQL │ │ KV │
  143. │(state)│ │ (auth) │ │ │ │ │
  144. └───────┘ └────────┘ └──────┘ └──────────┘
  145. │
  146. ├── SQLite-backed, WebSocket Hibernation API,
  147. │ subscription registry
  148. │
  149. └── @lunora/shard-engine (host-neutral: state, OCC,
  150. CDC, reactivity) over @lunora/platform contracts,
  151. implemented for this target by
  152. @lunora/platform-cloudflare
  153. ```
  154. ## Packages
  155. All packages are published under the [`@lunora`](https://www.npmjs.com/org/lunora) npm scope (except the unscoped umbrella `lunorash`) and live under `packages/`.
  156. > This table is generated from each package's `package.json` and `project.json`. Run `pnpm run generate:packages-list` to refresh it.
  157. <!-- START_TABLE_PLACEHOLDER -->
  158. ### Runtime
  159. | Package | Version | Description |
  160. | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  161. | [`@lunora/d1`](packages/d1/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fd1?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fd1) | D1 adapter for Lunora .global() tables, wrapping the Sessions API for read-your-writes |
  162. | [`@lunora/do`](packages/do/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fdo?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fdo) | Lunora Durable Objects: ShardDO (SQLite, OCC, hibernated WebSocket subscriptions) and SessionDO |
  163. | [`@lunora/errors`](packages/errors/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Ferrors?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Ferrors) | Unified error layer for Lunora: one LunoraError base + a central catalog of codes, statuses, and actionable hints, rendered across CLI, overlay, Studio, and the client |
  164. | [`@lunora/fingerprint`](packages/fingerprint/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Ffingerprint?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Ffingerprint) | Zero-dependency, cross-runtime error fingerprinting for Lunora: a stable grouping hash that collapses noisy errors into Issues across the local Studio and the Cloud |
  165. | [`@lunora/runtime`](packages/runtime/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fruntime?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fruntime) | Lunora Worker runtime: the RPC router, shard resolver, and query coordinator |
  166. | [`@lunora/server`](packages/server/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fserver?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fserver) | Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action |
  167. | [`@lunora/sql-store`](packages/sql-store/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fsql-store?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fsql-store) | Internal dialect-parameterized SQL store core for Lunora .global() backends (D1, PlanetScale) |
  168. | [`@lunora/values`](packages/values/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fvalues?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fvalues) | Validators for Lunora: the v.* validator suite with end-to-end return-type inference |
  169. | [`lunorash`](packages/lunora/README.md) | [![npm](https://img.shields.io/npm/v/lunorash?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/lunorash) | The Lunora umbrella package: one install for the server authoring API, worker runtime, Durable Objects, and the lunora CLI |
  170. ### Client & Framework Adapters
  171. | Package | Version | Description |
  172. | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  173. | [`@lunora/angular`](packages/angular/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fangular?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fangular) | Angular reactive adapter for Lunora — signal-based live queries and mutations |
  174. | [`@lunora/astro`](packages/astro/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fastro?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fastro) | Astro integration for Lunora — single-worker composition plus reactive-loader server helpers |
  175. | [`@lunora/client`](packages/client/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fclient?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fclient) | Lunora browser SDK: WebSocket transport, optimistic updates, and an offline mutation queue |
  176. | [`@lunora/db`](packages/db/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fdb?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fdb) | TanStack DB binding: typed, live-synced collections and a durable offline outbox over the Lunora client |
  177. | [`@lunora/nuxt`](packages/nuxt/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fnuxt?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fnuxt) | Nuxt module for Lunora — single-worker composition (mounts /_lunora/* into Nitro) plus reactive-loader server helpers |
  178. | [`@lunora/react`](packages/react/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Freact?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Freact) | React hooks for Lunora: useQuery, useMutation, useSubscription, and useAuth |
  179. | [`@lunora/react-native`](packages/react-native/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Freact-native?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Freact-native) | React Native / Expo integration for Lunora: an AsyncStorage-backed client factory, the useQuery/useMutation/useSubscription hooks, and a one-call better-auth Expo client |
  180. | [`@lunora/solid`](packages/solid/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fsolid?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fsolid) | SolidJS adapter for Lunora — live queries, optimistic mutations, and reactive loaders |
  181. | [`@lunora/studio`](packages/studio/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fstudio?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fstudio) | The Lunora Studio: a local admin UI for your schema, data, logs, and advisors |
  182. | [`@lunora/svelte`](packages/svelte/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fsvelte?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fsvelte) | Svelte adapter for Lunora — live stores, optimistic mutations, and reactive loaders |
  183. | [`@lunora/vue`](packages/vue/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fvue?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fvue) | Vue adapter for Lunora — live composables, optimistic mutations, and reactive loaders |
  184. ### CLI
  185. | Package | Version | Description |
  186. | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
  187. | [`@lunora/cli`](packages/cli/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fcli?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fcli) | The Lunora CLI: init, dev, deploy, codegen, migrate, seed, doctor, insights, logs, registry, and the rest of the project commands |
  188. ### Codegen
  189. | Package | Version | Description |
  190. | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
  191. | [`@lunora/codegen`](packages/codegen/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fcodegen?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fcodegen) | Code generator for Lunora: emits _generated/{api,server,dataModel}.ts from your schema |
  192. ### Bundler Plugins
  193. | Package | Version | Description |
  194. | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
  195. | [`@lunora/rspack`](packages/rspack/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Frspack?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Frspack) | The Lunora Rspack plugin: codegen, binding provisioning, and wrangler validation for Rspack projects |
  196. | [`@lunora/vite`](packages/vite/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fvite?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fvite) | The Lunora Vite plugin: codegen, type sync, wrangler validation, and an error overlay over @cloudflare/vite-plugin |
  197. ### Dev Tools
  198. | Package | Version | Description |
  199. | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
  200. | [`@lunora/config`](packages/config/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fconfig?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fconfig) | Internal shared CLI + Vite config layer for Lunora: wrangler.jsonc validation, binding inference, and .dev.vars scaffolding |
  201. | [`@lunora/testing`](packages/testing/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Ftesting?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Ftesting) | Testing toolkit for Lunora: an in-memory harness for queries, mutations, and actions |
  202. ### Advisor
  203. | Package | Version | Description |
  204. | ----------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
  205. | [`@lunora/advisor`](packages/advisor/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fadvisor?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fadvisor) | Schema & query lints (splinter-style advisors) for Lunora, feeding the Studio Advisors view |
  206. ### Add-ons
  207. | Package | Version | Description |
  208. | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  209. | [`@lunora/agent`](packages/agent/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fagent?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fagent) | Durable AI agents for Lunora: defineAgent compiles a replay-safe tool-loop onto Cloudflare Workflows, with DO SQLite threads and live message subscriptions |
  210. | [`@lunora/ai`](packages/ai/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fai?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fai) | Workers AI helper for Lunora: provider-agnostic AI SDK access from functions, Workers AI by default |
  211. | [`@lunora/auth`](packages/auth/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fauth?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fauth) | Auth for Lunora — a thin better-auth wrapper: email/password, OAuth, plugins, D1-backed |
  212. | [`@lunora/bindings`](packages/bindings/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fbindings?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fbindings) | Lightweight Cloudflare binding helpers for Lunora — ctx.kv, ctx.images, ctx.analytics, ctx.pipelines, ctx.vectors, ctx.r2sql, ctx.artifacts, ctx.aiSearch, ctx.analyticsSql — one install, per-binding subpaths |
  213. | [`@lunora/browser`](packages/browser/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fbrowser?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fbrowser) | Cloudflare Browser Rendering for Lunora: ctx.browser screenshots, PDF, and scraping in actions |
  214. | [`@lunora/cloudflare-access`](packages/cloudflare-access/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fcloudflare-access?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fcloudflare-access) | Cloudflare Access (Zero Trust) identity for Lunora — verify the Cf-Access-Jwt-Assertion JWT against your team JWKS and feed the verified identity into ctx.auth / RLS via a resolveIdentity adapter |
  215. | [`@lunora/jwt-auth`](packages/jwt-auth/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fjwt-auth?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fjwt-auth) | Bring your own auth — verify Clerk, WorkOS, Auth0, Supabase or any OIDC JWT against its JWKS and feed the identity into ctx.auth / RLS |
  216. | [`@lunora/container`](packages/container/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fcontainer?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fcontainer) | Cloudflare Containers for Lunora: defineContainer, generated Container DO classes, and the ctx.containers action surface |
  217. | [`@lunora/flags`](packages/flags/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fflags?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fflags) | OpenFeature-based feature flags for Lunora — ctx.flags, useFlag, and a first-class Cloudflare Flagship provider with any OpenFeature provider pluggable |
  218. | [`@lunora/hyperdrive`](packages/hyperdrive/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fhyperdrive?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fhyperdrive) | Bring-your-own Postgres/MySQL for Lunora via Cloudflare Hyperdrive: a driver-agnostic, action-only ctx.sql |
  219. | [`@lunora/mail`](packages/mail/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fmail?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fmail) | Email for Lunora: Resend adapter, TSX templates, and queue-backed sends |
  220. | [`@lunora/mcp`](packages/mcp/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fmcp?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fmcp) | Model Context Protocol server exposing a Lunora deployment to AI agents |
  221. | [`@lunora/notify`](packages/notify/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fnotify?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fnotify) | Multi-channel notifications for Lunora — ctx.notify / ctx.push over @visulima/notification: edge-safe Web Push + FCM, plus chat, in-app inbox and webhook channels, with subscription storage and queue-backed fan-out |
  222. | [`@lunora/payment`](packages/payment/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fpayment?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fpayment) | Provider-agnostic payments for Lunora: Stripe-first adapter, webhook sync, and subscription/payment state machine |
  223. | [`@lunora/queue`](packages/queue/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fqueue?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fqueue) | Cloudflare Queues for Lunora: defineQueue producers + consumers, the ctx.queues surface, and the generated queue() worker handler |
  224. | [`@lunora/ratelimit`](packages/ratelimit/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fratelimit?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fratelimit) | Rate limiting: token-bucket / fixed-window / sliding-window algorithms, deny list, pluggable stores, and procedure middleware |
  225. | [`@lunora/replica`](packages/replica/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Freplica?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Freplica) | Local-first replica runtime + local SQLite mirror for Lunora |
  226. | [`@lunora/scheduler`](packages/scheduler/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fscheduler?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fscheduler) | Scheduling for Lunora: runAfter / runAt and Cron Triggers via SchedulerDO |
  227. | [`@lunora/seed`](packages/seed/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fseed?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fseed) | Schema-driven, deterministic database seeding for Lunora: realistic fake data from defineSchema |
  228. | [`@lunora/storage`](packages/storage/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fstorage?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fstorage) | R2-backed storage for Lunora: typed buckets and signed URLs |
  229. | [`@lunora/workflow`](packages/workflow/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fworkflow?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fworkflow) | Durable workflows for Lunora: defineWorkflow over Cloudflare Workflows, generated WorkflowEntrypoint classes, and the ctx.workflows surface |
  230. ### Observability
  231. | Package | Version | Description |
  232. | ----------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
  233. | [`@lunora/observability`](packages/observability/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fobservability?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fobservability) | Host-neutral telemetry storage and read models for Lunora, backing the Studio's Logs, Traces, Metrics and Issues views |
  234. ### Platform
  235. | Package | Version | Description |
  236. | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  237. | [`@lunora/platform`](packages/platform/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fplatform?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fplatform) | Provider-neutral host contracts for Lunora: shard/socket/directory/scheduler interfaces, binding projections, and the platform capability matrix |
  238. | [`@lunora/platform-celld`](packages/platform-celld/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fplatform-celld?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fplatform-celld) | celld implementation of the Lunora platform contracts: the Cloudflare host adapters recomposed for celld (self-hosted distributed Durable Objects) under an honest capability matrix |
  239. | [`@lunora/platform-cloudflare`](packages/platform-cloudflare/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fplatform-cloudflare?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fplatform-cloudflare) | Cloudflare implementation of the Lunora platform contracts: ShardHost, SocketHost, ShardDirectory, ShardKvStore over Durable Objects |
  240. | [`@lunora/platform-node`](packages/platform-node/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fplatform-node?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fplatform-node) | Node implementation of the Lunora platform contracts: ShardHost, SocketHost, ShardDirectory, ShardKvStore, SchedulerHost over better-sqlite3 and an in-process socket registry (dev/test target) |
  241. | [`@lunora/shard-engine`](packages/shard-engine/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fshard-engine?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fshard-engine) | Host-neutral reactive engine for Lunora: per-shard state, OCC, CDC, reactive subscriptions, and the poke protocol. Consumes @lunora/platform host contracts and can be mounted on any platform host. |
  242. ### Web3
  243. | Package | Version | Description |
  244. | ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
  245. | [`@lunora/x402`](packages/x402/README.md) | [![npm](https://img.shields.io/npm/v/%40lunora%2Fx402?style=flat-square&labelColor=292a44&color=663399&label=v)](https://www.npmjs.com/package/%40lunora%2Fx402) | Agentic payments (x402) for Lunora: charge agents per request (charge rail) and let your agents pay x402-gated resources (pay rail) |
  246. <!-- END_TABLE_PLACEHOLDER -->
  247. ## Examples
  248. Runnable apps live in [`examples/`](./examples): a [todo app](./examples/todo-app), [team chat](./examples/team-chat), a [kanban board](./examples/kanban-board), [realtime cursors](./examples/realtime-cursors), [chess](./examples/chess), a [blog](./examples/blog), a [feedback board](./examples/feedback-board), [TanStack Start](./examples/tanstack-start), [Expo](./examples/expo), and focused demos for [auth](./examples/auth-playground), [payments](./examples/payment-demo), [notifications](./examples/notify-demo), [offline rejections](./examples/offline-rejections), and [service bindings](./examples/services).
  249. ## Documentation
  250. The full docs are at [lunora.sh/docs](https://lunora.sh/docs): guides, concepts, framework adapters, and a reference for each package. Good places to start:
  251. - [Getting started](https://lunora.sh/docs/getting-started): scaffold an app and run the dev loop.
  252. - [Queries, mutations & actions](https://lunora.sh/docs/concepts/queries-mutations): how you write backend code.
  253. - [Real-time](https://lunora.sh/docs/concepts/realtime), [sharding](https://lunora.sh/docs/concepts/sharding), and [RLS](https://lunora.sh/docs/concepts/rls): how data reaches clients, scales out, and stays scoped to the right user.
  254. - [Architecture](https://lunora.sh/docs/architecture): how the Worker, Durable Objects, and storage fit together.
  255. - [Design boundaries](https://lunora.sh/docs/non-goals): what Lunora deliberately doesn't do, and the escape hatch for each.
  256. - [Deployment](https://lunora.sh/docs/deployment): shipping to your own Cloudflare account.
  257. - [Packages](https://lunora.sh/packages): every `@lunora/*` adapter and add-on.
  258. ## Status
  259. Lunora is in alpha, and the APIs will break. Every package publishes continuously to the `alpha` dist-tag on npm (`pnpm add lunorash@alpha`). Each package has its own version, so the alpha numbers don't line up across packages. The `latest` tag only holds a `0.0.x` placeholder; run `npm view <pkg> dist-tags` to see the real version. The API, the package boundaries, and the on-disk layout will all change before the first stable release.
  260. New versions ship often enough to trip pnpm's `minimumReleaseAge`. If you use that setting, add `"@lunora/*"` and `lunorash` to `minimumReleaseAgeExclude`; otherwise pnpm can resolve a mix of packages that no longer match.
  261. Read the code, file issues, and open PRs against the [`alpha`](https://github.com/anolilab/lunora/tree/alpha) branch. Just don't build a production system on it yet.
  262. ## Contributing
  263. Start with [`.github/CONTRIBUTING.md`](./.github/CONTRIBUTING.md). The default branch is `alpha`, and PRs go there unless you are cutting a release.
  264. For security reports, see [`SECURITY.md`](./SECURITY.md). For community guidelines, see [`.github/CODE_OF_CONDUCT.md`](./.github/CODE_OF_CONDUCT.md). For brand assets and usage rules, see [`marketing/BRAND.md`](./marketing/BRAND.md).
  265. ## License
  266. Lunora is [Apache-2.0](./LICENSE.md) © 2026 anolilab and contributors.
  267. The Lunora Cloud service in [`apps/cloud/`](./apps/cloud) is licensed under [FSL-1.1-Apache-2.0](./apps/cloud/LICENSE.md): source-available now, and each release becomes Apache-2.0 two years after it ships.
  268. <!-- badges -->
  269. [typescript-badge]: https://img.shields.io/badge/Typescript-294E80.svg?style=for-the-badge&logo=typescript
  270. [typescript-url]: https://www.typescriptlang.org/
  271. [scorecard-badge]: https://api.scorecard.dev/projects/github.com/anolilab/lunora/badge?style=for-the-badge
  272. [scorecard]: https://scorecard.dev/viewer/?uri=github.com/anolilab/lunora
  273. [license-badge]: https://img.shields.io/badge/license-Apache--2.0-blue.svg?style=for-the-badge
  274. [license]: ./LICENSE.md
  275. [status-badge]: https://img.shields.io/badge/status-alpha-blueviolet.svg?style=for-the-badge
  276. [status]: #status
  277. [node-badge]: https://img.shields.io/badge/node-%5E22.15%20%7C%7C%20%3E%3D24.11-brightgreen.svg?style=for-the-badge
  278. [node]: ./package.json
  279. [pnpm-badge]: https://img.shields.io/badge/pnpm-11.15.0-f69220.svg?style=for-the-badge
  280. [pnpm]: ./package.json
  281. [ci-badge]: https://img.shields.io/github/actions/workflow/status/anolilab/lunora/test.yml?branch=alpha&style=for-the-badge&label=CI
  282. [ci]: https://github.com/anolilab/lunora/actions/workflows/test.yml
  283. [npm-version-badge]: https://img.shields.io/npm/v/lunorash/alpha?label=lunorash%40alpha&color=cb3837&style=for-the-badge
  284. [npm-version]: https://www.npmjs.com/package/lunorash
  285. [prs-welcome-badge]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=for-the-badge
  286. [prs-welcome]: https://github.com/anolilab/lunora/blob/alpha/.github/CONTRIBUTING.md

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.