Skip to content
This repository was archived by the owner on Oct 22, 2025. It is now read-only.

Commit e203024

Browse files
committed
chore: remove remaining uses of "ActorCore"
1 parent a19ff3b commit e203024

File tree

50 files changed

+446
-523
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+446
-523
lines changed

CHANGELOG.md

Lines changed: 243 additions & 243 deletions
Large diffs are not rendered by default.

CLAUDE.md

Lines changed: 25 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,49 @@
1-
# ActorCore Development Guide
1+
# RivetKit Development Guide
22

33
## Project Naming
44

5-
- Use `ActorCore` when referring to the project in documentation and plain English
6-
- Use `actor-core` (kebab-case) when referring to the project in code, package names, and imports
5+
- Use `RivetKit` when referring to the project in documentation and plain English
6+
- Use `rivetkit` when referring to the project in code, package names, and imports
77

88
## Common Terminology
99

10-
- **Actor**: A stateful, long-lived entity that processes messages and maintains state
11-
- **Manager**: Component responsible for creating, routing, and managing actor instances
12-
- **Remote Procedure Call (RPC)**: Method for an actor to expose callable functions to clients
13-
- **Event**: Asynchronous message sent from an actor to connected clients
10+
- **Worker**: A stateful, long-lived entity that processes messages and maintains state
11+
- **Manager**: Component responsible for creating, routing, and managing worker instances
12+
- **Remote Procedure Call (RPC)**: Method for an worker to expose callable functions to clients
13+
- **Event**: Asynchronous message sent from an worker to connected clients
1414
- **Alarm**: Scheduled callback that triggers at a specific time
1515

1616
### Coordinated Topology Terminology
1717

18-
- **Peer**: Individual actor instance in a coordinated network
19-
- **Node**: Physical or logical host running one or more actor peers
18+
- **Peer**: Individual worker instance in a coordinated network
19+
- **Node**: Physical or logical host running one or more worker peers
2020

2121
## Build Commands
2222

2323
- **Type Check:** `yarn check-types` - Verify TypeScript types
24-
- **Check specific package:** `yarn check-types -F actor-core` - Check only specified package
24+
- **Check specific package:** `yarn check-types -F rivetkit` - Check only specified package
2525
- **Build:** `yarn build` - Production build using Turbopack
26-
- **Build specific package:** `yarn build -F actor-core` - Build only specified package
26+
- **Build specific package:** `yarn build -F rivetkit` - Build only specified package
2727
- **Format:** `yarn fmt` - Format code with Biome
2828
- Do not run the format command automatically.
2929

3030
## Core Concepts
3131

3232
### Topologies
3333

34-
Actor-Core supports three topologies that define how actors communicate and scale:
34+
rivetkit supports three topologies that define how workers communicate and scale:
3535

36-
- **Singleton:** A single instance of an actor running in one location
37-
- **Partition:** Multiple instances of an actor type partitioned by ID, useful for horizontal scaling
38-
- **Coordinate:** Actors connected in a peer-to-peer network, sharing state between instances
36+
- **Singleton:** A single instance of an worker running in one location
37+
- **Partition:** Multiple instances of an worker type partitioned by ID, useful for horizontal scaling
38+
- **Coordinate:** Workers connected in a peer-to-peer network, sharing state between instances
3939

4040
### Driver Interfaces
4141

42-
Driver interfaces define the contract between Actor-Core and various backends:
42+
Driver interfaces define the contract between rivetkit and various backends:
4343

44-
- **ActorDriver:** Manages actor state, lifecycle, and persistence
45-
- **ManagerDriver:** Manages actor discovery, routing, and scaling
46-
- **CoordinateDriver:** Handles peer-to-peer communication between actor instances
44+
- **WorkerDriver:** Manages worker state, lifecycle, and persistence
45+
- **ManagerDriver:** Manages worker discovery, routing, and scaling
46+
- **CoordinateDriver:** Handles peer-to-peer communication between worker instances
4747

4848
### Driver Implementations
4949

@@ -54,7 +54,7 @@ Located in `packages/drivers/`, these implement the driver interfaces:
5454

5555
### Platforms
5656

57-
Located in `packages/platforms/`, these adapt Actor-Core to specific runtime environments:
57+
Located in `packages/platforms/`, these adapt rivetkit to specific runtime environments:
5858

