Getting Started
    Core Concepts
    Building Features
    API Reference
    Deployment
    Upgrading
    Migrating
    Pro
    Advanced Topics
    Misc
    Configuration
    Guides
    Shakacode logoShakaCodeDeveloped by

    Copyright 2026 ShakaCode

    Deprecated Configuration Options

    This document lists configuration options that have been deprecated or removed from React on Rails.

    For current configuration options, see configuration.md.

    Removed Options

    immediate_hydration

    Status: ⚠️ REMOVED in v17.0

    This configuration option has been removed. Immediate hydration is now automatically enabled for Pro users and disabled for non-Pro users.

    Migration: Remove any config.immediate_hydration lines from your configuration. Use per-component overrides if needed:

    # Pro users can disable for specific components:
    react_component("MyComponent", immediate_hydration: false)
    
    # Non-Pro users: immediate_hydration is ignored

    See CHANGELOG.md for details.

    Deprecated Options

    defer_generated_component_packs

    Type: Boolean Default: false Status: ⚠️ DEPRECATED

    Renamed to: generated_component_packs_loading_strategy = :defer

    Migration:

    # Old (deprecated):
    config.defer_generated_component_packs = true
    
    # New:
    config.generated_component_packs_loading_strategy = :defer

    See CHANGELOG.md for more details.

    Need Help?