From 0d35334ba7870a058356ca4e1ce26abdb4c9ca6f Mon Sep 17 00:00:00 2001 From: Adam Wootton Date: Wed, 6 Nov 2024 13:50:57 -0500 Subject: [PATCH] Update nextjs-usage-app.md (#776) --- docs/sdk/client-side-sdks/nextjs/nextjs-usage-app.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/sdk/client-side-sdks/nextjs/nextjs-usage-app.md b/docs/sdk/client-side-sdks/nextjs/nextjs-usage-app.md index 2f270101..c45bb4df 100644 --- a/docs/sdk/client-side-sdks/nextjs/nextjs-usage-app.md +++ b/docs/sdk/client-side-sdks/nextjs/nextjs-usage-app.md @@ -223,16 +223,15 @@ trigger your build process. ## Advanced ### Non-Blocking Initialization -If you wish to render your page without waiting for the DevCycle configuration to be retrieved, you can use the +If you wish to render your page without waiting for the DevCycle configuration to be retrieved, or your "user getter" to resolve, you can use the `enableStreaming` option. Doing so enables the following behaviour: -- the `DevCycleClientsideProvider` will not block rendering of the rest of the server component tree and will trigger the -nearest `Suspense` boundary while the config is being retrieved. +- the `DevCycleClientsideProvider` will not block rendering of the rest of the component tree and will trigger the +nearest `Suspense` boundary while the config is being retrieved or your user getter is being evaluated. - any calls to `getVariableValue` in server components or `useVariableValue` in client components - will trigger the nearest `Suspense` boundary while the config being retrieved. The component will then stream to + will trigger the nearest `Suspense` boundary while the config and user are being retrieved. The component will then stream to the client once the config is retrieved. -Note: The DevCycle initialization process is normally very fast (less than 50ms, less than 1ms when cached). -Only use this option if your application is very performance sensitive. +This option is recommended if your user retrieval operation is slow enough to delay the page response. Retrieving the DevCycle configuration is normally very fast (less than 50ms) and is unlikely to contribute to delaying the response. ### Conditional Deferred Rendering (renderIfEnabled) When a user makes a request for your application, they are sent the client bundle containing source code for the whole