Explicit state and event id minification

[benedikt-bartscher]

Summary

Add state and event name minification with CLI management tools.

• Introduces minify.json config file to map state/event names to short IDs (e.g., myapp.state.AppState → "a")
• Adds reflex minify CLI command group for managing minification
• Reduces frontend bundle size and WebSocket payload size by replacing long state/event paths with compact identifiers

CLI Commands

# Initialize minify.json with IDs for all states and events
reflex minify init

# Sync minify.json after code changes
reflex minify sync
reflex minify sync --prune --reassign-deleted

# Validate config against current codebase
reflex minify validate

# List state tree with minified names
reflex minify list
reflex minify list --json

# Lookup a minified path
reflex minify lookup "a.bU"

based on #6098

[codspeed-hq]

CodSpeed Performance Report

Merging this PR will not alter performance

_{Comparing benedikt-bartscher:explicit-event-id-minification (f964c7a) with main (5d1d6db)}

Summary

✅ 8 untouched benchmarks

[abulvenz]

Very tiny optical nit, cause sometimes EventHandlers is the last sub item.
It might work like this, didn't test it.

Suggested change

	console.log(f"{child_prefix}|-- Event Handlers:")
	console.log(f"{child_prefix}{'|' if has_substates else '`'}-- Event Handlers:")

[benedikt-bartscher]

TODO: best-effort-mode

• walk trough the state id registry after the app module get's imported
• filter out all states with explicit state id
• sort the remaining states without state id by full name
• assign state ids - start with the highest user defined state id - users might have fragmentation by choice

a similar thing can be implemented for event handler id's

edit: not that easy, as state names are baked into to many things (events, vars etc). we would need to defer init_subclass and possibly parts of @rx.var and @rx.event

edit2: i have found a better approach with a minify.json which makes this obsolete

[benedikt-bartscher]

Open for discussion: Should reflex reserve the first 5/10 state id's for internal states? Current reflex uses 0-3, but that might change in the future.

edit: with sibling uniqueness we would just need to reserve the state id's on the first rx.State subclass level.

edit2: i have found a better approach with a minify.json which makes this obsolete

[benedikt-bartscher]

TODO: think about sibling uniqueness for states. currently using global uniqueness

edit: adjusted in 6b4c5fa

[benedikt-bartscher]

Idea: store ids in a minify.json file

• allows overwriting state ids for upstream dependencies and reflex core
• one centralized place for the ids
• keep track of reserved numbers
• better automatic instrumentation - state and event ids can all be managed with cli - without manual code changes
• can be loaded once on startup and is frozen - probably faster
• no best effort mode needed

[benedikt-bartscher]

?

[greptile-apps]

Greptile Overview

Greptile Summary

This change updates the reflex minify CLI output to correctly count event handlers now that minify.json stores events nested under each state path (summing handler counts rather than using the top-level dict length).

The minify command group lives in reflex/reflex.py alongside other CLI groups and interacts with the broader minification system by loading the app (to register State subclasses) and then calling reflex.minify helpers to generate/sync/validate configurations.

Confidence Score: 3/5

• This PR has one functional issue in a user-facing CLI subcommand that should be fixed before merge.
• The event counting fix is straightforward, but reflex minify lookup appears to call State.get_class_substate() with a single segment even though it expects a full dotted path, which will break nested lookups.
• reflex/reflex.py

Important Files Changed

Filename	Overview
reflex/reflex.py	Fixes minify CLI event counting; minify_lookup substate resolution appears incorrect for multi-segment paths.
.gitignore	Adds uploaded_files/ to ignore list.
pyi_hashes.json	Updates generated stub hash entries.

Sequence Diagram

sequenceDiagram
  autonumber
  participant User
  participant CLI as reflex/reflex.py (click)
  participant Prereq as reflex.utils.prerequisites
  participant State as reflex.state.State
  participant Minify as reflex.minify
  participant FS as minify.json

  User->>CLI: reflex minify sync/validate/init
  CLI->>Prereq: get_app() (register State subclasses)
  Prereq->>State: import app / build state tree
  CLI->>Minify: generate/sync/validate config
  Minify->>FS: read/write minify.json
  Minify-->>CLI: config/errors/warnings
  CLI-->>User: log counts/results

Loading

[greptile-apps]

_{3 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}