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]

Merging this PR will improve performance by 14.19%

⚠️ Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 4 improved benchmarks
✅ 23 untouched benchmarks
⏩ 8 skipped benchmarks¹

Performance Changes

	Mode	Benchmark	BASE	HEAD	Efficiency
⚡	Simulation	test_from_event_type[event_spec]	49.2 µs	40.5 µs	+21.46%
⚡	Simulation	test_from_event_type[lambda_event_spec]	51.1 µs	42.7 µs	+19.62%
⚡	Simulation	test_from_event_type[event_handler]	91.9 µs	84.9 µs	+8.31%
⚡	Simulation	test_from_event_type[lambda_event_handler]	92.8 µs	85.9 µs	+8.04%

Tip

Curious why performance improved? Comment @codspeedbot explain why performance improved on this PR, or directly use the CodSpeed MCP with your agent.

---

_{Comparing benedikt-bartscher:explicit-event-id-minification (d5107c1) with main (9f7f82c)}

Footnotes

1. 8 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

[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

[greptile-apps]

Want your agent to iterate on Greptile's feedback? Try greploops.

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: af4219fac8

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[cubic-dev-ai]

1 issue found across 16 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="packages/reflex-base/src/reflex_base/utils/format.py">

<violation number="1" location="packages/reflex-base/src/reflex_base/utils/format.py:489">
P1: When forked registration contexts use different name resolvers, this handler-level cache leaks the formatted event name between apps. Key the cache by registration context/resolver, or remove the instance cache so each context resolves its own event name.</violation>
</file>

<sub>Reply with feedback, questions, or to request a fix.

Re-trigger cubic</sub>

[cubic-dev-ai]

P1: When forked registration contexts use different name resolvers, this handler-level cache leaks the formatted event name between apps. Key the cache by registration context/resolver, or remove the instance cache so each context resolves its own event name.

Prompt for AI agents

Check if this issue is valid — if so, understand the root cause and fix it. At packages/reflex-base/src/reflex_base/utils/format.py, line 489:

<comment>When forked registration contexts use different name resolvers, this handler-level cache leaks the formatted event name between apps. Key the cache by registration context/resolver, or remove the instance cache so each context resolves its own event name.</comment>

<file context>
@@ -444,43 +444,55 @@ def format_props(*single_props, **key_value_props) -> list[str]:
     Returns:
         The formatted function.
     """
+    cached = handler.__dict__.get(_FORMATTED_NAME_CACHE_ATTR)
+    if cached is not None:
+        return cached
</file context>

Suggested change

	cached = handler.__dict__.get(_FORMATTED_NAME_CACHE_ATTR)
	if cached is not None:
	return cached
	state, name = get_event_handler_parts(handler)
	if state == "":
	return name
	return f"{state}.{name}"
	full = name if state == "" else f"{state}.{name}"
	object.__setattr__(handler, _FORMATTED_NAME_CACHE_ATTR, full)
	return full
	state, name = get_event_handler_parts(handler)
	return name if state == "" else f"{state}.{name}"

[cubic-dev-ai]

All reported issues were addressed across 3 files (changes from recent commits).

<sub>Tip: Review your code locally with the cubic CLI to iterate faster.

Re-trigger cubic</sub>

[greptile-apps]

Event lookup fails lookup still walks every remaining segment as a state id, so the documented copied frontend event form remains broken. For a valid minified event name like a.bU, the first segment can resolve to the user state, but the final bU is an event id from config["events"], not a child state id in config["states"]. Because this loop only checks current.get_substates() and path_to_id, it exits with No state found for minified segment 'bU' instead of resolving the event handler. The command needs to treat the final segment as a handler id for the resolved state, or otherwise reject and document state-only paths.