5959
- **NodeJS:** Standard Node.js server environment
6060
- **Cloudflare Workers:** Edge computing environment
@@ -83,28 +83,28 @@ This ensures imports resolve correctly across different build environments and p
8383
- UPPER_CASE for constants
8484
- Use `#` prefix for private class members (not `private` keyword)
8585
- **Error Handling:**
86-
- Extend from `ActorError` base class
86+
- Extend from `WorkerError` base class
8787
- Use `UserError` for client-safe errors
8888
- Use `InternalError` for internal errors
8989
- Don't try to fix type issues by casting to unknown or any. If you need to do this, then stop and ask me to manually intervene.
9090
- Write log messages in lowercase
91-
- Instead of returning raw HTTP responses with c.json, use or write an error in packages/actor-core/src/actor/errors.ts and throw that instead. The middleware will automatically serialize the response for you.
91+
- Instead of returning raw HTTP responses with c.json, use or write an error in packages/rivetkit/src/worker/errors.ts and throw that instead. The middleware will automatically serialize the response for you.
9292

9393
## Project Structure
9494

9595
- Monorepo with Yarn workspaces and Turborepo
96-
- Core code in `packages/actor-core/`
96+
- Core code in `packages/rivetkit/`
9797
- Platform implementations in `packages/platforms/`
9898
- Driver implementations in `packages/drivers/`
9999

100100
## Development Notes
101101

102-
- Prefer classes over factory functions
102+
- Prefer classes over fworkery functions
103103
- Use zod for runtime type validation
104104
- Use `assertUnreachable(x: never)` for exhaustive type checking in switch statements
105105
- Follow existing patterns for P2P networking
106106
- Add proper JSDoc comments for public APIs
107107
- Ensure proper error handling with descriptive messages
108108
- Run `yarn check-types` regularly during development to catch type errors early. Prefer `yarn check-types` instead of `yarn build`.
109109
- Use `tsx` CLI to execute TypeScript scripts directly (e.g., `tsx script.ts` instead of `node script.js`).
110-
- Do not auto-commit changes
110+
- Do not auto-commit changes

README.md

Lines changed: 35 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
<div align="center">
2-
<a href="https://actorcore.org">
2+
<a href="https://rivetkit.org">
33
<picture>
4-
<source media="(prefers-color-scheme: dark)" srcset="./.github/media/icon-text-white.svg" alt="ActorCore" width="250">
5-
<img src="./.github/media/icon-text-white.svg" alt="ActorCore" width="400">
4+
<source media="(prefers-color-scheme: dark)" srcset="./.github/media/icon-text-white.svg" alt="RivetKit" width="250">
5+
<img src="./.github/media/icon-text-white.svg" alt="RivetKit" width="400">
66
</picture>
77
</a>
88
<h2>Stateful Serverless That Runs Anywhere</h2>
@@ -12,9 +12,9 @@
1212
</p>
1313

1414
<p>
15-
<a href="https://actorcore.org/overview">Documentation</a> •
15+
<a href="https://rivetkit.org/overview">Documentation</a> •
1616
<a href="https://discord.gg/rivet">Discord</a> •
17-
<a href="https://x.com/ActorCore_org">X</a> •
17+
<a href="https://x.com/RivetKit_org">X</a> •
1818
<a href="https://bsky.app/">Bluesky</a>
1919
</p>
2020
</div>
@@ -23,9 +23,9 @@
2323

2424
**Start By Framework**
2525

