--- title: "Framework-recipe troubleshooting: SSR failures by symptom" description: "Every failure below is one we've actually hit. Cross-reference the five universal rules. Most SSR failures reduce to violating one of them." url: "https://www.contentstack.com/docs/studio/framework-recipe-troubleshooting" product: "Contentstack" doc_type: "guide" audience: - developers - admins version: "current" last_updated: "2026-09-14" --- # Framework-recipe troubleshooting: SSR failures by symptom Every failure below is one we've actually hit. Cross-reference the [five universal rules](/docs/studio/framework-recipes#five-universal-rules): most SSR failures reduce to violating one of them. * * * ## Attempted to call X() from the server **Symptom:** the server bundle throws at render time with a name like useState, useEffect, or a Studio internal (useBoundValue, useResolvedSpec). **Cause:** a client-only API landed in the server graph. Pre-#871 SDK versions had dist entries that could pull client-side hooks into the server bundle via a subpath import. Fixed in the dist-ESM restructure (#871, #874). **Fix:** upgrade @contentstack/studio-react to the version that shipped the RSC recipe (check the CHANGELOG for dist-esm fixes referenced in the RSC example app). If you're pinned to an older version, temporarily switch to the [Node recipe](/docs/studio/framework-recipe-node) which doesn't rely on the RSC dist entry. * * * ## Internal components missing **Symptom:** render throws with a message about missing built-ins (Page, Section, Repeater not found in the registry). Sometimes surfaces as a generic "component \_page not registered." **Cause:** [Rule 2](/docs/studio/framework-recipes#rule-2-root-import-required) violation. A server bundle or client bundle imported a subpath (@contentstack/studio-react/rsc or a hand-picked type) but never imported the package root. Built-ins register on first root import. Without one, the registry is empty. **Fix:** add import "@contentstack/studio-react"; at the top of every registration module. Verify each module graph has at least one root import: ``` # Grep both server and client entry files. grep -r 'from "@contentstack/studio-react"' src/ | grep -v '/rsc"' | head ``` Every top-level entry (server.tsx, app/layout.tsx, entry.server.tsx, \_app.tsx, an island component) must contain at least one match. * * * ## Unstyled first paint (FOUC) **Symptom:** the composition renders correctly but flashes unstyled for a beat before design-panel tokens apply. curl shows the composition HTML but no