refactor: icons chunk

[jog1t]

Description

Please include a summary of the changes and the related issue. Please also include relevant motivation and context.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[railway-app]

🚅 Deployed to the rivet-pr-4567 environment in rivet-frontend

Service	Status	Web	Updated (UTC)
kitchen-sink	❌ Build Failed (View Logs)	Web	Apr 15, 2026 at 3:11 pm
frontend-cloud	😴 Sleeping (View Logs)	Web	Apr 15, 2026 at 3:10 pm
frontend-inspector	😴 Sleeping (View Logs)	Web	Apr 15, 2026 at 3:04 pm
ladle	❌ Build Failed (View Logs)	Web	Apr 15, 2026 at 2:53 pm
website	😴 Sleeping (View Logs)	Web	Apr 15, 2026 at 2:51 pm
mcp-hub	✅ Success (View Logs)	Web	Apr 14, 2026 at 7:46 pm

[jog1t]

• feat: dev toolbar #4325
• refactor: icons chunk #4567 👈 (View in Graphite)
• refactor(frontend): actor list uplift #4511
• feat(frontend): logs uplift #4504
• refactor: uplift metrics #4499 : 1 other dependent PR (#4503 )
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[pkg-pr-new]

More templates

• actor-actions
• actor-actions-vercel
• ai-agent
• ai-agent-vercel
• example-ai-and-user-generated-actors-freestyle
• chat-room
• chat-room-vercel
• example-cloudflare-workers
• example-cloudflare-workers-hono
• collaborative-document
• collaborative-document-vercel
• cross-actor-actions
• cross-actor-actions-vercel
• example-cursors
• example-cursors-raw-websocket
• example-cursors-raw-websocket-vercel
• example-cursors-vercel
• custom-serverless
• example-elysia
• example-experimental-durable-streams-ai-agent
• example-experimental-durable-streams-ai-agent-vercel
• geo-distributed-database
• geo-distributed-database-vercel
• hello-world
• hello-world-vercel
• example-hono
• hono-react
• hono-react-vercel
• example-kitchen-sink
• example-kitchen-sink-vercel
• multi-region-vercel
• multiplayer-game
• example-multiplayer-game-patterns
• example-multiplayer-game-patterns-vercel
• multiplayer-game-vercel
• native-websockets
• native-websockets-vercel
• next-js
• per-tenant-database
• per-tenant-database-vercel
• example-raw-fetch-handler
• example-raw-fetch-handler-vercel
• example-raw-websocket-handler
• example-raw-websocket-handler-proxy
• example-raw-websocket-handler-proxy-vercel
• example-raw-websocket-handler-vercel
• example-react
• example-react-vercel
• sandbox
• sandbox-coding-agent
• sandbox-coding-agent-vercel
• sandbox-vercel
• scheduling
• scheduling-vercel
• example-sqlite-drizzle
• example-sqlite-raw
• state
• state-vercel
• example-stream
• example-stream-vercel
• example-trpc

@rivetkit/cloudflare-workers

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/cloudflare-workers@4567

@rivetkit/framework-base

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/framework-base@4567

@rivetkit/next-js

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/next-js@4567

@rivetkit/react

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/react@4567

rivetkit

pnpm add https://pkg.pr.new/rivet-dev/rivet/rivetkit@4567

@rivetkit/sql-loader

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sql-loader@4567

@rivetkit/sqlite-vfs

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sqlite-vfs@4567

@rivetkit/traces

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/traces@4567

@rivetkit/workflow-engine

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/workflow-engine@4567

@rivetkit/virtual-websocket

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/virtual-websocket@4567

@rivetkit/engine-runner

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner@4567

@rivetkit/engine-runner-protocol

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner-protocol@4567

commit: e46d451

[claude]

Code Review: refactor: icons chunk

Overview

This PR refactors frontend/packages/icons (the @rivet-gg/icons package) from a monolithic bundle to individual per-icon chunk files. The motivation, stated in scripts/vendor-icons.js, is that by bundling FontAwesome Pro SVG data into self-contained dist/icons/fa*.js files and committing them, consumers no longer need a FontAwesome Pro token. The new ./icons/*.js subpath export also enables better tree-shaking.

The diff is enormous (334K additions, 151K deletions) but is entirely generated output from the vendor script, not hand-written code.

---

Issues

1. Missing dist/index.js in the PR

The vendor script explicitly creates dist/index.js as a barrel re-exporting all icons and the Icon component, and lists it as a required build output. package.json declares "main": "./dist/index.js". However, dist/index.js is not among the PR changes. If it was deleted as part of replacing the old monolithic bundle but not re-committed, the package default entry point is broken for consumers. Please verify and include it.

2. Repeated esbuild boilerplate inflates the repo significantly

Each of the ~3000 icon files is ~67 lines, of which ~58 are identical esbuild CommonJS interop helpers (__create, __defProp, __copyProps, etc.). This is roughly 174K lines of duplicated boilerplate. Consider building with splitting: true and format: 'esm' so esbuild emits a shared chunk file instead. This would substantially reduce the committed diff size on future regenerations.

3. No TypeScript declarations for ./icons/*.js subpath exports

The package.json exports field includes "./icons/*.js" for individual icon imports but has no "types" entry for that subpath. TypeScript consumers doing a subpath import like import { definition } from '@rivet-gg/icons/icons/faActors.js' will get no type information. Either generate .d.ts files per icon or add a wildcard types entry pointing to a declaration stub.

4. Package name uses deprecated @rivet-gg namespace

The package is named @rivet-gg/icons. Per CLAUDE.md, rivet-gg is deprecated. This is a pre-existing issue not introduced by this PR, but since the package is being actively updated this is a good opportunity to rename it with a major version bump.

---

Observations

• dist/icon-component.js is a clean extraction of the Icon React wrapper into its own entry point, good for tree-shaking.
• The vendor script approach is sound: committing generated dist files so consumers need no FA Pro token is well-motivated and documented with legal notices.
• The PR description is empty with all checklist items unchecked. Please add a brief summary of what changed and why so future contributors understand why 3000 files are committed.

---

Summary

The chunking approach is architecturally solid. Two blockers before merging:

1. Confirm dist/index.js is present and correct; add it to this PR if it was inadvertently excluded.
2. Add TypeScript type coverage for ./icons/*.js subpath exports, or document the gap explicitly.

The boilerplate repetition and namespace issues are non-blocking but worth a follow-up ticket.

[github-actions]

Preview packages published to npm

Install with:

npm install rivetkit@pr-4567

All packages published as 0.0.0-pr.4567.4c10a30 with tag pr-4567.

Engine binary is shipped via @rivetkit/engine-cli on linux-x64-musl, linux-arm64-musl, darwin-x64, and darwin-arm64. Windows users should use the release installer or set RIVET_ENGINE_BINARY.

Docker images:

docker pull rivetdev/engine:slim-4c10a30
docker pull rivetdev/engine:full-4c10a30

Individual packages

npm install rivetkit@pr-4567
npm install @rivetkit/react@pr-4567
npm install @rivetkit/rivetkit-native@pr-4567
npm install @rivetkit/sqlite-wasm@pr-4567
npm install @rivetkit/workflow-engine@pr-4567

[jog1t]

Merge activity

• Apr 15, 3:02 PM UTC: A user started a stack merge that includes this pull request via Graphite.
• Apr 15, 3:11 PM UTC: Graphite rebased this pull request as part of a merge.
• Apr 15, 3:12 PM UTC: @jog1t merged this pull request with Graphite.