26-
- <img src="docs/images/clients/react.svg" height="16" alt="React" />&nbsp;&nbsp;[React](https://actorcore.org/frameworks/react)
27-
- <img src="docs/images/clients/javascript.svg" height="16" alt="Node.js" />&nbsp;&nbsp;[Node.js & Bun](https://actorcore.org/clients/javascript)
28-
- <img src="docs/images/clients/rust.svg" height="16" alt="Rust" />&nbsp;&nbsp;[Rust](https://actorcore.org/clients/rust)
26+
- <img src="docs/images/clients/react.svg" height="16" alt="React" />&nbsp;&nbsp;[React](https://rivetkit.org/frameworks/react)
27+
- <img src="docs/images/clients/javascript.svg" height="16" alt="Node.js" />&nbsp;&nbsp;[Node.js & Bun](https://rivetkit.org/clients/javascript)
28+
- <img src="docs/images/clients/rust.svg" height="16" alt="Rust" />&nbsp;&nbsp;[Rust](https://rivetkit.org/clients/rust)
2929

3030
**Start With Studio**
3131

@@ -81,7 +81,7 @@ No servers to manage. Your code runs on-demand and scales automatically with usa
8181

8282
## Examples
8383

84-
Browse snippets for how to use ActorCore with different use cases.
84+
Browse snippets for how to use RivetKit with different use cases.
8585

8686
| Example | Actor (JavaScript) | Actor (SQLite) | Frontend (React) |
8787
|---------|------------|--------|-------|
@@ -100,33 +100,33 @@ _SQLite will be available in June. We’re working on publishing full examples r
100100

101101
## Runs On Your Stack
102102

103-
Deploy ActorCore anywhere - from serverless platforms to your own infrastructure. Don't see the runtime you want? [Add your own](http://localhost:3000/drivers/build).
103+
Deploy RivetKit anywhere - from serverless platforms to your own infrastructure. Don't see the runtime you want? [Add your own](http://localhost:3000/drivers/build).
104104

105105
### All-In-One
106106
- <img src="docs/images/platforms/rivet-white.svg" height="16" alt="Rivet" />&nbsp;&nbsp;[Rivet](/platforms/rivet)
107107
- <img src="docs/images/platforms/cloudflare-workers.svg" height="16" alt="Cloudflare Workers" />&nbsp;&nbsp;[Cloudflare Workers](/platforms/cloudflare-workers)
108108

109109
### Compute
110-
- <img src="docs/images/platforms/vercel.svg" height="16" alt="Vercel" />&nbsp;&nbsp;[Vercel](https://github.com/rivet-gg/actor-core/issues/897) *(On The Roadmap)*
111-
- <img src="docs/images/platforms/aws-lambda.svg" height="16" alt="AWS Lambda" />&nbsp;&nbsp;[AWS Lambda](https://github.com/rivet-gg/actor-core/issues/898) *(On The Roadmap)*
112-
- <img src="docs/images/platforms/supabase.svg" height="16" alt="Supabase" />&nbsp;&nbsp;[Supabase](https://github.com/rivet-gg/actor-core/issues/905) *(Help Wanted)*
110+
- <img src="docs/images/platforms/vercel.svg" height="16" alt="Vercel" />&nbsp;&nbsp;[Vercel](https://github.com/rivet-gg/rivetkit/issues/897) *(On The Roadmap)*
111+
- <img src="docs/images/platforms/aws-lambda.svg" height="16" alt="AWS Lambda" />&nbsp;&nbsp;[AWS Lambda](https://github.com/rivet-gg/rivetkit/issues/898) *(On The Roadmap)*
112+
- <img src="docs/images/platforms/supabase.svg" height="16" alt="Supabase" />&nbsp;&nbsp;[Supabase](https://github.com/rivet-gg/rivetkit/issues/905) *(Help Wanted)*
113113
- <img src="docs/images/platforms/bun.svg" height="16" alt="Bun" />&nbsp;&nbsp;[Bun](/platforms/bun)
114114
- <img src="docs/images/platforms/nodejs.svg" height="16" alt="Node.js" />&nbsp;&nbsp;[Node.js](/platforms/nodejs)
115115

116116
### Storage
117117
- <img src="docs/images/platforms/redis.svg" height="16" alt="Redis" />&nbsp;&nbsp;[Redis](/drivers/redis)
118-
- <img src="docs/images/platforms/postgres.svg" height="16" alt="Postgres" />&nbsp;&nbsp;[Postgres](https://github.com/rivet-gg/actor-core/issues/899) *(Help Wanted)*
118+
- <img src="docs/images/platforms/postgres.svg" height="16" alt="Postgres" />&nbsp;&nbsp;[Postgres](https://github.com/rivet-gg/rivetkit/issues/899) *(Help Wanted)*
119119
- <img src="docs/images/platforms/file-system.svg" height="16" alt="File System" />&nbsp;&nbsp;[File System](/drivers/file-system)
120120
- <img src="docs/images/platforms/memory.svg" height="16" alt="Memory" />&nbsp;&nbsp;[Memory](/drivers/memory)
121121

122122
## Works With Your Tools
123123

124-
Seamlessly integrate ActorCore with your favorite frameworks, languages, and tools. Don't see what you need? [Request an integration](https://github.com/rivet-gg/actor-core/issues/new).
124+
Seamlessly integrate RivetKit with your favorite frameworks, languages, and tools. Don't see what you need? [Request an integration](https://github.com/rivet-gg/rivetkit/issues/new).
125125

126126
### Frameworks
127127
- <img src="docs/images/clients/react.svg" height="16" alt="React" />&nbsp;&nbsp;[React](/frameworks/react)
128-
- <img src="docs/images/clients/nextjs.svg" height="16" alt="Next.js" />&nbsp;&nbsp;[Next.js](https://github.com/rivet-gg/actor-core/issues/904) *(Help Wanted)*
129-
- <img src="docs/images/clients/vue.svg" height="16" alt="Vue" />&nbsp;&nbsp;[Vue](https://github.com/rivet-gg/actor-core/issues/903) *(Help Wanted)*
128+
- <img src="docs/images/clients/nextjs.svg" height="16" alt="Next.js" />&nbsp;&nbsp;[Next.js](https://github.com/rivet-gg/rivetkit/issues/904) *(Help Wanted)*
129+
- <img src="docs/images/clients/vue.svg" height="16" alt="Vue" />&nbsp;&nbsp;[Vue](https://github.com/rivet-gg/rivetkit/issues/903) *(Help Wanted)*
130130

131131
### Clients
132132
- <img src="docs/images/clients/javascript.svg" height="16" alt="JavaScript" />&nbsp;&nbsp;[JavaScript](/clients/javascript)
@@ -138,14 +138,14 @@ Seamlessly integrate ActorCore with your favorite frameworks, languages, and too
138138
- <img src="docs/images/integrations/hono.svg" height="16" alt="Hono" />&nbsp;&nbsp;[Hono](/integrations/hono)
139139
- <img src="docs/images/integrations/vitest.svg" height="16" alt="Vitest" />&nbsp;&nbsp;[Vitest](/concepts/testing)
140140
- <img src="docs/images/integrations/resend.svg" height="16" alt="Resend" />&nbsp;&nbsp;[Resend](/integrations/resend)
141-
- <img src="docs/images/integrations/better-auth.svg" height="16" alt="Better Auth" />&nbsp;&nbsp;[Better Auth](https://github.com/rivet-gg/actor-core/issues/906) *(On The Roadmap)*
142-
- <img src="docs/images/platforms/vercel.svg" height="16" alt="AI SDK" />&nbsp;&nbsp;[AI SDK](https://github.com/rivet-gg/actor-core/issues/907) *(On The Roadmap)*
141+
- <img src="docs/images/integrations/better-auth.svg" height="16" alt="Better Auth" />&nbsp;&nbsp;[Better Auth](https://github.com/rivet-gg/rivetkit/issues/906) *(On The Roadmap)*
142+
- <img src="docs/images/platforms/vercel.svg" height="16" alt="AI SDK" />&nbsp;&nbsp;[AI SDK](https://github.com/rivet-gg/rivetkit/issues/907) *(On The Roadmap)*
143143

144144
### Local-First Sync
145-
- <img src="docs/images/integrations/livestore.svg" height="16" alt="LiveStore" />&nbsp;&nbsp;[LiveStore](https://github.com/rivet-gg/actor-core/issues/908) *(Available In June)*
146-
- <img src="docs/images/integrations/zerosync.svg" height="16" alt="ZeroSync" />&nbsp;&nbsp;[ZeroSync](https://github.com/rivet-gg/actor-core/issues/909) *(Help Wanted)*
147-
- <img src="docs/images/integrations/tinybase.svg" height="16" alt="TinyBase" />&nbsp;&nbsp;[TinyBase](https://github.com/rivet-gg/actor-core/issues/910) *(Help Wanted)*
148-
- <img src="docs/images/integrations/yjs.svg" height="16" alt="Yjs" />&nbsp;&nbsp;[Yjs](https://github.com/rivet-gg/actor-core/issues/911) *(Help Wanted)*
145+
- <img src="docs/images/integrations/livestore.svg" height="16" alt="LiveStore" />&nbsp;&nbsp;[LiveStore](https://github.com/rivet-gg/rivetkit/issues/908) *(Available In June)*
146+
- <img src="docs/images/integrations/zerosync.svg" height="16" alt="ZeroSync" />&nbsp;&nbsp;[ZeroSync](https://github.com/rivet-gg/rivetkit/issues/909) *(Help Wanted)*
147+
- <img src="docs/images/integrations/tinybase.svg" height="16" alt="TinyBase" />&nbsp;&nbsp;[TinyBase](https://github.com/rivet-gg/rivetkit/issues/910) *(Help Wanted)*
148+
- <img src="docs/images/integrations/yjs.svg" height="16" alt="Yjs" />&nbsp;&nbsp;[Yjs](https://github.com/rivet-gg/rivetkit/issues/911) *(Help Wanted)*
149149

150150
## Local Development with the Studio
151151

@@ -157,24 +157,24 @@ Seamlessly integrate ActorCore with your favorite frameworks, languages, and too
157157

158158
## Join the Community
159159

160-
Help make ActorCore the universal way to build & scale stateful serverless applications.
160+
Help make RivetKit the universal way to build & scale stateful serverless applications.
161161

162162
- [Discord](https://rivet.gg/discord)
163-
- [X](https://x.com/ActorCore_org)
163+
- [X](https://x.com/RivetKit_org)
164164
- [Bluesky](https://bsky.app/profile/rivet.gg)
165-
- [Discussions](https://github.com/rivet-gg/actor-core/discussions)
166-
- [Issues](https://github.com/rivet-gg/actor-core/issues)
165+
- [Discussions](https://github.com/rivet-gg/rivetkit/discussions)
166+
- [Issues](https://github.com/rivet-gg/rivetkit/issues)
167167

168168
## Frequently Asked Questions
169169

170170
<details>
171-
<summary><strong>How is ActorCore different than Rivet Actors?</strong></summary>
171+
<summary><strong>How is RivetKit different than Rivet Actors?</strong></summary>
172172

173-
ActorCore is a framework written in TypeScript that provides high-level functionality. Rivet is an open-source serverless platform written in Rust with features tailored for stateful serverless.
173+
RivetKit is a framework written in TypeScript that provides high-level functionality. Rivet is an open-source serverless platform written in Rust with features tailored for stateful serverless.
174174

175-
You can think of it as ActorCore is to Rivet as Next.js is to Vercel.
175+
You can think of it as RivetKit is to Rivet as Next.js is to Vercel.
176176

177-
While Rivet is the primary maintainer of ActorCore, we intend for this to be community driven.
177+
While Rivet is the primary maintainer of RivetKit, we intend for this to be community driven.
178178
</details>
179179

180180
<details>
@@ -192,7 +192,7 @@ Sometimes it makes sense to use stateless serverless to make requests to multipl
192192
</details>
193193

194194
<details>
195-
<summary><strong>How does ActorCore achieve huge performance gains?</strong></summary>
195+
<summary><strong>How does RivetKit achieve huge performance gains?</strong></summary>
196196

197197
By storing state in memory and flushing to a persistence layer, we can serve requests instantly instead of waiting for a round trip to the database. There are additional optimizations that can be made around your state to tune the durability of it.
198198

@@ -225,12 +225,12 @@ Yes, but only as much as storing data in a single database row does. We're worki
225225
Things are cooking! Check out our [blog post](https://rivet.gg/blog/2025-03-23-what-would-a-w3c-standard-look-like-for-stateful-serverless-) about what a W3C standard for stateful serverless might look like and [the awesome people who are collaborating on this](https://x.com/threepointone/status/1903579571028390038).
226226
</details>
227227

228-
Have more questions? Join our [Discord](https://discord.gg/rivet) or go to [GitHub Discussions](https://github.com/rivet-gg/actor-core/discussions).
228+
Have more questions? Join our [Discord](https://discord.gg/rivet) or go to [GitHub Discussions](https://github.com/rivet-gg/rivetkit/discussions).
229229

230230
## Roadmap For 2025
231231

232232
We ship fast, so we want to share what you can expect to see before the end of the year.
233-
Help shape our roadmap by [creating issues](https://github.com/rivet-gg/actor-core/issues) and [joining our Discord](https://rivet.gg/discord).
233+
Help shape our roadmap by [creating issues](https://github.com/rivet-gg/rivetkit/issues) and [joining our Discord](https://rivet.gg/discord).
234234

235235
- [ ] SQLite Support
236236
- [ ] SQLite in Studio
@@ -260,13 +260,11 @@ Help shape our roadmap by [creating issues](https://github.com/rivet-gg/actor-co
260260
- [X] Resend Integration
261261
- [X] Vitest Integration
262262
- [X] Non-serialized state
263-
- [X] `create-actor`
264-
- [X] `actor-core dev`
265263
- [X] Hono Integration
266264

267265
## License
268266

269267
Apache 2.0
270268

271-
_Scale without drama – only with ActorCore._
269+
_Scale without drama – only with RivetKit._
272270

clients/python/Cargo.toml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,9 @@
22
# this package, with the aid of pyo3
33
#
44
# This package turns into the python
5-
# pypi actor-core-client package
5+
# pypi rivetkit-client package
66
[package]
7-
name = "python-actor-core-client"
7+
name = "python-rivetkit-client"
88
version = "0.9.0-rc.1"
99
edition = "2021"
1010
publish = false
@@ -14,7 +14,7 @@ name = "actor_core_client"
1414
crate-type = ["cdylib"]
1515

1616
[dependencies]
17-
actor-core-client = { path = "../rust/" }
17+
rivetkit-client = { path = "../rust/" }
1818
futures-util = "0.3.31"
1919
once_cell = "1.21.3"
2020
pyo3 = { version = "0.24.0", features = ["extension-module"] }

0 commit comments

Comments
 (0)