Astro Code component fails inside a React component
Astro components cannot be rendered directly via function callShort answer
Astro components such as Code only exist on the server and render static HTML. You cannot import a .astro component into a React file or call it like a function. Use Code in an .astro file, and pass the result into your React component as children or a named slot.
Fix it fast
1Find out which cause you have
Find the file where Code is imported. If it ends in .jsx or .tsx, that is the problem.
grep -rn "astro:components" src/ | grep -v "\.astro:"2Match what you see, then jump to its fix
What does the error look like?
Astro components cannot be rendered directly via function call
Cause 1 of 2
Code is imported inside a React file
1Check
The Astro docs say .astro components cannot be imported into a UI framework component such as .jsx or .svelte.
grep -rln "from 'astro:components'" src/2Fix
Move the use of Code into an .astro file. The import and the props go in the frontmatter and the template.
---
import { Code } from 'astro:components';
---
<Code code={`const foo = 'bar';`} lang="js" />3Verify
Restart the dev server. The page renders highlighted code.
npm run devConfirmed by docs.astro.build
Cause 2 of 2
The React component needs to show highlighted code
1Check
Astro markup can be passed to a framework component as children or a named slot, but only from an .astro file.
grep -rn "slot=" src/2Fix
Wrap the React component in the .astro page and put Code inside it as a child.
---
import { Code } from 'astro:components';
import Card from '../components/Card.jsx';
---
<Card>
<Code code={`npm run build`} lang="bash" />
</Card>3Verify
The card renders and the code inside is highlighted.
npm run buildConfirmed by docs.astro.build
How do I stop it coming back?
- Keep Astro components in .astro files and let React components take children.
- Remember that Astro components render to static HTML and have no client-side runtime.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.
Which stack is behind this page?
Projects of mine built on the same technologies:
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- QistLockA NestJS and React SaaS driving an Android Device Owner agent that locks financed phones when payments lapse.
- TaskvareA task and project-management suite: React on the web, Flutter on mobile, TypeScript underneath.
Related fixes
Web apps
Module not found for antd/dist/antd.less after upgrading to Ant Design 5
Module not found: Error: Can't resolve 'antd/dist/antd.less'
Ant Design 5 dropped Less and the bundled CSS file for CSS-in-JS, so antd/dist/antd.less no longer exists.
3 causes, each with a fixWeb apps
React shows Attempted import error when importing a component or function
Attempted import error:
The build found the file but not the name you asked for.
2 causes, each with a fixWeb apps
How to catch and handle a 422 from Axios in a Redux thunk
action.error.message is 'Rejected' and action.payload is undefined
A 422 means the server read the request but cannot process its content, so repeating it unchanged fails again.
4 causes, each with a fixWeb apps
axios gets 429 Too Many Requests from a React app
429 (Too Many Requests)
A 429 comes from the server or an API gateway, not from axios: your client sent too many requests in a window.
4 causes, each with a fixWeb apps
Axios request is not cancelled when a React component unmounts
A cancelled request is logged as an error in the catch block
Axios cancels a request when you pass it an AbortSignal and later call abort() on its controller.
4 causes, each with a fixWeb apps
AxiosError Network Error with code ERR_NETWORK in a React app
Network Error
ERR_NETWORK means the request produced no readable response.
4 causes, each with a fix